Operator Reference

HALCON Operator Reference / System / Operating System
ClassesClasses | | Operators

system_callsystem_callSystemCallSystemCallsystem_call (Operator)

system_callsystem_callSystemCallSystemCallsystem_call — Execute a system command.

Signature

system_call( : : Command : )

Herror system_call(const char* Command)

Herror T_system_call(const Htuple Command)

void SystemCall(const HTuple& Command)

static void HSystem::SystemCall(const HString& Command)

static void HSystem::SystemCall(const char* Command)

static void HSystem::SystemCall(const wchar_t* Command)   ( Windows only)

static void HOperatorSet.SystemCall(HTuple command)

static void HSystem.SystemCall(string command)

def system_call(command: str) -> None

Description

The operator system_callsystem_callSystemCallSystemCallsystem_call executes the system command given in CommandCommandCommandcommandcommand.

On Windows operating systems, the system command can be prefixed by 'start /b'"start /b""start /b""start /b""start /b" to avoid waiting for the started application. On Unix-like operating systems, an interactive shell ('csh -i') will be started, if CommandCommandCommandcommandcommand contains an empty string.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

CommandCommandCommandcommandcommand (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Command to be called by the system.

Default: 'ls' "ls" "ls" "ls" "ls"

Result

On Windows operating systems,the operator system_callsystem_callSystemCallSystemCallsystem_call will always return the value 2 ( H_MSG_TRUE) unless there was a problem creating a new process. On other operating systems, system_callsystem_callSystemCallSystemCallsystem_call will always return the value 2 ( H_MSG_TRUE) .

Possible Predecessors

count_secondscount_secondsCountSecondsCountSecondscount_seconds

See also

wait_secondswait_secondsWaitSecondsWaitSecondswait_seconds, count_secondscount_secondsCountSecondsCountSecondscount_seconds

Module

Foundation

ClassesClasses | | Operators