original/man3/significand.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"
   3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   4 .\" Distributed under GPL
   5 .\" %%%LICENSE_END
   6 .\"
   7 .\" heavily based on glibc infopages, copyright Free Software Foundation
   8 .\"
   9 .TH SIGNIFICAND 3 2009-02-04 "GNU" "Linux Programmer's Manual"
  10 .SH NAME
  11 significand, significandf, significandl \-
  12 get mantissa of floating-point number
  13 .SH SYNOPSIS
  14 .B #include <math.h>
  15 .sp
  16 .BI "double significand(double " x );
  17 .br
  18 .BI "float significandf(float " x );
  19 .br
  20 .BI "long double significandl(long double " x );
  21 .sp
  22 Link with \fI\-lm\fP.
  23 .sp
  24 .in -4n
  25 Feature Test Macro Requirements for glibc (see
  26 .BR feature_test_macros (7)):
  27 .in
  28 .sp
  29 .ad l
  30 .BR significand (),
  31 .BR significandf (),
  32 .BR significandl ():
  33 .RS 4
  34 _SVID_SOURCE || _BSD_SOURCE
  35 .RE
  36 .ad b
  37 .SH DESCRIPTION
  38 The
  39 .BR significand ()
  40 function returns the mantissa of
  41 .I x
  42 scaled to the range [1,2).
  43 It is equivalent to
  44 .sp
  45 .in +4n
  46 scalb(x, (double) \-ilogb(x))
  47 .in
  48 .PP
  49 This function exists mainly for use in certain standardized tests
  50 for IEEE 754 conformance.
  51 .SH CONFORMING TO
  52 These functions are nonstandard; the
  53 .I double
  54 version is available on a number of other systems.
  55 .\" .SH HISTORY
  56 .\" This function came from BSD.
  57 .SH SEE ALSO
  58 .BR ilogb (3),
  59 .BR scalb (3)