Name

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

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

Syntax

void pret_paths_ances (
  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_ances returns the maximal paths in the archive file that are referenced by the specified archived structure.  The maximal path of ancestors of a structure is a path ((A1, E1), (A2, E2), ... , (S, 0)).  A1 cannot be referenced in any execute structure element in the archive file.  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
                              to the specified structure.
1            TOP FIRST        Digital PHIGS returns all element references
                              heading a path to the specified structure.
2            BOTTOM FIRST     Digital PHIGS returns all element references
                              to the structure.
--------------------------------------------------------------------------

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_descs