 |
» |
|
|
|
NM and CM callable. Converts data between binary floating-point formats. Syntax | |
* * I16V I16V
HPFPCONVERT(source,destination,sformat,dformat,
I32 I16 I16V
status,exceptions,roundmode) |
Parameters | |
- source
any supported real type by reference
(required) Passes the floating-point number to be converted. Constants
are not acceptable. You can specify a reference parameter of any
supported real type in the intrinsic call statement. The format
is identified by sformat. - destination
any supported real type by reference
(required) Returns the converted floating-point number. If status.info is less than zero, the number is not converted. Any
supported real type can be returned to the intrinsic call statement.
The format is identified by dformat. - sformat
16-bit signed integer by value (required) The floating-point format of the binary number supplied
by source. This is the format of the original number. Valid
formats are: - Value
Meaning - 1
Hewlett-Packard 3000 32-bit - 2
Hewlett-Packard 3000 64-bit - 3
IEEE 32-bit - 4
IEEE 64-bit - 5
IEEE 128-bit
- dformat
16-bit signed integer by value (required) The destination floating-point format. This is the
format of the converted number. Valid formats are: - Value
Meaning - 1
Hewlett-Packard 3000 32-bit - 2
Hewlett-Packard 3000 64-bit - 3
IEEE 32-bit - 4
IEEE 64-bit - 5
IEEE 128-bit
- status
32-bit signed integer by reference (optional) Returns the status of the HPFPCONVERT intrinsic call. If no errors or warnings are encountered, status returns 32 bits of zero. If errors or warnings are
encountered, status is interpreted as two 16-bit fields. Bits (0:16) comprise status.info. A negative value indicates an error condition, refer
to the MPE/iX Error Message Manual Volumes 1, 2 and 3 for
a description of its value. A positive value indicates that the
conversion was made, but an exception occurred and an exceptions parameter was not supplied. The exception conditions
are listed in the exceptions parameter description. Bits (16:16) comprise status.subsys. The value represented by these bits defines the
subsystem that set the status information. The subsystem identifier
for HPFPCONVERT is 193. - exceptions
16-bit signed integer by reference (optional) Returns any exception conditions that occurred during
the conversion. If status.info is less than zero, then exceptions is not modified because no conversion is done. If
this parameter is not present, the value is returned in status.info. Only the following values can be returned: - Value
Meaning - 0
No exceptions - 1
Inexact only (native mode destination only) - 3
Underflow and inexact - 5
Overflow and inexact - 8
Invalid operation
If underflow or overflow occurs during conversion
then inexact is also signaled. - roundmode
16-bit unsigned integer by value (optional) The rounding mode (not applicable if destination is an Hewlett-Packard 3000 format). - Value
Meaning - 0
Round to nearest, to even if tie (default) - 1
Round to zero - 2
Round to positive infinity - 3
Round to negative infinity
Operation Notes | |
The HPFPCONVERT intrinsic accepts a source binary floating-point
number and converts it to the equivalent destination binary floating-point
format. You must specify the format of the source and destination
numbers. Optionally, you can specify the rounding mode. The conversion is performed by regarding the source number
as infinitely precise and with unbounded range, and then rounding
it to fit the designated destination format. Rounding is performed
according to the formal rules for the rounding mode specified. Rounding methods
and exception signaling are determined solely from the destination
format and are independent of the source format. Conversion is performed as if all arithmetic traps are disabled.
No trapping to user-supplied or system-supplied arithmetic trap
routines is done. Related Information | |
- Manual
Data Types Conversion Programmer's Guide.
|
Printable version
