Skip to content

system_callSystemCallSystemCallsystem_callsystem_call🔗

Short description🔗

system_callSystemCallSystemCallsystem_callsystem_call — Execute a system command.

Signature🔗

system_call( string Command )void SystemCall( const HTuple& Command )static void HOperatorSet.SystemCall( HTuple command )def system_call( command: str ) -> None

Herror system_call( const char* Command )

Herror T_system_call( 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 HSystem.SystemCall( string command )

Description🔗

The operator system_callSystemCall executes the system command given in Commandcommandcommand.

On Windows operating systems, the system command can be prefixed by '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 Commandcommandcommand contains an empty string.

Execution information🔗

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🔗

Commandcommandcommand (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Command to be called by the system.

Default: 'ls'"ls"

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

count_secondsCountSeconds

See also

wait_secondsWaitSeconds, count_secondsCountSeconds

Module🔗

Foundation