Product Documentation
Virtuoso Space-based Router Command Reference
Product Version IC23.1, September 2023

find_text

find_text
[ -value s_textExpr ] 
[ -set d_setObj | -window i_windowID ] 
[ -ignore_case ]
[ -silent ]

Description

Returns a set containing text objects in the given set or in a window.

The GUI equivalent for this command is Edit—Find (Text).

Arguments

-ignore_case

Performs a case-insensitive search. If not specified, the search is case-sensitive.

-set d_setObj

Limits the search to objects contained in the specified set. If neither -set nor -window is specified, the entire design in the active window is searched.

-silent

Suppresses informational messages, such as the number of items found. By default, these messages are output.

-value s_textExpr

Limits the search to text matching the given expression. If not specified, the search is for all text objects.

-window_id i_windowID

Limits the search to text in the given window. If neither -set nor -window_id is given, the search is for text in the active window.

Value Returned

d_setObj

Specifies the set identifier for the set of text objects found that match the criteria.

Examples

The following example searches the entire design for all text objects named lbl*, adds the objects to the set identified by variable mylbl, then replaces the selected set with the new set of objects. You can use the Properties form to navigate the set of text objects that are found.

set mylbl [find_text -value lbl*]
replace_set -set1 $mylbl -set2 [get_selection_set]

Related Topics

Edit Commands

create_label


Return to top
 ⠀
X