IDLitContainer::FindIdentifiers

IDLitContainer::FindIdentifiers

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

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

Introduced: 6.1