POSIX Subroutine: Sets the value of an array component (or field) of a structure.
Module: USE IFPOSIX
Syntax
CALL PXFA<TYPE>SET (jhandle, compname, value, ialen, ierror)
CALL PXFA<TYPE>SET (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) | PXFAINTSET |
| REAL | REAL(4) | PXFAREALSET |
| LGCL | LOGICAL(4) | PXFALGCLSET |
| STR | CHARACTER*(*) | PXFASTRSET |
| CHAR | CHARACTER(1) | PXFACHARSET |
| DBL | REAL(8) | PXFADBLSET |
| INT8 | INTEGER(8) | PXFAINT8SET |
jhandle
(Input) INTEGER(4). A handle of a structure.
compname
(Input) Character. The name of the component (or field) of the structure to write data to.
value
(Input) 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). The value for the component (or field).
ialen
(Input) INTEGER(4). The size of array value.
ilen
(Input) INTEGER(4). This argument can only be used when <TYPE> is STR (PXFASTRSET). An array that specifies 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>SET subroutines are similar to the PXF<TYPE>SET subroutines, but they should be used when the component (or field) of the structure is an array.
When the PXFA<TYPE>SET subroutines are used, the entire array is accessed (written to the component or field) as a unit.
Compatibility
CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB
See Also