[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

RETRIEVE ALL STRUCTURES (PHOP,*,*,AROP)

Purpose

Use Retrieve All Structures to retrieve all structures from the specified open archive file and place them into the structure store.

If any of the specified structures in the archive file already exists in the structure store, then the graPHIGS API resolves the conflict according to the value of the archive conflict resolution flag specified by the Set Conflict Resolution subroutine.

When you retrieve a structure that is the open structure, the structure is closed, emptied, retrieved, and reopened and the graPHIGS API maintains all references to the structure. The result is as though you had issued the following:

  1. Close Structure
  2. Empty Structure
  3. Retrieve Structure
  4. Open Structure
If the structure retrieved contains an execute structure element that references a non-existing structure, then the graPHIGS API creates an empty structure.

Language Bindings

C

pret_all_structs (archive_id)

Input Parameters

Pint archive_id
Archive file identifier.

FORTRAN

PRAST (afid)

Input Parameters

integer afid
Archive file identifier.

Errors

7
Function Requires State (PHOP,*,*,AROP)
404
Specified Archive File Is Not Open
405
Name Conflict Occurred, Conflict Resolution Flag = Abandon

Related Subroutines

  • Retrieve Structure Networks

  • Retrieve Structures

  • Set Conflict Resolution

    • [ Previous | Next | Contents | Glossary | Home | Search ]