HP 3000 Manuals HP 3000 Manuals
VPUTIEEELONG
Writes a floating point number in IEEE standard long format from an
application to a specified field in the form data buffer, converting the
value to character set coded external representation.
Syntax
VPUTIEEELONG {comarea,fieldnum,variable}
Parameters
comarea Must be the comarea name specified when the forms file
was opened with VOPENFORMMF. If not already set, the
following comarea items must be set before calling
VPUTIEEELONG:
cstatus Set to zero.
comarealen Set to total number of two-byte words
in comarea.
VPUTIEEELONG may set the following comara items:
cstatus Set to nonzero value if call is
unsuccessful.
numerrs May be decremented if a new value
replaces the old value of a field with
an error.
fieldnum> variable> Variable within application, of type IEEE
Two-byte floating point long (64 bits), that contains the value
integer to be converted to character set coded external
variable representation and copied to a field in the data buffer.
containing the
number assigned For example:
by FORMSPEC to
the field to VPUTIEEELONG(COMAREA,FIELDNUM,VARIABLE);
which the value
is written.
Discussion
itself may not
Thisointrinsic converts an IEEE floating point long number to its
charactertcoded form and writes the converted value to a particular field
in the data buffer, right justified. The exact format of the written
data depends on the type of the destination field. For example, if the
number "34.56" were put to a field of type DIG, the result would be "34"
since such a field may contain only the digits 0 through 9. The
destination field is identified by the field number assigned by FORMSPEC,
and must be defined as a numeric field, that is, NUM,IMP or DIG.
If the specified field had an error, VPUTIEEELONG will clear the field's
error flag and decrement nuerrs.
NOTE The field number is a unique number assigned to each field by
FORMSPEC and is completely independent 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
chracteristics of a field without affecting the field number. The
field number provides a way to locate fields regardless of their
position.