ieee_sun(3m) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

ieee_sun(3m)

ieee_sun(3M)            Mathematical Library Functions            ieee_sun(3M)

NAME
       ieee_sun, fp_class, fp_classf, fp_classl, isinf, isinff, isinfl, isnor‐
       mal,  isnormalf,  isnormall,  issubnormal,  issubnormalf, issubnormall,
       iszero,  iszerof,  iszerol,  signbit,  signbitf,   signbitl,   nonstan‐
       dard_arithmetic,  standard_arithmetic,  ieee_retrospective  - miscella‐
       neous floating-point functions

SYNOPSIS
       cc [ flag ... ] file ...  -lsunmath -lm [ library ... ]
       #include <sunmath.h>

       enum fp_class_type fp_class(double x);


       enum fp_class_type fp_classf(float x);


       enum fp_class_type fp_classl(long double x);


       int isinf(double x);


       int isinff(float x);


       int isinfl(long double x);


       int isnormal(double x);


       int isnormalf(float x);


       int isnormall(long double x);


       int issubnormal(double x);


       int issubnormalf(float x);


       int issubnormall(long double x);


       int iszero(double x);


       int iszerof(float x);


       int iszerol(long double x);


       int signbit(double x);


       int signbitf(float x);


       int signbitl(long double x);


       void nonstandard_arithmetic(void);


       void standard_arithmetic(void);


       #include <stdio.h>


       void ieee_retrospective(FILE *f);

DESCRIPTION
       Some of these functions provide capabilities suggested in the  Appendix
       of ANSI/IEEE Std 754-1985.


       fp_class(x)  returns a value that identifies x as zero, subnormal, nor‐
       mal, infinite, or a quiet or signaling NaN. The type enum fp_class_type
       is defined in <floatingpoint.h>.


       The following functions return 1 if the indicated condition is true,  0
       otherwise:

       isinf(x)            x is infinite


       isnormal(x)         x is normal


       issubnormal(x)      x is subnormal


       iszero(x)           x is zero


       signbit(x)          x's sign bit is set



       nonstandard_arithmetic()  and  standard_arithmetic()  are meaningful on
       systems that provide  an  alternative  faster  mode  of  floating-point
       arithmetic that does not conform to the default IEEE Standard. Nonstan‐
       dard  modes  vary  among implementations; nonstandard mode may, for in‐
       stance, result in setting subnormal results to zero or in treating sub‐
       normal operands as zero, or both, or  something  else.  standard_arith‐
       metic()  reverts  to the default standard mode. On systems that provide
       only one mode, these functions have no effect.


       ieee_retrospective(f) prints a message to the file described by FILE *f
       listing all non-default floating-point modes and status in effect  when
       called,  including accrued exception flags, rounding direction and pre‐
       cision modes,  trap-enable  modes,  and  nonstandard  arithmetic  mode.
       ieee_retrospective()  is intended to be used at the end of a program to
       indicate exceptional floating-point conditions that might have affected
       the result.


       A program can explicitly call ieee_retrospective() at any time. Fortran
       programs compiled with f95 in  -f77  compatibility  mode  automatically
       call  ieee_retrospective() before they exit. C/C++ programs and Fortran
       programs compiled with f95 in the default  mode  do  not  automatically
       call  ieee_retrospective(). The f95 compiler enables trapping on common
       exceptions by default, so unless a program either  explicitly  disables
       trapping  or  installs a SIGFPE handler, it will immediately abort when
       such an exception occurs. In -f77 compatibility mode, the compiler does
       not enable trapping, so when floating point exceptions occur, the  pro‐
       gram  continues  execution  and alerts the user to those exceptions via
       the ieee_retrospective() output.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       tab() box; lw(2.75i) |lw(2.75i) lw(2.75i) |lw(2.75i)


       ATTRIBUTE TYPEATTRIBUTE VALUE _ Interface StabilityCommitted _  MT-Lev‐
       elMT-Safe


SEE ALSO
       copysign(3M), fpclassify(3M), fex_set_log(3M), ilogb(3M), isfinite(3M),
       isinf(3M),   isnan(3M),   isnormal(3M),  nextafter(3M),  remainder(3M),
       scalbn(3M), signbit(3M), attributes(5), floatingpoint.h(3HEAD)

NOTES
       As required by C99, the  <math.h>  header  file  defines  macros  named
       isinf(),  isnormal(),  and  signbit(). These macros are compatible with
       the isinf(), isnormal(), and signbit() functions except that  they  may
       return  any  non-zero  value, not necessarily 1, when the corresponding
       condition is met. In a source file that includes  <math.h>,  references
       to  isinf(),  isnormal(),  and signbit() result in substituton of these
       macros by default. In order to invoke the actual  isinf(),  isnormal(),
       and signbit() functions, a source file must either not include <math.h>
       or  else  explicitly  undefine  the  corresponding  macros.  Unlike the
       isinf(), isnormal(), and signbit() functions, which only  accept  argu‐
       ments of type double, however, the macros are type-generic; i.e., their
       arguments  may be any expression of type float, double, or long double.
       Therefore, undefining the macros may change the behavior of  a  program
       that uses them with arguments of type other than double. Such a program
       must  also  be changed to use the functions of the corresponding types,
       e.g., isinff(), isinfl(), etc. See isinf(3M), isnormal(3M),  and  sign‐
       bit(3M) for more information.

Studio 12.6                       14 Mar 2009                     ieee_sun(3M)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3