Name

PQPDE − Returns all paths referenced by the structure. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Old Syntax

PQDEST (STRID, PTHORD, PTHDEP, IPTHSZ, N, ERRIND, OL, APTHSZ, PATHS)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
STRID             Integer        Read      Structure identifier
PTHORD            Integer        Read      Path order
PTHDEP            Integer        Read      Path depth to be returned
IPTHSZ            Integer        Read      Size of the path buffer, in bytes
N                 Integer        Read      Requested element of the list
                                           of paths
ERRIND            Integer        Write     Error indicator
OL                Integer        Write     Number of paths available
APTHSZ            Integer        Write     Actual size of the Nth structure
                                           path
PATHS(2, IPTHSZ)  Array of       Write     Nth structure path
                  integers
---------------------------------------------------------------------------

New Syntax

PQPDE (STRID, PTHORD, PTHDEP, IPTHSZ, N, ERRIND, OL, APTHSZ, PATHS)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
STRID             Integer        Read      Structure identifier
PTHORD            Integer        Read      Path order
PTHDEP            Integer        Read      Path depth to be returned
IPTHSZ            Integer        Read      Size of the path buffer, in bytes
N                 Integer        Read      Requested element of the list
                                           of paths
ERRIND            Integer        Write     Error indicator
OL                Integer        Write     Number of paths available
APTHSZ            Integer        Write     Actual size of the Nth structure
                                           path
PATHS(2, IPTHSZ)  Array of       Write     Nth structure path
                  integers
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
PTHORD               PPOTOP       Top first
                     PPOBOT       Bottom first
---------------------------------------------------------------------------

Description

PQPDE queries the structure state list and returns all the paths that are referenced by the specified structure.  Each path includes an execute reference of the form (structure identifier,0), which represents the bottommost element of the path.  The path order and path depth determine the section of each path to be returned, as follows:

Path Depth   Path Order   Description
0            TOP FIRST    All paths to the specified structure are
                          returned in order of traversal.
 
1            TOP FIRST    All structures at the top of each structure
                          network that contains the specified structure
                          are returned.
1            BOTTOM       Can be used to determine all the bottommost
             FIRST        structures of the structure network.
2            TOP FIRST    All children of the specified structure are
                          returned.

See Also

PEXST
PQPAN