IDLitContainer::FindIdentifiers

The IDLitContainer::FindIdentifiers function method allows you to retrieve the full identifiers for items within an iTool container.

Warning
The FindIdentifiers method recurses through the entire object hierarchy of the specified object, which may be slow for large container hierarchies. If you find it necessary to call FindIdentifiers multiple times, it may be more efficient to use a single call with one or more wildcards ("*") to return all relevant identifiers, and then perform the necessary searches using the returned list.

Syntax

Result = Obj->[IDLitContainer::]FindIdentifiers([Pattern] [, COUNT=variable] [, /LEAF_NODES] )

Return Value

Returns a scalar string or string array containing the full object identifiers for all items matching the Pattern. If no object identifiers are matched, the function returns a scalar null string.

Arguments

Pattern

A string specifying a search pattern to be used for filtering the returned object identifiers. Only object identifiers that match Pattern are returned. Matching is case insensitive. If Pattern is not supplied, identifiers for all objects within the object on which this method is called are returned. See STRMATCH for a description of the rules used when matching patterns.

Note
Objects for which the PRIVATE property contains a True value are not included in the Result. Only objects that subclass from IDLitComponent can be marked as private.

Keywords

COUNT

Set this keyword equal to a named variable that will contain the number of identifiers in Result.

LEAF_NODES

Set this keyword to return only leaf nodes. Leaf nodes are objects which are either not a container, or are an empty container.

Note
If all of the objects within a container are marked as PRIVATE, then that container is considered a leaf node. Only objects that subclass from IDLitComponent can be marked as private.

Version History


6.1	Introduced