goto nodename [-nocomplain]
where nodename is any valid name for a network node.
The goto command moves the cursor box to some position representing the network node named nodename, if it exists in the layout. Because any given area of the layout may contain more than one unconnected network node, a layer type is returned. The area of the cursor box plus the layer type always uniquely identifies the node.
The -nocomplain switch supresses the warning message if the node does not exist. In the Tcl version, an empty list is returned for nodes that cannot be found, and no error condition is reported.
goto is implemented as a built-in command in magic. The Tcl version of magic returns the layer of the node as a Tcl result.
A script may make use of the return value in the following manner:select box [goto nodename]; select more netwhich selects the entire network named nodename.
|Return to command index|
Last updated: October 16, 2004 at 2:15pm