[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

INQUIRE ELEMENT CONTENT (PHOP,*,*,*)

Purpose

Use Inquire Element Content to inquire the contents of the specified structure element.

This subroutine returns the data contained in the specified structure element. The data is returned in a binding specific format. See Chapter 17. "ISO PHIGS C Type and Macro Definitions" for the C binding formats and see Chapter 16. "FORTRAN Structure Content Data Records" for the FORTRAN binding formats. Use the Inquire Element Type and Size subroutine ( INQUIRE ELEMENT TYPE AND SIZE (PHOP,*,*,*)) to determine the element type and size.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the information is unavailable, then the values returned in the output parameters are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

2
Function Requires State (PHOP,*,*,*)
201
Specified Structure Does Not Exist
202
Specified Element Does Not Exist

Language Bindings

C

pinq_elem_content (struct_id, elem_num, store, err_ind, elem_data)

Input Parameters

Pint struct_id
Structure identifier.

Pint elem_num
Element number (>=0).

Pstore store
Handle to the Store object. The graPHIGS API uses an object of type Store to facilitate the use of subroutines which return complex data. See Create Store ( CREATE STORE (PHOP,*,*,*)) subroutine for details on how the graPHIGS API uses this parameter on inquiries.

Output Parameter

Pint *err_ind
Error indicator.

Pelem_data **elem_data
Data record. The memory referenced by *elem_data is managed by the parameter store.

FORTRAN

PQECO (strid, elenum, iil, irl, isl, errind, il, ia, rl, ra, sl, lstr, str)

Input Parameters

integer strid
Structure identifier.

integer elenum
Element position (>=0).

integer iil
Dimension of integer array (>=0).

integer irl
Dimension of real array (>=0).

integer isl
Dimension of character array (>=0).

Output Parameters

integer errind
Error indicator.

integer il
Number of integer entries.

integer ia (iil)
Array containing integer entries.

integer rl
Number of real entries.

real ra (irl)
Array containing real entries.

integer sl
Number of character string entries.

integer lstr (isl)
Length of each character string entry.

character*(*) str(isl)
Character string entries.

FORTRAN Subset

PQECO (strid, elenum, iil, irl, isl, errind, il, ia, rl, ra, sl, lstr, str)

Input Parameters

integer strid
Structure identifier.

integer elenum
Element position (>=0).

integer iil
Dimension of integer array (>=0).

integer irl
Dimension of real array (>=0).

integer isl
Dimension of character array (>=0).

Output Parameters

integer errind
Error indicator.

integer il
Number of integer entries.

integer ia (iil)
Array containing integer entries.

integer rl
Number of real entries.

real ra (irl)
Array containing real entries.

integer sl
Number of character string entries.

integer lstr (isl)
Length of each character string entry.

character*80 str(isl)
Character string entries.

Errors

None

Related Subroutines

  • Inquire Element Type And Size

    • [ Previous | Next | Contents | Glossary | Home | Search ]