Next: , Previous: , Up: The Process Library   [Index]


11.10.2 S Shell Functions

ss_argv

list ss_argv(sshell ss);

is the command line of the process to execute for the ss shell. The list may be operated as any list library provided list, though the process library expects that only items of the intrinsic string type and the byte data library provided byte array type are present in the list when executing the process.

See The List Library.

See The Byte Data Library.

ss_line

text ss_line(sshell ss);

is the recorded output of the executed process for the ss shell. The function executes the process and waits for its completion. The path and command line of the executed process are expected set via the objects available through ‘ss_path’ and ‘ss_argv’, respectively. A maximum wait time may be set through ‘ss_wait’.

The recorded output will also be available after the ‘ss_line’ call via the ‘ss_read’ function.

ss_link

text ss_link(sshell ss);

is the recorded output of the successfully executed process for the ss shell. The function executes the process and waits for its completion. The path and command line of the executed process are expected set via the objects available through ‘ss_path’ and ‘ss_argv’, respectively. A maximum wait time may be set through ‘ss_wait’.

The recorded output will also be available after the ‘ss_link’ call via the ‘ss_read’ function.

The function terminates the program execution if the executed process did not exit normally with a zero exit status.

ss_path

data ss_path(sshell ss);

is the path to the executable to execute for the ss shell. It is to be set before execution.

ss_read

data ss_read(sshell ss);

is the last recorded output of the executed process for the ss shell.

ss_set

sshell ss_set(sshell &ss, sshell st);

is st, sets the ss shell object as a reference of the st shell object

ss_wait

time ss_wait(sshell ss);

is the maximum time to wait for the executed process to complete execution. A zero value specifies that the process is to be waited indefinitely.

See The Date And Time Library.


Next: , Previous: , Up: The Process Library   [Index]