Intel® Fortran Compiler 17.0 Developer Guide and Reference

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.

See Also