[ 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) |
Pint struct_idStructure identifier.
Pint elem_numElement number
(>=0).
Pstore storeHandle 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.
Pint *err_indError indicator.
Pelem_data **elem_dataData 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) |
integer stridStructure identifier.
integer elenumElement position
(>=0).
integer iilDimension of integer array
(>=0).
integer irlDimension of real array
(>=0).
integer islDimension of character array
(>=0).
integer errindError indicator.
integer ilNumber of integer entries.
integer ia (iil)Array containing integer entries.
integer rlNumber of real entries.
real ra (irl)Array containing real entries.
integer slNumber 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) |
integer stridStructure identifier.
integer elenumElement position
(>=0).
integer iilDimension of integer array
(>=0).
integer irlDimension of real array
(>=0).
integer islDimension of character array (>=0).
integer errindError indicator.
integer ilNumber of integer entries.
integer ia (iil)Array containing integer entries.
integer rlNumber of real entries.
real ra (irl)Array containing real entries.
integer slNumber 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 ]