Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

PXFESET

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

Module

USE IFPOSIX

CALL PXFE(type)SET (jhandle, compname,index,value,ierror)

CALL PXFE(type)SET (jhandle,compname,index,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)

PXFEINTSET

REAL

REAL(4)

PXFEREALSET

LGCL

LOGICAL(4)

PXFELGCLSET

STR

CHARACTER*(*)

PXFESTRSET

CHAR

CHARACTER(1)

PXFECHARSET

DBL

REAL(8)

PXFEDBLSET

INT8

INTEGER(8)

PXFEINT8SET

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.

index

(Input) INTEGER(4). The index of the array element 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 (PXFESTRSET). The length of the string value.

ierror

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

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

The PXFE(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 PXFE(type)SET subroutines are used, the array element with index index is accessed (written to the component or field).