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

DELETE STRUCTURES FROM ARCHIVE (PHOP,*,*,AROP)

Purpose

Use Delete Structures from Archive to delete one or more structures from the specified open archive file.

The graPHIGS API does not check if other structures in the archive file reference the deleted structures. Therefore, the graPHIGS API does not delete the execute structure elements in other archived structures that reference the deleted structures.

If a specified structure does not exist in the archive file, then the graPHIGS API issues a warning and no action is taken for the structure.

Language Bindings

C

pdel_structs_ar (archive_id, struct_ids)

Input Parameters

Pint archive_id
Archive file identifier.

cont Pint_list *struct_ids
List of structure identifiers.

FORTRAN

PDSTAR (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
407
Warning, Some Specified Structures Do Not Exist On Archive File

Related Subroutines

  • Delete All Structures From Archive

  • Delete Structures From Archive

  • Execute Structure

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