2 .\" Copyright 2004 Andries Brouwer <aeb@cwi.nl>.
3 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
4 .\" <mtk.manpages@gmail.com>
6 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
8 .TH scalb 3 (date) "Linux man-pages (unreleased)"
10 scalb, scalbf, scalbl \- multiply floating-point number
11 by integral power of radix (OBSOLETE)
14 .RI ( libm ", " \-lm )
19 .BI "[[deprecated]] double scalb(double " x ", double " exp );
20 .BI "[[deprecated]] float scalbf(float " x ", float " exp );
21 .BI "[[deprecated]] long double scalbl(long double " x ", long double " exp );
25 Feature Test Macro Requirements for glibc (see
26 .BR feature_test_macros (7)):
32 .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
33 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
34 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
41 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
42 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
45 These functions multiply their first argument
60 can be obtained by including
62 .\" not in /usr/include but in a gcc lib
64 On success, these functions return
75 is a NaN, a NaN is returned.
79 is positive infinity (negative infinity),
82 is not negative infinity,
83 positive infinity (negative infinity) is returned.
89 is not positive infinity, +0 (\-0) is returned.
96 a domain error occurs, and
104 is negative infinity,
105 a domain error occurs, and
108 If the result overflows,
109 a range error occurs,
110 and the functions return
115 respectively, with a sign the same as
118 If the result underflows,
119 a range error occurs,
120 and the functions return zero, with a sign the same as
125 for information on how to determine whether an error has occurred
126 when calling these functions.
128 The following errors can occur:
130 Domain error: \fIx\fP is 0, and \fIexp\fP is positive infinity, \
131 or \fIx\fP is positive infinity and \fIexp\fP is negative infinity \
132 and the other argument is not a NaN
136 An invalid floating-point exception
140 Range error, overflow
144 An overflow floating-point exception
148 Range error, underflow
152 An underflow floating-point exception
156 For an explanation of the terms used in this section, see
162 Interface Attribute Value
169 T} Thread safety MT-Safe
177 Obsolescent in POSIX.1-2001;
178 Removed in POSIX.1-2008,
179 recommending the use of
185 .\" Looking at header files: scalbf() is present on the
186 .\" BSDs, Tru64, HP-UX 11, Irix 6.5; scalbl() is on HP-UX 11 and Tru64.
189 .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803
190 .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6804
191 these functions did not set
193 for domain and range errors.