Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ././../../../../../../usr/man/man3m/scalb.3m
Real path: /usr/share/man/man3m/scalb.3m
Zurück

'\" te .\" Copyright (c) 2001, the Institute of Electrical and Electronics Engineers, Inc. and The Open Group. All Rights Reserved. .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Portions Copyright (c) 2006, 2016, Oracle and/or its affiliates. All rights reserved. .\" Oracle gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. This notice shall appear on any product containing this material. .TH scalb 3M "27 Sept 2016" "Solaris 11.4" "Mathematical Library Functions" .SH NAME scalb, scalbf, scalbl \- load exponent of a radix-independent floating-point number .SH SYNOPSIS .LP .nf c99 [ \fIflag\fR... ] \fIfile\fR... \fB-lm\fR [ \fIlibrary\fR... ] #include <math.h> \fBdouble\fR \fBscalb\fR(\fBdouble\fR \fIx\fR, \fBdouble\fR \fIn\fR); .fi .LP .nf \fBfloat\fR \fBscalbf\fR(\fBfloat\fR \fIx\fR, \fBfloat\fR \fIn\fR); .fi .LP .nf \fBlong double\fR \fBscalbl\fR(\fBlong double\fR \fIx\fR, \fBlong double\fR \fIn\fR); .fi .SH DESCRIPTION .sp .LP These functions compute x * \fIr\fR^n, where \fIr\fR is the radix of the machine's floating point arithmetic. When \fIr\fR is 2, \fBscalb()\fR is equivalent to \fBldexp\fR(3M). The value of \fIr\fR is \fBFLT_RADIX\fR which is defined in <\fBfloat.h\fR>. .SH RETURN VALUES .sp .LP Upon successful completion, the \fBscalb()\fR function returns \fIx\fR * \fIr\fR^n. .sp .LP If \fIx\fR or \fIn\fR is NaN, a NaN is returned. .sp .LP If \fIn\fR is 0, \fIx\fR is returned. .sp .LP If \fIx\fR is \(+-Inf and \fIn\fR is not \(miInf, \fIx\fR is returned. .sp .LP If \fIx\fR is \(+-0 and \fIn\fR is not +Inf, \fIx\fR is returned. .sp .LP If \fIx\fR is \(+-0 and \fIn\fR is +Inf, a domain error occurs and a NaN is returned. .sp .LP If \fIx\fR is \(+-Inf and \fIn\fR is \(miInf, a domain error occurs and a NaN is returned. .sp .LP If the result would cause an overflow, a range error occurs and \(+-\fBHUGE_VAL\fR (according to the sign of \fIx\fR) is returned. .sp .LP For exceptional cases, \fBmatherr\fR(3M) tabulates the values to be returned by \fBscalb()\fR as specified by SVID3 and XPG3. See \fBstandards\fR(7). .SH ERRORS .sp .LP These functions will fail if: .sp .ne 2 .mk .na \fBDomain Error\fR .ad .RS 16n .rt If \fIx\fR is 0 and \fIn\fR is +Inf, or \fIx\fR is Inf and \fIn\fR is \(miInf. .sp If the integer expression (\fBmath_errhandling\fR & \fBMATH_ERREXCEPT\fR) is non-zero, then the invalid floating-point exception is raised. .RE .sp .ne 2 .mk .na \fBRange Error\fR .ad .RS 16n .rt The result would overflow. .sp If the integer expression (\fBmath_errhandling\fR & \fBMATH_ERREXCEPT\fR) is non-zero, then the overflow floating-point exception is raised. .RE .SH USAGE .sp .LP An application wanting to check for exceptions should call \fBfeclearexcept\fR(\fBFE_ALL_EXCEPT\fR) before calling these functions. On return, if \fBfetestexcept\fR(\fBFE_INVALID\fR | \fBFE_DIVBYZERO\fR | \fBFE_OVERFLOW\fR | \fBFE_UNDERFLOW\fR) is non-zero, an exception has been raised. An application should either examine the return value or check the floating point exception flags to detect exceptions. .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed _ Availability system/library/math _ MT-Level MT-Safe _ Standard For \fBscalb()\fR, see \fBstandards\fR(7). .TE .sp .SH SEE ALSO .sp .LP \fBmath.h\fR(3HEAD), \fBfeclearexcept\fR(3M), \fBfetestexcept\fR(3M), \fBilogb\fR(3M), \fBldexp\fR(3M), \fBlogb\fR(3M), \fBmatherr\fR(3M), \fBscalbln\fR(3M), \fBattributes\fR(7), \fBstandards\fR(7)