xref: /csrg-svn/lib/libc/gen/ldexp.3 (revision 48901)
1*48901Scael.\" Copyright (c) 1991 The Regents of the University of California.
2*48901Scael.\" All rights reserved.
3*48901Scael.\"
4*48901Scael.\" %sccs.include.redist.man%
5*48901Scael.\"
6*48901Scael.\"     @(#)ldexp.3	5.1 (Berkeley) 05/02/91
7*48901Scael.\"
8*48901Scael.Dd
9*48901Scael.Dt LDEXP 3
10*48901Scael.Os
11*48901Scael.Sh NAME
12*48901Scael.Nm ldexp
13*48901Scael.Nd mutliply floating-point number by integral power of 2
14*48901Scael.Sh SYNOPSIS
15*48901Scael.Fd #include <math.h>
16*48901Scael.Ft double
17*48901Scael.Fn ldexp "double x" "int exp"
18*48901Scael.Sh DESCRIPTION
19*48901ScaelThe
20*48901Scael.Fn ldexp
21*48901Scaelfunction multiplies a floating-point number by an integral
22*48901Scaelpower of 2.
23*48901Scael.Sh RETURN VALUES
24*48901ScaelThe
25*48901Scael.Fn ldexp
26*48901Scaelfunction returns the value of
27*48901Scael.Fa x
28*48901Scaeltimes 2 raised to the power
29*48901Scael.Fa exp .
30*48901Scael.Pp
31*48901ScaelIf the resultant value would cause an overflow,
32*48901Scaelthe global variable
33*48901Scael.Va errno
34*48901Scaelis set to
35*48901Scael.Er ERANGE
36*48901Scaeland the value
37*48901Scael.Dv HUGE
38*48901Scaelis returned.
39*48901Scael.Sh SEE ALSO
40*48901Scael.Xr frexp 3 ,
41*48901Scael.Xr modf 3 ,
42*48901Scael.Xr math 3
43*48901Scael.Sh STANDARDS
44*48901ScaelThe
45*48901Scael.Fn ldexp
46*48901Scaelfunction conforms
47*48901Scael.St -ansiC .
48