ELEMENT SEARCH
-
CALL SEQUENCE
CALL PELS (STRID, STRTEP, SRCDIR, EISN, EIS, EESN, EES, ERRIND, STATUS, FNDEP).
INPUT PARAMETERS
- INTEGER STRID
- Structure identifier.
- INTEGER STRTEP
- Element pointer initial position.
- INTEGER SRCDIR
- Search direction
- PBWD:
- 0 (BACKWARD)
- PFWD:
- 1 (FORWARD)
- INTEGER EISN
- Number of elements in inclusion set.
- INTEGER EIS(EISN)
- Inclusion set. The element types are described in the PQCETS function.
- INTEGER EESN
- Number of elements in exclusion set.
- INTEGER EES(EESN)
- Exclusion set (the types are the same as for the inclusion set).
OUTPUT PARAMETERS
- INTEGER ERRIND
- Error indicator
- INTEGER STATUS
- Search state indicator
- PFAIL:
- 0 (FAILURE)
- PSUCC:
- 1 (SUCCESS)
- INTEGER FNDDP
- Element pointer found.
PHIGS STATE
(PHOP, *, *, *).
EFFECT
Searches for the next matching element in the structure STRID, beginning
at the position STRTEP and proceeding in the specified SRCDIR
direction. The search stops if an element is found or if the pointer reaches
the structure limits.
An element will be selected if its type does not belong to the exclusion set
EIS and if it belongs to the inclusion set EES.
The PALL element means all element types and will normally appear only
in the element inclusion list. If an element is both in the inclusion and
exclusion sets then it will be excluded.
If the start pointer is less than 1, the search starts at the first sequential
element. If the start position is greater than the number of elements in the
structure, the search starts from the last sequential element.
ERRORS
- 2
Ignoring function, function requires state (PHOP, *,*,*)
- 201
- Ignoring function, the specified structure does not exist
SEE ALSO
open structure, incremental spatial search 3, inquire element content, inquire
element types and size.