.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
+.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
.\"
.\" References consulted:
.\" Linux libc source code
.\" Modified 2002-07-27 by Walter Harms
.\" (walter.harms@informatik.uni-oldenburg.de)
.\"
-.TH FREXP 3 2010-09-20 "" "Linux Programmer's Manual"
+.TH FREXP 3 2013-08-06 "" "Linux Programmer's Manual"
.SH NAME
frexp, frexpf, frexpl \- convert floating-point number to fractional
and integral components
.SH DESCRIPTION
The
.BR frexp ()
-function is used to split the number \fIx\fP into a
-normalized fraction and an exponent which is stored in \fIexp\fP.
-.SH "RETURN VALUE"
+function is used to split the number
+.I x
+into a
+normalized fraction and an exponent which is stored in
+.IR exp .
+.SH RETURN VALUE
The
.BR frexp ()
function returns the normalized fraction.
-If the argument \fIx\fP is not zero,
-the normalized fraction is \fIx\fP times a power of two,
+If the argument
+.I x
+is not zero,
+the normalized fraction is
+.I x
+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).
-If \fIx\fP is zero, then the normalized fraction is
-zero and zero is stored in \fIexp\fP.
+If
+.I x
+is zero, then the normalized fraction is
+zero and zero is stored in
+.IR exp .
If
.I x
is unspecified.
.SH ERRORS
No errors occur.
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR frexp (),
+.BR frexpf (),
+and
+.BR frexpl ()
+functions are thread-safe.
+.SH CONFORMING TO
C99, POSIX.1-2001.
The variant returning
.I double
.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
+frexp(\-4, &e) = \-0.5: \-0.5 * 2^3 = \-4
.in
.fi
.SS Program source
exit(EXIT_SUCCESS);
}
.fi
-.SH "SEE ALSO"
+.SH SEE ALSO
.BR ldexp (3),
.BR modf (3)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.