PXF<TYPE>SET

POSIX Subroutine: Sets the value of a component (or field) of a structure.

Module: USE IFPOSIX

Syntax

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

CALL PXF<TYPE>SET (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) PXFINTSET
REAL REAL(4) PXFREALSET
LGCL LOGICAL(4) PXFLGCLSET
STR CHARACTER*(*) PXFSTRSET
CHAR CHARACTER(1) PXFCHARSET
DBL REAL(8) PXFDBLSET
INT8 INTEGER(8) PXFINT8SET

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) 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). The value for the component (or field).


ilen
(Input) INTEGER(4). This argument can only be used when <TYPE> is STR (PXFSTRSET). The length of the string in value.


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

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

The PXF<TYPE>SET subroutines set or modify the value in component (or field) compname of the structure associated with handle jhandle from variable value.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also

PXF<TYPE>GET

Example

See the example in PXFSTRUCTCREATE (which shows PXFSTRSET)