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

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

Purpose

Use Inquire Current Element Content to retrieve the current structure element content that is indicated by the element pointer.

This subroutine returns the data contained in the current element. The graPHIGS API returns the data 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 Current Element Type And Size subroutine to determine the element type and size.

To execute this subroutine, a structure must be open.

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 the following error:

5
Function Requires State (PHOP,*,STOP,*)

Language Bindings

C

pinq_cur_elem_content (store, err_ind, elem_data)

Input Parameters

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 Parameters

Pint *err_ind
Error indicator.

Pelem_data **elem_data
Element data. The memory referenced by *elem_data is managed by the parameter store.

FORTRAN

PQCECO (iil, irl, isl, errind, il, ia, rl, ra, sl, lstr, str)

Input Parameters

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.

integer 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

PQCECO (iil, irl, isl, errind, il, ia, rl, ra, sl, lstr, str)

Input Parameters

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.

integer 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 Current Element Type And Size

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