INQUIRE ALL CONFLICTING STRUCTURES(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE ALL CONFLICTING STRUCTURES − inquire all conflicting structures in the Central Structure Store and an archive file

SYNOPSIS

C Syntax

void
pinqallconfstruct ( ar_id, length, start, error_ind, ids, total_length )
Pintar_id;archive identifier
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pintlst∗ids;OUT list of conflicting structure ids
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqcst ( AFID, N, ERRIND, OL, OSTRID )
INTEGERAFIDarchive file identifier
INTEGERNelement of the structure identifier list
to return
INTEGERERRINDOUT error indicator
INTEGEROLOUT number of structure identifiers in list
INTEGEROSTRIDOUT Nth structure identifier in list

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use INQUIRE ALL CONFLICTING STRUCTURES to obtain a list of the identifiers of all structures which exist in both the Central Structure Store and the specified open archive file.

C Input Parameters

ar_idThe archive identifier specifying the open archive file to use.

lengthThe number of integers items in the ids output parameter for which the application has allocated memory. length is the number of list elements (structure identifiers) that the system can return in ids−>integers. If a value of 0 is used here, no data will be returned in the ids−>integers list, but the total number of conflicting structures will be returned in total_length.

startStarting position in the list of identifiers of conflicting structures at which to begin the inquiry. The elements of the list of structure identifiers, beginning with the item number specified by start, are copied sequentially into ids−>integers until ids−>integers is full or all the structure identifiers have been copied.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

idsA pointer to a Pintlst structure in which the list of identifiers of conflicting structures is returned. 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. The application must allocate memory for length elements in the ids−>integers list.

total_length
A pointer to an integer in which the total number of conflicting structures is returned. This is the value required for length if all structure identifiers are to be returned.

FORTRAN Input Parameters

AFIDThe archive identifier specifying the open archive file to use.

NElement of the list of identifiers of conflicting structures to return; only one identifier may be inquired per subroutine call. If a value of 0 is used here, no structure identifier will be returned, but the total number of conflicting structures will be returned in OL.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

OLThe total number of conflicting structures.

OSTRID
The Nth structure identifier from the list of conflicting structures.

ERRORS

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

404Ignoring function, the specified archive file is not open

Museum