*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> f90/get_ieee_exceptions (3)              
Title
Content
Arch
Section
 

Contents


GET_IEEE_EXCEPTIONS(3I)				       Last changed: 1-6-98

NAME    [Toc]    [Back]

     GET_IEEE_EXCEPTIONS - Retrieves flags that	represent the current
     floating-point exception status

SYNOPSIS    [Toc]    [Back]

     GET_IEEE_EXCEPTIONS ([STATUS=]status)

IMPLEMENTATION    [Toc]    [Back]

     UNICOS/mk and IRIX	systems

     CRAY T90 systems that support IEEE	floating-point arithmetic

STANDARDS    [Toc]    [Back]

     CF90 and MIPSpro 7	Fortran	90 compiler extension to Fortran 90

     IEEE Standard for Binary Floating-point Arithmetic

DESCRIPTION    [Toc]    [Back]

     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.

NOTES    [Toc]    [Back]

     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]    [Back]

     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).

EXAMPLES    [Toc]    [Back]

     See the example on	CLEAR_IEEE_EXCEPTION(3I).

SEE ALSO    [Toc]    [Back]

      
      
     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

NAME    [Toc]    [Back]

     GET_IEEE_EXCEPTIONS - Retrieves flags that	represent the current
     floating-point exception status

SYNOPSIS    [Toc]    [Back]

     GET_IEEE_EXCEPTIONS ([STATUS=]status)

IMPLEMENTATION    [Toc]    [Back]

     UNICOS/mk and IRIX	systems

     CRAY T90 systems that support IEEE	floating-point arithmetic

STANDARDS    [Toc]    [Back]

     CF90 and MIPSpro 7	Fortran	90 compiler extension to Fortran 90

     IEEE Standard for Binary Floating-point Arithmetic

DESCRIPTION    [Toc]    [Back]

     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.

NOTES    [Toc]    [Back]

     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]    [Back]

     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).

EXAMPLES    [Toc]    [Back]

     See the example on	CLEAR_IEEE_EXCEPTION(3I).

SEE ALSO    [Toc]    [Back]

      
      
     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.

[ Back ]
 Similar pages
Name OS Title
fsigfpe IRIX floating-point exception handler package
sigfpe IRIX floating-point exception handler package
set_ieee_exception IRIX Sets floating-point exception indicator
clear_ieee_exception IRIX Clears floating-point exception indicator
test_ieee_exception IRIX Returns the state of a floating-point exception
fenv Linux C99 floating point rounding and exception handling
fpe_ss IRIX SpeedShop floating-point exception tracing library
get_ieee_interrupts IRIX floating-point interrupt status
set_ieee_status IRIX Restores floating-point status
get_ieee_status IRIX floating-point status upon entry to a procedure
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service