PXFSTRGET(3F) Last changed: 1-6-98
NAME
PXFSTRGET - Allows values stored in individual components of a
structure to be extracted and used
SYNOPSIS
INTEGER jhandle, ilen, ierror
CHARACTER*(n) compnam, value
CALL PXFSTRGET (jhandle, compnam, value, ilen, ierror)
IMPLEMENTATION
UNICOS, UNICOS/mk, and IRIX systems
STANDARDS
IEEE standard interface for FORTRAN 77
DESCRIPTION
On IRIX systems, this routine is in libfortran.so which is linked by
default when compiling programs with the MIPSpro 7 Fortran 90 compiler
or when compiling programs with the -craylibs option to the MIPSpro
7.2 F77 compiler.
The routine PXFSTRGET allows character values stored in individual
components of a structure to be extracted and used.
When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
UNICOS, UNICOS/mk, or IRIX, all arguments must be of default kind
unless documented otherwise. On UNICOS and UNICOS/mk, default kind is
KIND=8 for integer, real, complex, and logical arguments; on IRIX, the
default kind is KIND=4.
The following are arguments to PXFSTRGET:
jhandle An input integer that references a structure. jhandle
should have been created with PXFSTRUCTCREATE.
compnam An input character variable that is the name of a component
of the structure. compnam is case-sensitive.
value An output character variable. Upon successful completion,
value is set to the value stored in the component of jhandle
referenced by compnam. If the length of the data being
stored is less than the declared length of value, value is
padded with blanks.
The structures and components that may be accessed through
PXFSTRGET are described on the man page for the related PXF
routine. For example, the PXFUNAME man page describes the
components for the utsname structure.
ilen An output integer variable. ilen is set to the actual
length of the data assigned to value. If the length of
value is insufficient to contain the data being returned,
the data is truncated, and ilen contains the original length
of the data before truncation. In this case, ierror is set
to ETRUNC.
ierror An output integer variable. Upon successful completion of
PXFSTRGET, ierror is set to 0. If any of the following
conditions occur, ierror is set to the corresponding value:
ENONAME Component name is not defined for the
specified structure.
ETRUNC The actual length of the data to be copied to
value was longer than the declared length of
value.
EBADHANDLE If jhandle is an invalid handle or has an
incorrect handle type (UNICOS and UNICOS/mk
systems only).
SEE ALSOPXFSTRUCTCREATE(3F), PXFUNAME(3F)
Application Programmer's Library Reference Manual, publication SR-
2165, for the printed version of this man page.
