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

ARCHIVE STRUCTURES(PHOP,*,*,AROP)

Purpose

Use Archive Structures to store one or more specified structures from the structure store into the specified open archive file.

If any of the specified structures do not exist in the structure store, then the graPHIGS API issues a warning and no action is taken for the non-existing structures. If any of the specified structures already exists in the archive file, then the graPHIGS API resolves the conflict according to the value of the archive conflict resolution flag specified by the Set Conflict Resolution subroutine.

If the archive file is not large enough to complete the archival process, then the graPHIGS API issues an error and does not archive any other structures. However, any structures that the graPHIGS API archived are archived completely.

Language Bindings

C

par_structs (archive_id, struct_ids)

Input Parameters

Pint archive_id
Archive file identifier.

cont Pint_list *struct_ids
List of structure identifiers.

FORTRAN

PARST (afid, n, lstrid)

Input Parameters

integer afid
Archive file identifier.

integer n
Number of structure identifiers in the list.

integer lstrid(n)
List of structure identifiers.

Errors

7
Function Requires State (PHOP,*,*,AROP)
404
Specified Archive File Is Not Open
200
Warning, Ignoring Structures That Do Not Exist
405
Name Conflict Occurred, Conflict Resolution Flag = Abandon
406
Warning, Archive File Is Full

Related Subroutines

  • Archive Structure Networks

  • Archive Structures

  • Set Conflict Resolution

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