Name

pret_paths_descs − Returns the maximal paths of descendants (in the archive file) that are referenced by the archived structure. 

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

Syntax

void pret_paths_descs (
  Pint                  arid,    /∗ (I) Archive identifier. ∗/
  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. ∗/
  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 number ∗/
        } Pelem_ref;

Description

pret_paths_descs returns the maximal paths in the archive file that are referenced by the specified archived structure.  The maximal path of descendants of a structure is a path ((structure, E0), (D1, E1), (D2, E2), ... , (DN, 0)).  DN cannot contain any execute structure elements.  The arguments depth and order determine the portion of the path returned by Digital PHIGS. 

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        Digital PHIGS returns all distinct paths
                              from the specified structure.
1            TOP FIRST        Digital PHIGS returns element references
                              in the specified structure as separate
                              path lists.
1            BOTTOM FIRST     Can be used to determine the bottommost
                              structures of the structure network.
--------------------------------------------------------------------------

Digital PHIGS Version 4.1 does not support this function.

See Also

pcreate_store
pdel_store
pinq_all_conf_structs
pinq_conf_structs_net
popen_ar_file
pret_paths_ances