Name

pinq_paths_ances − Returns all the paths that reference a structure. 

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

Syntax

void pinq_paths_ances (
  Pint                   stid,       /∗ (I) Structure identifier. ∗/
  Ppath_order            order,      /∗ (I) Path order. ∗/
  Pint                   depth,      /∗ (I) Path depth. ∗/
  Pstore                 store,      /∗ (I) Handle to store the object.
                                            store manages the memory
                                            referenced by ∗paths. ∗/
  Pint                  ∗error_ind,  /∗ (O) Error indicator. ∗/
  Pelem_ref_list_list  ∗∗paths       /∗ (O) Structure path list. ∗/
)

Data Structures

typedef enum {
    PORDER_TOP_FIRST,       /∗ top first ∗/
    PORDER_BOTTOM_FIRST     /∗ bottom first ∗/
} Ppath_order;
typedef void ∗Pstore;
typedef struct {
    Pint              num_elem_ref_lists;  /∗ number of element reference
                                              lists ∗/
    Pelem_ref_list   ∗elem_ref_lists;      /∗ list of element reference
                                              lists ∗/
} Pelem_ref_list_list;
    typedef struct {
        Pint          num_elem_refs;  /∗ number of execute references ∗/
        Pelem_ref    ∗elem_refs;      /∗ list of execute references ∗/
    } Pelem_ref_list;
        typedef struct {
            Pint     struct_id;    /∗ structure identifier ∗/
            Pint     elem_pos;     /∗ element position∗/
        } Pelem_ref;

Description

pinq_paths_ances queries the structure state list and returns all the paths that reference the specified structure.  Each path includes an execute reference of the specified structure with element number 0.  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 the number of
             FIRST        references to the specified structure.
2            BOTTOM       All parents of the specified structure are
             FIRST        returned.
------------------------------------------------------------------------

For the paths argument, the first value is the number (n) of execute reference lists returned.  Each of the subsequent n list elements is the address of an execute reference list.  The first value of each execute reference list is the number (m) of execute references in that list.  This count is followed by a list of m execute references.  Each execute reference is composed of a structure identifier and an element offset. 

See Also

pcreate_store
pdel_store
pexec_struct
pinq_paths_descs