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

ARCHIVE STRUCTURE NETWORKS (PHOP,*,*,AROP)

Purpose

Use Archive Structure Networks to store one or more structure networks from the structure store into the specified open archive file.

If any of the specified root 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 in the structure network 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 structure networks. However, any structures that the graPHIGS API archived are archived completely.

Language Bindings

C

par_struct_nets (archive_id, struct_ids)

Input Parameters

Pint archive_id
Archive file identifier.

cont Pint_list *struct_ids
List of root structure identifiers.

FORTRAN

PARSN (afid, n, lstrid)

Input Parameters

integer afid
Archive file identifier.

integer n
Number of root structure identifiers in the list.

integer lstrid(n)
List of root 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 ]