INQUIRE STRUCTURE IDENTIFIERS(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE STRUCTURE IDENTIFIERS− inquire the current structure identifiers

SYNOPSIS

C Syntax

void
pinqstructids ( length, start, error_ind, struct_ids, total_length )
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pintlst∗struct_ids;OUT list of structure ids
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqsid ( N, ERRIND, NUMBER, STRID )
INTEGERNlist element requested
INTEGERERRINDOUT error indicator
INTEGERNUMBEROUT number of structure identifiers
INTEGERSTRIDOUT Nth structure identifier

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE STRUCTURE IDENTIFIERS to obtain a list of the current structure identifiers from the PHIGS state list.

C Input Parameters

lengthThe number of integers items in the struct_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 struct_ids−>integers. If a value of 0 is used here, no data will be returned in the struct_ids−>integers list, but the total number of structure identifiers in the PHIGS state list will be returned in total_length.

startStarting position of inquiry into the PHIGS state list of current structure identifiers. The elements of the list of structure identifiers, beginning with the item number specified by start, are copied sequentially into struct_ids−>integers until struct_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.

struct_ids
A pointer to a Pintlst structure in which the system returns the list of current structure identifiers. Pintlst 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 struct_ids−>integers list.

total_length
A pointer to an integer in which the system returns the total number of elements in the PHIGS state list of currently used structure identifiers. This is the value required for length if all structure identifiers are to be returned.

FORTRAN Input Parameters

NElement of the PHIGS state list of current structure identifiers 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 elements in the PHIGS state list of currently used structure identifiers will be returned in NUMBER.

FORTRAN Output Parameters

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

NUMBER
The total number of elements in the PHIGS state list of currently used structure identifiers.

STRID
The Nth structure identifier from the PHIGS state list of currently used structure identifiers.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

Museum