DELETE STRUCTURES FROM ARCHIVE(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

void
pdel_structs_ar ( archive_id, struct_ids )
Pintarchive_id;archive identifier
Pint_list∗struct_ids;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 Pint_list structure containing the list of structure identifiers to be deleted. The Pint_list structure is defined in phigs.h as follows:

typedef struct {
Pintnum_ints;/∗ number of Pints in list ∗/
Pint∗ints;/∗ list of integers ∗/
} Pint_list;

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

Execution

The specified structures are deleted from the archive file. No attempt is made to ensure 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