find

ensobjlist.find(value: Any, attr: Any = 'DESCRIPTION', group: int = 0, wildcard: int = 0) → ensobjlist[T]

Find objects in the list using the ENSOBJ interface.

This method will scan the ENSOBJ subclass objects in the list and return an ensobjlist of those matching the search criteria.

Parameters:

value: Any

A single object or a tuple of objects that will be compared to the value of an attribute accessed via the getattr() ENSOBJ interface.

attr: Any

The specific attribute (id or string) to look up using getattr().

group: int

Currently unimplemented.

wildcard: int

Instead of the comparison being done via the equals test, it will be done using fnmatch between the string representation of the item and the value. This allows values to be specified using glob wildcard specifications. If wildcard is set to 1, this is a case-sensitive wildcard operation. If set to 2, the comparison is case-insensitive. The default is not to use wildcard comparisons (0).

Returns:

ensobjlist[T]

An ensobjlist of the items that matched the search criteria.