xref: /freebsd/lib/msun/man/scalbn.3 (revision dc36d6f9bb1753f3808552f3afd30eda9a7b206a)
129bf6af8SDavid Schultz.\" Copyright (c) 1985, 1991 Regents of the University of California.
229bf6af8SDavid Schultz.\" All rights reserved.
329bf6af8SDavid Schultz.\"
429bf6af8SDavid Schultz.\" Redistribution and use in source and binary forms, with or without
529bf6af8SDavid Schultz.\" modification, are permitted provided that the following conditions
629bf6af8SDavid Schultz.\" are met:
729bf6af8SDavid Schultz.\" 1. Redistributions of source code must retain the above copyright
829bf6af8SDavid Schultz.\"    notice, this list of conditions and the following disclaimer.
929bf6af8SDavid Schultz.\" 2. Redistributions in binary form must reproduce the above copyright
1029bf6af8SDavid Schultz.\"    notice, this list of conditions and the following disclaimer in the
1129bf6af8SDavid Schultz.\"    documentation and/or other materials provided with the distribution.
12*fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
1329bf6af8SDavid Schultz.\"    may be used to endorse or promote products derived from this software
1429bf6af8SDavid Schultz.\"    without specific prior written permission.
1529bf6af8SDavid Schultz.\"
1629bf6af8SDavid Schultz.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
1729bf6af8SDavid Schultz.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1829bf6af8SDavid Schultz.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1929bf6af8SDavid Schultz.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2029bf6af8SDavid Schultz.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2129bf6af8SDavid Schultz.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2229bf6af8SDavid Schultz.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2329bf6af8SDavid Schultz.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2429bf6af8SDavid Schultz.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2529bf6af8SDavid Schultz.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2629bf6af8SDavid Schultz.\" SUCH DAMAGE.
2729bf6af8SDavid Schultz.\"
28388bf3b6SDavid Schultz.Dd March 4, 2005
2929bf6af8SDavid Schultz.Dt SCALBN 3
3029bf6af8SDavid Schultz.Os
3129bf6af8SDavid Schultz.Sh NAME
3229bf6af8SDavid Schultz.Nm scalbln ,
3329bf6af8SDavid Schultz.Nm scalblnf ,
34388bf3b6SDavid Schultz.Nm scalblnl ,
3529bf6af8SDavid Schultz.Nm scalbn ,
36388bf3b6SDavid Schultz.Nm scalbnf ,
37388bf3b6SDavid Schultz.Nm scalbnl
3829bf6af8SDavid Schultz.Nd adjust exponent
3929bf6af8SDavid Schultz.Sh LIBRARY
4029bf6af8SDavid Schultz.Lb libm
4129bf6af8SDavid Schultz.Sh SYNOPSIS
4229bf6af8SDavid Schultz.In math.h
4329bf6af8SDavid Schultz.Ft double
4429bf6af8SDavid Schultz.Fn scalbln "double x" "long n"
4529bf6af8SDavid Schultz.Ft float
4629bf6af8SDavid Schultz.Fn scalblnf "float x" "long n"
47388bf3b6SDavid Schultz.Ft long double
48388bf3b6SDavid Schultz.Fn scalblnl "long double x" "long n"
4929bf6af8SDavid Schultz.Ft double
5029bf6af8SDavid Schultz.Fn scalbn "double x" "int n"
5129bf6af8SDavid Schultz.Ft float
5229bf6af8SDavid Schultz.Fn scalbnf "float x" "int n"
53388bf3b6SDavid Schultz.Ft long double
54388bf3b6SDavid Schultz.Fn scalbnl "long double x" "int n"
5529bf6af8SDavid Schultz.Sh DESCRIPTION
56388bf3b6SDavid SchultzThese routines return
5729bf6af8SDavid Schultz.Fa x Ns \(**(2** Ns Fa n )
5829bf6af8SDavid Schultzcomputed by exponent manipulation.
5929bf6af8SDavid Schultz.Sh SEE ALSO
6029bf6af8SDavid Schultz.Xr ieee 3 ,
6129bf6af8SDavid Schultz.Xr math 3
6229bf6af8SDavid Schultz.Sh STANDARDS
6329bf6af8SDavid SchultzThese routines conform to
6429bf6af8SDavid Schultz.St -isoC-99 ,
6529bf6af8SDavid Schultzand they implement the Scalb function recommended by
6629bf6af8SDavid Schultz.St -ieee754 .
6729bf6af8SDavid Schultz.Sh HISTORY
6829bf6af8SDavid SchultzThe
6929bf6af8SDavid Schultz.Fn scalbn
7029bf6af8SDavid Schultzand
7129bf6af8SDavid Schultz.Fn scalbnf
7229bf6af8SDavid Schultzfunctions appeared in
7329bf6af8SDavid Schultz.Bx 4.3
7429bf6af8SDavid Schultzand
7529bf6af8SDavid Schultz.Fx 2.0 ,
7629bf6af8SDavid Schultzrespectively.
7729bf6af8SDavid SchultzThe
7829bf6af8SDavid Schultz.Fn scalbln
7929bf6af8SDavid Schultzand
8029bf6af8SDavid Schultz.Fn scalblnf
8129bf6af8SDavid Schultzfunctions first appeared in
82388bf3b6SDavid Schultz.Fx 5.3 ,
83388bf3b6SDavid Schultzand
84388bf3b6SDavid Schultz.Fn scalblnl
85388bf3b6SDavid Schultzand
86388bf3b6SDavid Schultz.Fn scalbln
87388bf3b6SDavid Schultzin
8819797b22SJoel Dahl.Fx 6.0 .
89