abc::source

abc::source
Prev		Next

Name

abc::source — source a script into ABC

abc::init file [result] [timeout]

Sends the source file to ABC and waits for prompt. Parses the output to detect errors in opening the file and parse errors.

string file (in)

The name of the sourced file.

array result (out)

Optional argument. If omitted, no information is returned. The following items are present:

string errorCode (out): Error code. See RETURN CODES below. Also put to the errorCode global variable.
string rawOutput (out): The unprocessed output of ABC, including the final prompt.
int promptNumber (out): The number included in the final prompt. The ABC prompt has the "abc123> " form. The number indicates successive version of the network stored in ABC.
int cmdTime (out): Time in milliseconds elapsed by the command.

int timeout (in)

Optional argument. If given, sets the timeout of Expect for this command. Othervise, the value of the timeout global variable applies.

The procedure returns an empty string. See abctcl(n) , abc::messages(n) for error reporting and error symbols. The following error symbols can occur:

Error Code: ABC_E_BUSY

Diagnostic: Prompt from the previous command has not been detected yet.

Error Code: ABC_E_EOF

Diagnostic: A premature end-of-file detected. Perhaps the ABC process crashed.

Error Code: ABC_E_TOUT

Diagnostic: Timeout expired before the prompt was detected.

Error Code: ABC_E_READ

Diagnostic: Error reading file. The reason reported by ABC is also included

Error Code: ABC_E_CMD

Diagnostic: ABC could not parse commands in file.

Prev		Next
abc::read	Home	abc::print_auto