GET_IEEE_EXCEPTIONS(3I) Last changed: 1-6-98
GET_IEEE_EXCEPTIONS - Retrieves flags that represent the current
floating-point exception status
GET_IEEE_EXCEPTIONS ([STATUS=]status)
IMPLEMENTATION [Toc]
UNICOS/mk and IRIX systems
CRAY T90 systems that support IEEE floating-point arithmetic
CF90 and MIPSpro 7 Fortran 90 compiler extension to Fortran 90
IEEE Standard for Binary Floating-point Arithmetic
DESCRIPTION [Toc]
The GET_IEEE_EXCEPTIONS intrinsic subroutine is typically called upon
entry to a procedure to obtain a set of flags that represent the
current floating-point exception status. It accepts the following
argument:
status Must be scalar and of an integer type that occupies a full
word. It is an INTENT(OUT) argument.
The exceptions that are possible are as follows:
* IEEE_XPTN_CRI_INVALID_OPND (accepted only on CRAY T90 systems that
support IEEE floating-point arithmetic)
* IEEE_XPTN_INEXACT_RESULT
* IEEE_XPTN_UNDERFLOW
* IEEE_XPTN_OVERFLOW
* IEEE_XPTN_DIV_BY_ZERO
* IEEE_XPTN_INVALID_OPR
* IEEE_XPTN_ALL
This subroutine increases program performance by capturing and then
directly manipulating the status bits with bit manipulation
operations. This practice compromises portability, however.
The name of this intrinsic cannot be passed as an argument.
The IEEE intrinsic procedures use the named constants contained in a
system module, so you must include one of the following statements in
your program:
* On UNICOS and UNICOS/mk systems: USE CRI_IEEE_DEFINITIONS
* On UNICOS, UNICOS/mk, and IRIX systems: USE FTN_IEEE_DEFINITIONS
The CRI_IEEE_DEFINITIONS module is obsolescent. It will be removed
for the CF90 4.0 release.
RETURN VALUES [Toc]
The value returned in status is the set of bits that represent the
current floating-point exception state.
To determine the exceptions that have been raised, use
TEST_IEEE_EXCEPTION(3I).
See the example on CLEAR_IEEE_EXCEPTION(3I).
CLEAR_IEEE_EXCEPTION(3I), SET_IEEE_EXCEPTION(3I),
TEST_IEEE_EXCEPTION(3I)
Intrinsic Procedures Reference Manual, publication SR-2138, for the
printed version of this man page.
GET_IEEE_EXCEPTIONS(3I) Last changed: 1-6-98
GET_IEEE_EXCEPTIONS - Retrieves flags that represent the current
floating-point exception status
GET_IEEE_EXCEPTIONS ([STATUS=]status)
IMPLEMENTATION [Toc]
UNICOS/mk and IRIX systems
CRAY T90 systems that support IEEE floating-point arithmetic
CF90 and MIPSpro 7 Fortran 90 compiler extension to Fortran 90
IEEE Standard for Binary Floating-point Arithmetic
DESCRIPTION [Toc]
The GET_IEEE_EXCEPTIONS intrinsic subroutine is typically called upon
entry to a procedure to obtain a set of flags that represent the
current floating-point exception status. It accepts the following
argument:
status Must be scalar and of an integer type that occupies a full
word. It is an INTENT(OUT) argument.
The exceptions that are possible are as follows:
* IEEE_XPTN_CRI_INVALID_OPND (accepted only on CRAY T90 systems that
support IEEE floating-point arithmetic)
* IEEE_XPTN_INEXACT_RESULT
* IEEE_XPTN_UNDERFLOW
* IEEE_XPTN_OVERFLOW
* IEEE_XPTN_DIV_BY_ZERO
* IEEE_XPTN_INVALID_OPR
* IEEE_XPTN_ALL
This subroutine increases program performance by capturing and then
directly manipulating the status bits with bit manipulation
operations. This practice compromises portability, however.
The name of this intrinsic cannot be passed as an argument.
The IEEE intrinsic procedures use the named constants contained in a
system module, so you must include one of the following statements in
your program:
* On UNICOS and UNICOS/mk systems: USE CRI_IEEE_DEFINITIONS
* On UNICOS, UNICOS/mk, and IRIX systems: USE FTN_IEEE_DEFINITIONS
The CRI_IEEE_DEFINITIONS module is obsolescent. It will be removed
for the CF90 4.0 release.
RETURN VALUES [Toc]
The value returned in status is the set of bits that represent the
current floating-point exception state.
To determine the exceptions that have been raised, use
TEST_IEEE_EXCEPTION(3I).
See the example on CLEAR_IEEE_EXCEPTION(3I).
CLEAR_IEEE_EXCEPTION(3I), SET_IEEE_EXCEPTION(3I),
TEST_IEEE_EXCEPTION(3I)
Intrinsic Procedures Reference Manual, publication SR-2138, for the
printed version of this man page.
Similar pages