DELETE STRUCTURES FROM ARCHIVE(3P) — SUNPHIGS LIBRARY

NAME

DELETE STRUCTURES FROM ARCHIVE − delete specified structures from an archive file

SYNOPSIS

C Syntax

void
pdelstructar ( archive_id, struct_ids )
Pintarchive_id;archive identifier
Pintlst∗struct_ids;list of structure identifiers

FORTRAN Syntax

SUBROUTINE pdstar ( AFID, N, LSTRID )
INTEGERAFIDarchive file identifier
INTEGERNnumber of structure identifiers in the list
INTEGERLSTRID(N)list of structure identifiers

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use DELETE STRUCTURES FROM ARCHIVE to delete a list of structures from the specified open archive file.

C Input Parameters

archive_id
The archive identifier specifying the open archive file to delete from.

struct_ids
A pointer to a Pintlst structure containing the list of structure identifiers to be deleted. The Pintlst structure is defined in phigs.h as follows:

typedef struct {
Pintnumber;/∗ number of Pints in list ∗/
Pint∗integers;/∗ list of integers ∗/
} Pintlst;

The number component specifies the number of structure identifiers in the list. The integers component is a pointer to a list, number long, of the structure identifiers.

FORTRAN Input Parameters

AFIDThe archive identifier specifying the open archive file to delete from.

NThe number of structure identifiers to be deleted.

LSTRID
An array of integers containing the structure identifiers to be deleted.

Execution

The specified structures are deleted from the archive file. No attempt is made to insure that the deleted structures are not referenced from other structures in the archive file.

ERRORS

007Ignoring function, function requires state (PHOP, ∗, ∗, AROP)

404Ignoring function, the specified archive file is not open

407Warning, some of the specified structures do not exist on the archive file

Museum