2004-11-03 13:51:07 +00:00
|
|
|
.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
|
|
|
|
.\" Distributed under GPL
|
2009-03-10 09:09:21 +00:00
|
|
|
.\" heavily based on glibc infopages, copyright Free Software Foundation
|
2009-02-03 03:58:22 +00:00
|
|
|
.TH SIGNIFICAND 3 2009-02-04 "GNU" "Linux Programmer's Manual"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
|
|
|
significand, significandf, significandl \-
|
2008-07-23 02:57:20 +00:00
|
|
|
get mantissa of floating-point number
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B #include <math.h>
|
2007-04-12 22:42:49 +00:00
|
|
|
.sp
|
2004-11-03 13:51:07 +00:00
|
|
|
.BI "double significand(double " x );
|
|
|
|
.br
|
|
|
|
.BI "float significandf(float " x );
|
|
|
|
.br
|
|
|
|
.BI "long double significandl(long double " x );
|
|
|
|
.sp
|
2007-07-21 05:25:03 +00:00
|
|
|
Link with \fI\-lm\fP.
|
2007-07-08 12:11:40 +00:00
|
|
|
.sp
|
|
|
|
.in -4n
|
|
|
|
Feature Test Macro Requirements for glibc (see
|
|
|
|
.BR feature_test_macros (7)):
|
|
|
|
.in
|
|
|
|
.sp
|
|
|
|
.ad l
|
|
|
|
.BR significand (),
|
2007-07-08 12:39:24 +00:00
|
|
|
.BR significandf (),
|
2007-07-08 12:11:40 +00:00
|
|
|
.BR significandl ():
|
2010-09-19 05:41:48 +00:00
|
|
|
.RS 4
|
2007-07-08 12:11:40 +00:00
|
|
|
_SVID_SOURCE || _BSD_SOURCE
|
2010-09-19 05:41:48 +00:00
|
|
|
.RE
|
2007-07-08 12:11:40 +00:00
|
|
|
.ad b
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
The
|
2005-10-19 07:07:02 +00:00
|
|
|
.BR significand ()
|
2004-11-03 13:51:07 +00:00
|
|
|
function returns the mantissa of
|
|
|
|
.I x
|
|
|
|
scaled to the range [1,2).
|
|
|
|
It is equivalent to
|
|
|
|
.sp
|
2007-12-19 06:57:44 +00:00
|
|
|
.in +4n
|
2005-07-06 08:00:30 +00:00
|
|
|
scalb(x, (double) \-ilogb(x))
|
2007-12-19 06:57:44 +00:00
|
|
|
.in
|
2004-11-03 13:51:07 +00:00
|
|
|
.PP
|
|
|
|
This function exists mainly for use in certain standardized tests
|
|
|
|
for IEEE 754 conformance.
|
2009-02-03 08:32:43 +00:00
|
|
|
.SH CONFORMING TO
|
accept.2, execve.2, futimesat.2, getresuid.2, getrlimit.2, madvise.2, mq_getsetattr.2, msgctl.2, nice.2, open.2, poll.2, setresuid.2, shmctl.2, sigaction.2, times.2, utimensat.2, __setfpucw.3, atoi.3, endian.3, err.3, euidaccess.3, fenv.3, fopencookie.3, fpurge.3, getgrouplist.3, getutmp.3, j0.3, lgamma.3, netlink.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_kill_other_threads_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, pthread_yield.3, random_r.3, readdir.3, rtnetlink.3, scanf.3, setenv.3, significand.3, sigsetops.3, strerror.3, strstr.3, sysv_signal.3, termios.3, timegm.3, unlocked_stdio.3, y0.3, locale.5, bootparam.7, feature_test_macros.7, ip.7, locale.7, pthreads.7, rtld-audit.7, nscd.8: Global fix: s/non-standard/nonstandard/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 16:37:52 +00:00
|
|
|
These functions are nonstandard; the
|
2009-02-03 03:58:22 +00:00
|
|
|
.I double
|
|
|
|
version is available on a number of other systems.
|
2007-05-18 11:59:14 +00:00
|
|
|
.\" .SH HISTORY
|
|
|
|
.\" This function came from BSD.
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR ilogb (3),
|
|
|
|
.BR scalb (3)
|