HP 3000 Manuals HP 3000 Manuals
VGETIEEELONG
Copies character coded data contents from data buffer into an applicaton,
converting numeric value to IEEE floating point long format (64-bit).
Syntax
VGETIEEELONG {comarea,fieldnum,variable}
Parameters
comarea Must be the comarea name specified when the forms file
was opened with VOPENFORMF. If not already set, the
following comarea items must be set before calling
VGETIEEELONG:
cstatus Set to zero.
comarealen Set to total number of two-byte words
in comarea
VGETIEEELONG may set the following comarea items:
cstatus Set to nonzero value if call is
unsuccessful or if requested field has
an error.
fieldnum Two-byte integer variable containing the number assigned
to the field by FORMSPEC. The field itself may not be
longer than 80 characters.
variable Variable within application, of type IEEE floating point
(64 bits), into which converted value is placed.
For example:
VGETIEEELONG(COMAREA,FIELDNUM,VARIABLE);
Discussion
The content of the field denoted by the field number is read from the
data buffer. The content of the field must be numeric, but its data type
need not be; numbers in a field of CHAR type can be coverted.
NOTE The field number is a unique number assigned to each field by
FORMSPEC and is completedly indpendent of the field's position in
the data buffer or the form. It only changes if the batch command,
RENUMBER, is used. You can alter the length, position or other
characteristics of a field without affecting the field number. The
field number provides a way to locate fields regardless of their
position.
The numeric value, stored in the buffer in character coded form, is
converted to IEEE floating point long format and then copied to the
variable in the application. If errors occur during conversion, cstatus
is set to the appropriate error code. If the requested field's erreor
code is set, its value is moved to the variable but cstatus is set to an
error code.