magic/doc/html/goto.html

76 lines
2.3 KiB
HTML
Raw Normal View History

<HTML>
<HEAD>
<STYLE type="text/css">
H1 {color: black }
H2 {color: maroon }
H3 {color: #007090 }
A.head:link {color: #0060a0 }
A.head:visited {color: #3040c0 }
A.head:active {color: white }
A.head:hover {color: yellow }
A.red:link {color: red }
A.red:visited {color: maroon }
A.red:active {color: yellow }
</STYLE>
</HEAD>
<TITLE>Magic-7.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title2.gif ALT="Magic VLSI Layout Tool Version 7.3">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>goto</H2>
<HR>
Goto the named node
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>goto</B> <I>nodename</I> [<B>-nocomplain</B>] <BR><BR>
<BLOCKQUOTE>
where <I>nodename</I> is any valid name for a network node.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>goto</B> command moves the cursor box to some position
representing the network node named <I>nodename</I>, 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. <P>
The <B>-nocomplain</B> 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.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>goto</B> is implemented as a built-in command in <B>magic</B>.
The Tcl version of <B>magic</B> returns the layer of the node
as a Tcl result. <P>
A script may make use of the return value in the following
manner:
<BLOCKQUOTE>
<B>select box [goto</B> <I>nodename</I><B>]; select more net</B>
</BLOCKQUOTE>
which selects the entire network named <I>nodename</I>.
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=getnode.html><B>getnode</B></A> <BR>
</BLOCKQUOTE>
<P><IMG SRC=graphics/line1.gif><P>
<TABLE BORDER=0>
<TR>
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> October 16, 2004 at 2:15pm <P>
</BODY>
</HTML>