查找第N个对象与给定的名称

Synopsis

&ENAME(n,'name'[,IFERR,label:])

Description

Returns the object identifier of the nth object with the specified name to a receiving variable or GRIP statement. You can use this function to identify objects which were named interactively or in another GRIP program. This EDA does not guarantee the order in which objects are returned. Since object identifiers may change across sessions, &ENAME returns object identifiers without regard to a particular order.

NOTE: The following object types are not valid for this EDA: 60, 61, 62, and 64 which correspond to View, Layout, Drawing, and Reference Set.

Characteristics

Read Only - Object - 30 Characters

Parameters

Parameter

Description

n

An integer representing the nth object in the data base with the given name.

'name'

The name, which can have a maximum of 30 characters, for which the system will search.

NOTE: You can use an asterisk character (*) as a wild card.

IFERR,label:

Specifies a label to which the program jumps if an error occurs. An error occurs if there are no objects with the specified name or if the number of objects with the given name is less than the value specified by "n".

Parameter	Description
n	An integer representing the nth object in the data base with the given name.
'name'	The name, which can have a maximum of 30 characters, for which the system will search. NOTE: You can use an asterisk character (*) as a wild card.
IFERR,label:	Specifies a label to which the program jumps if an error occurs. An error occurs if there are no objects with the specified name or if the number of objects with the given name is less than the value specified by "n".