TutCommandParseFile

Name

TutCommandParseFile — submit a file to SmartSockets process command interface

Synopsis

T_BOOL TutCommandParseFile(file_name) 
T_STR file_name; 

Arguments

file_name — name of file to submit to command interface

Return Values

TRUE if the file was processed successfully, FALSE otherwise.

Diagnostics

None

Description

TutCommandParseFile submits a file to the command interface of the process for execution. Each line of the file is executed with TutCommandParseStr.

Caution

TutCommandParseFile reads the file one line at a time using the fgets function. Multi-line comments, multi-line commands, and commands longer than 4094 characters are not allowed.

TutCommandParseFile does not search for file_name in any directories such as the SmartSockets standard directory, but simply uses file_name verbatim.

See Also

TutCommandParseStr, TutCommandParseTypedStr

Examples

This example executes the file test.cm:

if (!TutCommandParseFile("test.cm")) { 
  /* error */ 
}