.\" Modified 2002-07-27 by Walter Harms
.\" (walter.harms@informatik.uni-oldenburg.de)
.\"
-.TH FREXP 3 2015-03-02 "" "Linux Programmer's Manual"
+.TH FREXP 3 2017-09-15 "" "Linux Programmer's Manual"
.SH NAME
frexp, frexpf, frexpl \- convert floating-point number to fractional
and integral components
.SH SYNOPSIS
.nf
.B #include <math.h>
-.sp
+.PP
.BI "double frexp(double " x ", int *" exp );
-.br
.BI "float frexpf(float " x ", int *" exp );
-.br
.BI "long double frexpl(long double " x ", int *" exp );
.fi
-.sp
+.PP
Link with \fI\-lm\fP.
-.sp
+.PP
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
-.sp
+.PP
.ad l
.BR frexpf (),
.BR frexpl ():
.RS 4
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
-_POSIX_C_SOURCE\ >=\ 200112L;
-.br
-or
-.I cc\ -std=c99
+_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L
+ || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+ || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.RE
.ad
.SH DESCRIPTION
times a power of two,
and its absolute value is always in the range 1/2 (inclusive) to
1 (exclusive), that is, [0.5,1).
-
+.PP
If
.I x
is zero, then the normalized fraction is
zero and zero is stored in
.IR exp .
-
+.PP
If
.I x
is a NaN,
a NaN is returned, and the value of
.I *exp
is unspecified.
-
+.PP
If
.I x
is positive infinity (negative infinity),
.TE
.SH CONFORMING TO
C99, POSIX.1-2001, POSIX.1-2008.
-
+.PP
The variant returning
.I double
also conforms to
SVr4, 4.3BSD, C89.
.SH EXAMPLE
The program below produces results such as the following:
-.sp
-.nf
+.PP
.in +4n
+.EX
.RB "$" " ./a.out 2560"
frexp(2560, &e) = 0.625: 0.625 * 2^12 = 2560
.RB "$" " ./a.out \-4"
frexp(\-4, &e) = \-0.5: \-0.5 * 2^3 = \-4
+.EE
.in
-.fi
.SS Program source
\&
-.nf
+.EX
#include <math.h>
#include <float.h>
#include <stdio.h>
x, r, r, FLT_RADIX, exp, x);
exit(EXIT_SUCCESS);
}
-.fi
+.EE
.SH SEE ALSO
.BR ldexp (3),
.BR modf (3)