abc::read — read a circuit description into ABC
Sends the command read parameters
to ABC and waits for a prompt.
Parses the output to detect errors reported by ABC.
result
(out)Optional argument. If omitted, no information is returned. The following items are present:
errorCode
(out)Error code. See RETURN CODES
below. Also put to the errorCode
global variable.
rawOutput
(out)The unprocessed output of ABC, including the final prompt.
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.
cmdTime
(out)Time in milliseconds elapsed by the command.
parameters
(in)Optional argument. Parameters for the ABC read command. Defaults to an empty string. This argument, although syntactically optional, is necessary, because it has to define the name of the file to read.
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:
parameters
.parameters
could not be opened.parameters