Name

pret_structs − Retrieves a list of archived structures from an archive file. 

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

Syntax

void pret_structs (
  Pint              archive_id,   /∗ (I) Archive file identifier ∗/
  const Pint_list  ∗struct_ids    /∗ (I) List of structure identifiers ∗/
)

Data Structures

typedef struct {
    Pint      num_ints;  /∗ number of Pints in the list ∗/
    Pint     ∗ints;      /∗ list of integers ∗/
} Pint_list;

Description

pret_structs returns the specified list of archived structures from the specified archive file. 

If a specified structure currently exists in the CSS, the conflict is resolved according to the value of the retrieval conflict resolution flag in the PHIGS state list. 

If a specified structure does not exist in the archive file, Digital PHIGS creates an empty structure in the CSS and generates a warning message. 

See Also

par_structs
pdel_structs_ar
pinq_all_conf_structs
pinq_conf_res
pinq_conf_structs_net
popen_ar_file
pret_all_structs
pret_struct_ids
pret_struct_nets
pset_conf_res