magic/doc/html/findlabel.html

66 lines
2.0 KiB
HTML

<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-8.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title8_3.png ALT="Magic VLSI Layout Tool Version 8.3">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>findlabel</H2>
<HR>
Set the cursor box to the location of the indicated label
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>findlabel</B> [<B>-glob</B>] <I>label</I> [<I>occur</I>]<BR><BR>
<BLOCKQUOTE>
where <I>label</I> is the name of an existing label in magic,
and optional argument <I>occur</I> is an integer.
</BLOCKQUOTE>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>findlabel</B> command can be used to center the cursor box
on a specific named label in the layout. <P>
The <B>-glob</B> option causes <B>findlabel</B> to find all labels
containing the text pattern of <I>label</I>. This is the way the
<B>findlabel</B> command worked in versions of <B>magic</B> prior
to 7.2. <P>
The optional argument <I>occur</I> will center the cursor box on the
<I>N</I>th instance of the label, where <I>N</I>=<I>occur</I>
(option introduced in version 8.3.86). If <I>occur</I> is greater
than the number of labels in the edit cell, then the result is the
same as for a label that is not found.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>findlabel</B> is implemented as a built-in command in <B>magic</B>.
</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> November 20, 2020 at 10:18am <P>
</BODY>
</HTML>