RETRIEVE STRUCTURES

PRET_STRUCTS

CALL SEQUENCE

void pret_structs(

Pint	archive_id	/* archive identifier	*/
const Pint_list	*structure_ids	/* list of structure identifiers	*/

TYPES

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

PHIGS STATE

EFFECT

The list of structures specified in structure_ids are copied to the centralized structure store (CSS) from the archive archive_id.

If the identifier of one of the structures specified in structure_ids is already present in the CSS, the conflict is processed according to the retrieval conflict resolution flag which can be:

- MAINTAIN : Structure already present in the CSS is maintained.

- ABANDON : Saving operation abandoned for conflicting structure.

- UPDATE : Structure already present in the CSS is overwritten by the new one.

If one of the structure specified in structure_ids is not in the archive, a warning is generated and no action is taken for this structure.

ERRORS

7

Ignoring function, function requires state (PHOP, *, *, AROP)

404

Ignoring function, the specified archive file is not open

405

Ignoring function, name conflict occurred while conflict resolution flag has value ABANDON

408

Warning, some of the specified structures do not exist on the archive file. PHIGS will create empty structure in their place

SEE ALSO

open archive file, archive structures, retrieve structures identifiers, retrieve structure networks, retrieve all structures, retrieve paths to ancestors, retrieve paths to descendant, delete structures from archive