# PXFA(type)GET

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

## Module

USE IFPOSIX

CALL PXFA(type)GET (jhandle,compname,value,ialen,ierror)

CALL PXFA(type)GET (jhandle,compname,value,ialen,ilen,ierror) ! syntax when (type) is STR

(type) | A placeholder for one of the following values:
Value | Data Type | Routine Name
--- | --- | ---
INT | INTEGER(4) | PXFAINTGET
REAL | REAL(4) | PXFAREALGET
LGCL | LOGICAL(4) | PXFALGCLGET
STR | CHARACTER*(*) | PXFASTRGET
CHAR | CHARACTER(1) | PXFACHARGET
DBL | REAL(8) | PXFADBLGET
INT8 | INTEGER(8) | PXFAINT8GET
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) An array, 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 of the array is INTEGER(4). Stores the value of the component (or field).
ialen | (Input) INTEGER(4). The size of array value.
ilen | (Output) INTEGER(4). This argument can only be used when (type) is STR (PXFASTRGET). An array that stores the lengths of elements of array value.
ierror | (Output) INTEGER(4). The error status.

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

The PXFA(type)GET subroutines are similar to the PXF(type)GET subroutines, but they should be used when the component (or field) of the structure is an array.

When the PXFA(type)GET subroutines are used, the entire array is accessed (read from the component or field) as a unit.

Parent topic: POSIX* Library Routines

## See Also

PXFA(type)SET
PXF(type)GET