DELETE STRUCTURE NETWORKS FROM ARCHIVE(3P) — SUNPHIGS LIBRARY

NAME

DELETE STRUCTURE NETWORKS FROM ARCHIVE − delete specified structure networks from an archive file

SYNOPSIS

C Syntax

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

FORTRAN Syntax

SUBROUTINE pdsnar ( 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 STRUCTURE NETWORKS FROM ARCHIVE to delete a list of structure networks 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 the root structure identifiers of the archived structure networks 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 archived structure networks to be deleted.

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

Execution

The structures belonging to the specified networks 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