NAME

DELETE STORE − Destroys a Store object

SYNOPSIS

C Syntax

void
pdel_store ( store )
Pstorestore;Handle to store object

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

DELETE STORE destroys the specified Store object and frees all memory associated with it. 

C Input Parameter

store
The Store to be deleted.

Execution

DELETE STORE frees all memory associated with a Store.  A Store is an opaque pointer that is passed as a parameter to a function returning complex data.  A Store contains the memory to hold the results of a complex inquiry.  A Store may be passed to or used by more than one inquiry function, but at any one time a Store only holds the result of the last inquiry function that used it as an argument.  A Store continues to hold the information from the last inquiry function until it is freed by DELETE STORE, or until the Store is used as an argument to a subsequent inquiry function, in which case the information is overwritten. 

ERRORS

None. 

SEE ALSO

CREATE STORE (3P)

September 02, 1992