PXF<TYPE>GET

POSIX Subroutine: Gets the value stored in a component (or field) of a structure.

Module: USE IFPOSIX

Syntax

CALL PXF<TYPE>GET (jhandle, compname, value, ierror)

CALL PXF<TYPE>GET (jhandle, compname, value, ilen, ierror)    ! syntax when <TYPE> is STR

<TYPE>
A placeholder for one of the following values:


Value Data Type Routine Name
INT INTEGER(4) PXFINTGET
REAL REAL(4) PXFREALGET
LGCL LOGICAL(4) PXFLGCLGET
STR CHARACTER*(*) PXFSTRGET
CHAR CHARACTER(1) PXFCHARGET
DBL REAL(8) PXFDBLGET
INT8 INTEGER(8) PXFINT8GET

jhandle
(Input) INTEGER(4). A handle of a structure.


compname
(Input) Character. The name of the component (or field) of the structure to retrieve data from.


value
(Output) A variable, whose data type depends on the value of <TYPE>. See the table above for the data types for each value; for example, if the value for <TYPE> is INT, the data type is INTEGER(4). Stores the value of the component (or field).


ilen
(Output) INTEGER(4). This argument can only be used when <TYPE> is STR (PXFSTRGET). Stores the length of the returned string.


ierror
(Output) INTEGER(4). The error status.

If successful, ierror is set to zero; otherwise, an error code.

The PXF<TYPE>GET subroutines retrieve the value from component (or field) compname of the structure associated with handle jhandle into variable value.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also

PXF<TYPE>SET

Example

See the example in PXFTIMES (which shows PXFINTGET and PXFINT8GET)