]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/scalbln.3
fuse.4: ffix
[thirdparty/man-pages.git] / man3 / scalbln.3
index 92334312edd65478c8fe689e1958240433d9c751..6c926dae5e2d94b623ef692e44cbaaeea4e585d0 100644 (file)
@@ -2,7 +2,7 @@
 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
 .\"     <mtk.manpages@gmail.com>
 .\"
-.\" %%%LICENSE_START(verbatim)
+.\" %%%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.
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
-.TH SCALBLN 3 2010-09-20 "" "Linux Programmer's Manual"
+.TH SCALBLN 3 2017-09-15 "" "Linux Programmer's Manual"
 .SH NAME
 scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \-
 multiply floating-point number by integral power of radix
 .SH SYNOPSIS
 .B #include <math.h>
-.sp
+.PP
 .BI "double scalbln(double " x ", long int " exp );
 .br
 .BI "float scalblnf(float " x ", long int " exp );
 .br
 .BI "long double scalblnl(long double " x ", long int " exp );
-.sp
+.PP
 .BI "double scalbn(double " x ", int " exp );
 .br
 .BI "float scalbnf(float " x ", int " exp );
 .br
 .BI "long double scalbnl(long double " x ", int " exp );
-.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 scalbln (),
 .BR scalblnf (),
 .BR scalblnl ():
 .RS
-_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
 .RE
 .br
 .BR scalbn (),
 .BR scalbnf (),
 .BR scalbnl ():
 .RS
-_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 b
 .SH DESCRIPTION
@@ -82,32 +77,37 @@ by
 to the power of
 .IR exp ,
 that is:
+.PP
 .nf
-
     x * FLT_RADIX ** exp
 .fi
-
+.PP
 The definition of
 .B FLT_RADIX
 can be obtained by including
 .IR <float.h> .
 .\" not in /usr/include but in a gcc lib
 .SH RETURN VALUE
-On success, these functions return \fIx\fP * \fBFLT_RADIX\fP ** \fIexp\fP.
-
+On success, these functions return
+.IR x
+*
+.B FLT_RADIX
+**
+.IR exp .
+.PP
 If
 .I x
 is a NaN, a NaN is returned.
-
+.PP
 If
 .I x
 is positive infinity (negative infinity),
 positive infinity (negative infinity) is returned.
-
+.PP
 If
 .I x
 is +0 (\-0), +0 (\-0) is returned.
-
+.PP
 If the result overflows,
 a range error occurs,
 and the functions return
@@ -117,7 +117,7 @@ or
 .BR HUGE_VALL ,
 respectively, with a sign the same as
 .IR x .
-
+.PP
 If the result underflows,
 a range error occurs,
 and the functions return zero, with a sign the same as
@@ -152,8 +152,26 @@ These functions do not set
 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803
 .SH VERSIONS
 These functions first appeared in glibc in version 2.1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw33 lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR scalbn (),
+.BR scalbnf (),
+.BR scalbnl (),
+.br
+.BR scalbln (),
+.BR scalblnf (),
+.BR scalblnl ()
+T}     Thread safety   MT-Safe
+.TE
 .SH CONFORMING TO
-C99, POSIX.1-2001.
+C99, POSIX.1-2001, POSIX.1-2008.
 .SH NOTES
 These functions differ from the obsolete functions described in
 .BR scalb (3)
@@ -163,7 +181,7 @@ of an integral type, while those in
 .BR scalb (3)
 have a second argument of type
 .IR double .
-
+.PP
 If
 .B FLT_RADIX
 equals 2 (which is usual), then