OSDN Git Service

38934ae0a41927fc305d8a9decade6893a45abf9
[linuxjm/LDP_man-pages.git] / po4a / math / po / math.pot
1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2013-08-15 19:32+0900\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=CHARSET\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: TH
20 #: build/C/man3/INFINITY.3:25
21 #, no-wrap
22 msgid "INFINITY"
23 msgstr ""
24
25 #. type: TH
26 #: build/C/man3/INFINITY.3:25
27 #, no-wrap
28 msgid "2007-07-26"
29 msgstr ""
30
31 #. type: TH
32 #: build/C/man3/INFINITY.3:25 build/C/man3/abs.3:34 build/C/man3/acos.3:35 build/C/man3/acosh.3:35 build/C/man3/asin.3:35 build/C/man3/asinh.3:35 build/C/man3/atan.3:35 build/C/man3/atan2.3:35 build/C/man3/atanh.3:35 build/C/man3/cbrt.3:30 build/C/man3/ceil.3:27 build/C/man3/copysign.3:31 build/C/man3/cos.3:34 build/C/man3/cosh.3:36 build/C/man3/div.3:34 build/C/man3/erf.3:35 build/C/man3/erfc.3:26 build/C/man3/exp.3:36 build/C/man3/exp10.3:35 build/C/man3/exp2.3:36 build/C/man3/expm1.3:30 build/C/man3/fabs.3:32 build/C/man3/fdim.3:9 build/C/man3/fenv.3:27 build/C/man3/finite.3:25 build/C/man3/floor.3:27 build/C/man3/fma.3:12 build/C/man3/fmax.3:9 build/C/man3/fmin.3:9 build/C/man3/fmod.3:35 build/C/man3/fpclassify.3:10 build/C/man3/frexp.3:33 build/C/man3/gamma.3:9 build/C/man3/hypot.3:33 build/C/man3/ilogb.3:29 build/C/man3/infnan.3:33 build/C/man3/isgreater.3:10 build/C/man3/j0.3:36 build/C/man3/ldexp.3:34 build/C/man3/lgamma.3:11 build/C/man3/log.3:36 build/C/man3/log10.3:36 build/C/man3/log1p.3:29 build/C/man3/log2.3:36 build/C/man3/logb.3:29 build/C/man3/lrint.3:27 build/C/man3/lround.3:27 build/C/man7/math_error.7:26 build/C/man3/matherr.3:27 build/C/man3/modf.3:33 build/C/man3/nan.3:11 build/C/man3/nextafter.3:11 build/C/man3/pow.3:35 build/C/man3/pow10.3:25 build/C/man3/remainder.3:37 build/C/man3/remquo.3:12 build/C/man3/rint.3:27 build/C/man3/round.3:27 build/C/man3/scalb.3:27 build/C/man3/scalbln.3:27 build/C/man3/signbit.3:11 build/C/man3/significand.3:9 build/C/man3/sin.3:35 build/C/man3/sincos.3:9 build/C/man3/sinh.3:36 build/C/man3/sqrt.3:34 build/C/man3/tan.3:35 build/C/man3/tanh.3:35 build/C/man3/tgamma.3:13 build/C/man3/trunc.3:25 build/C/man3/y0.3:36
33 #, no-wrap
34 msgid "Linux Programmer's Manual"
35 msgstr ""
36
37 #. type: SH
38 #: build/C/man3/INFINITY.3:26 build/C/man3/abs.3:35 build/C/man3/acos.3:36 build/C/man3/acosh.3:36 build/C/man3/asin.3:36 build/C/man3/asinh.3:36 build/C/man3/atan.3:36 build/C/man3/atan2.3:36 build/C/man3/atanh.3:36 build/C/man3/cbrt.3:31 build/C/man3/ceil.3:28 build/C/man3/copysign.3:32 build/C/man3/cos.3:35 build/C/man3/cosh.3:37 build/C/man3/div.3:35 build/C/man3/erf.3:36 build/C/man3/erfc.3:27 build/C/man3/exp.3:37 build/C/man3/exp10.3:36 build/C/man3/exp2.3:37 build/C/man3/expm1.3:31 build/C/man3/fabs.3:33 build/C/man3/fdim.3:10 build/C/man3/fenv.3:28 build/C/man3/finite.3:26 build/C/man3/floor.3:28 build/C/man3/fma.3:13 build/C/man3/fmax.3:10 build/C/man3/fmin.3:10 build/C/man3/fmod.3:36 build/C/man3/fpclassify.3:11 build/C/man3/frexp.3:34 build/C/man3/gamma.3:10 build/C/man3/hypot.3:34 build/C/man3/ilogb.3:30 build/C/man3/infnan.3:34 build/C/man3/isgreater.3:11 build/C/man3/j0.3:37 build/C/man3/ldexp.3:35 build/C/man3/lgamma.3:12 build/C/man3/log.3:37 build/C/man3/log10.3:37 build/C/man3/log1p.3:30 build/C/man3/log2.3:37 build/C/man3/logb.3:30 build/C/man3/lrint.3:28 build/C/man3/lround.3:28 build/C/man7/math_error.7:27 build/C/man3/matherr.3:28 build/C/man3/modf.3:34 build/C/man3/nan.3:12 build/C/man3/nextafter.3:12 build/C/man3/pow.3:36 build/C/man3/pow10.3:26 build/C/man3/remainder.3:38 build/C/man3/remquo.3:13 build/C/man3/rint.3:28 build/C/man3/round.3:28 build/C/man3/scalb.3:28 build/C/man3/scalbln.3:28 build/C/man3/signbit.3:12 build/C/man3/significand.3:10 build/C/man3/sin.3:36 build/C/man3/sincos.3:10 build/C/man3/sinh.3:37 build/C/man3/sqrt.3:35 build/C/man3/tan.3:36 build/C/man3/tanh.3:36 build/C/man3/tgamma.3:14 build/C/man3/trunc.3:26 build/C/man3/y0.3:37
39 #, no-wrap
40 msgid "NAME"
41 msgstr ""
42
43 #. type: Plain text
44 #: build/C/man3/INFINITY.3:28
45 msgid "INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL - floating-point constants"
46 msgstr ""
47
48 #. type: SH
49 #: build/C/man3/INFINITY.3:28 build/C/man3/abs.3:37 build/C/man3/acos.3:38 build/C/man3/acosh.3:38 build/C/man3/asin.3:38 build/C/man3/asinh.3:38 build/C/man3/atan.3:38 build/C/man3/atan2.3:38 build/C/man3/atanh.3:38 build/C/man3/cbrt.3:33 build/C/man3/ceil.3:31 build/C/man3/copysign.3:34 build/C/man3/cos.3:37 build/C/man3/cosh.3:39 build/C/man3/div.3:38 build/C/man3/erf.3:38 build/C/man3/erfc.3:29 build/C/man3/exp.3:39 build/C/man3/exp10.3:38 build/C/man3/exp2.3:39 build/C/man3/expm1.3:33 build/C/man3/fabs.3:35 build/C/man3/fdim.3:12 build/C/man3/fenv.3:33 build/C/man3/finite.3:29 build/C/man3/floor.3:30 build/C/man3/fma.3:15 build/C/man3/fmax.3:12 build/C/man3/fmin.3:12 build/C/man3/fmod.3:38 build/C/man3/fpclassify.3:14 build/C/man3/frexp.3:37 build/C/man3/gamma.3:12 build/C/man3/hypot.3:36 build/C/man3/ilogb.3:32 build/C/man3/infnan.3:36 build/C/man3/isgreater.3:14 build/C/man3/j0.3:40 build/C/man3/ldexp.3:37 build/C/man3/lgamma.3:15 build/C/man3/log.3:39 build/C/man3/log10.3:39 build/C/man3/log1p.3:32 build/C/man3/log2.3:39 build/C/man3/logb.3:32 build/C/man3/lrint.3:30 build/C/man3/lround.3:31 build/C/man7/math_error.7:29 build/C/man3/matherr.3:30 build/C/man3/modf.3:37 build/C/man3/nan.3:14 build/C/man3/nextafter.3:15 build/C/man3/pow.3:38 build/C/man3/pow10.3:28 build/C/man3/remainder.3:41 build/C/man3/remquo.3:15 build/C/man3/rint.3:31 build/C/man3/round.3:30 build/C/man3/scalb.3:31 build/C/man3/scalbln.3:31 build/C/man3/signbit.3:14 build/C/man3/significand.3:13 build/C/man3/sin.3:38 build/C/man3/sincos.3:12 build/C/man3/sinh.3:39 build/C/man3/sqrt.3:37 build/C/man3/tan.3:38 build/C/man3/tanh.3:38 build/C/man3/tgamma.3:16 build/C/man3/trunc.3:28 build/C/man3/y0.3:40
50 #, no-wrap
51 msgid "SYNOPSIS"
52 msgstr ""
53
54 #. type: Plain text
55 #: build/C/man3/INFINITY.3:31
56 #, no-wrap
57 msgid "B<#define _ISOC99_SOURCE>      /* See feature_test_macros(7) */\n"
58 msgstr ""
59
60 #. type: Plain text
61 #: build/C/man3/INFINITY.3:33 build/C/man3/acos.3:41 build/C/man3/acosh.3:41 build/C/man3/asin.3:41 build/C/man3/asinh.3:41 build/C/man3/atan.3:41 build/C/man3/atan2.3:41 build/C/man3/atanh.3:41 build/C/man3/cbrt.3:36 build/C/man3/ceil.3:34 build/C/man3/copysign.3:37 build/C/man3/cos.3:40 build/C/man3/cosh.3:42 build/C/man3/erf.3:41 build/C/man3/erfc.3:32 build/C/man3/exp.3:42 build/C/man3/exp10.3:43 build/C/man3/exp2.3:42 build/C/man3/expm1.3:36 build/C/man3/fabs.3:38 build/C/man3/finite.3:32 build/C/man3/floor.3:33 build/C/man3/fma.3:18 build/C/man3/fmod.3:41 build/C/man3/fpclassify.3:17 build/C/man3/frexp.3:40 build/C/man3/hypot.3:39 build/C/man3/infnan.3:39 build/C/man3/isgreater.3:17 build/C/man3/j0.3:43 build/C/man3/ldexp.3:40 build/C/man3/lgamma.3:18 build/C/man3/log.3:42 build/C/man3/log10.3:42 build/C/man3/log1p.3:35 build/C/man3/log2.3:42 build/C/man3/lrint.3:33 build/C/man3/lround.3:34 build/C/man3/modf.3:40 build/C/man3/pow.3:41 build/C/man3/remainder.3:44 build/C/man3/remquo.3:18 build/C/man3/rint.3:34 build/C/man3/round.3:33 build/C/man3/sin.3:41 build/C/man3/sinh.3:42 build/C/man3/sqrt.3:40 build/C/man3/tan.3:41 build/C/man3/tanh.3:41 build/C/man3/trunc.3:31 build/C/man3/y0.3:43
62 #, no-wrap
63 msgid "B<#include E<lt>math.hE<gt>>\n"
64 msgstr ""
65
66 #. type: Plain text
67 #: build/C/man3/INFINITY.3:35
68 #, no-wrap
69 msgid "B<INFINITY>\n"
70 msgstr ""
71
72 #. type: Plain text
73 #: build/C/man3/INFINITY.3:37
74 #, no-wrap
75 msgid "B<NAN>\n"
76 msgstr ""
77
78 #. type: Plain text
79 #: build/C/man3/INFINITY.3:39
80 #, no-wrap
81 msgid "B<HUGE_VAL>\n"
82 msgstr ""
83
84 #. type: Plain text
85 #: build/C/man3/INFINITY.3:41
86 #, no-wrap
87 msgid "B<HUGE_VALF>\n"
88 msgstr ""
89
90 #. type: Plain text
91 #: build/C/man3/INFINITY.3:43
92 #, no-wrap
93 msgid "B<HUGE_VALL>\n"
94 msgstr ""
95
96 #. type: SH
97 #: build/C/man3/INFINITY.3:44 build/C/man3/abs.3:67 build/C/man3/acos.3:65 build/C/man3/acosh.3:77 build/C/man3/asin.3:67 build/C/man3/asinh.3:77 build/C/man3/atan.3:67 build/C/man3/atan2.3:65 build/C/man3/atanh.3:77 build/C/man3/cbrt.3:72 build/C/man3/ceil.3:60 build/C/man3/copysign.3:64 build/C/man3/cos.3:66 build/C/man3/cosh.3:68 build/C/man3/div.3:68 build/C/man3/erf.3:74 build/C/man3/erfc.3:65 build/C/man3/exp.3:68 build/C/man3/exp10.3:52 build/C/man3/exp2.3:68 build/C/man3/expm1.3:72 build/C/man3/fabs.3:64 build/C/man3/fdim.3:39 build/C/man3/fenv.3:61 build/C/man3/finite.3:90 build/C/man3/floor.3:59 build/C/man3/fma.3:45 build/C/man3/fmax.3:40 build/C/man3/fmin.3:40 build/C/man3/fmod.3:67 build/C/man3/fpclassify.3:66 build/C/man3/frexp.3:66 build/C/man3/gamma.3:40 build/C/man3/hypot.3:74 build/C/man3/ilogb.3:70 build/C/man3/infnan.3:44 build/C/man3/isgreater.3:48 build/C/man3/j0.3:89 build/C/man3/ldexp.3:66 build/C/man3/lgamma.3:71 build/C/man3/log.3:68 build/C/man3/log10.3:68 build/C/man3/log1p.3:71 build/C/man3/log2.3:68 build/C/man3/logb.3:69 build/C/man3/lrint.3:64 build/C/man3/lround.3:65 build/C/man7/math_error.7:35 build/C/man3/matherr.3:41 build/C/man3/modf.3:66 build/C/man3/nan.3:42 build/C/man3/nextafter.3:70 build/C/man3/pow.3:67 build/C/man3/pow10.3:41 build/C/man3/remainder.3:92 build/C/man3/remquo.3:45 build/C/man3/rint.3:86 build/C/man3/round.3:60 build/C/man3/scalb.3:60 build/C/man3/scalbln.3:76 build/C/man3/signbit.3:36 build/C/man3/significand.3:37 build/C/man3/sin.3:67 build/C/man3/sincos.3:25 build/C/man3/sinh.3:68 build/C/man3/sqrt.3:66 build/C/man3/tan.3:67 build/C/man3/tanh.3:67 build/C/man3/tgamma.3:44 build/C/man3/trunc.3:58 build/C/man3/y0.3:89
98 #, no-wrap
99 msgid "DESCRIPTION"
100 msgstr ""
101
102 #. type: Plain text
103 #: build/C/man3/INFINITY.3:50
104 msgid ""
105 "The macro B<INFINITY> expands to a I<float> constant representing positive "
106 "infinity."
107 msgstr ""
108
109 #. type: Plain text
110 #: build/C/man3/INFINITY.3:65
111 msgid ""
112 "The macro B<NAN> expands to a I<float> constant representing a quiet NaN "
113 "(when supported).  A I<quiet> NaN is a NaN (\"not-a-number\") that does not "
114 "raise exceptions when it is used in arithmetic.  The opposite is a "
115 "I<signaling> NaN.  See IEC 60559:1989."
116 msgstr ""
117
118 #. type: Plain text
119 #: build/C/man3/INFINITY.3:77
120 msgid ""
121 "The macros B<HUGE_VAL>, B<HUGE_VALF>, B<HUGE_VALL> expand to constants of "
122 "types I<double>, I<float> and I<long double>, respectively, that represent a "
123 "large positive value, possibly plus infinity."
124 msgstr ""
125
126 #. type: SH
127 #: build/C/man3/INFINITY.3:77 build/C/man3/abs.3:91 build/C/man3/acos.3:113 build/C/man3/acosh.3:120 build/C/man3/asin.3:111 build/C/man3/asinh.3:105 build/C/man3/atan.3:96 build/C/man3/atan2.3:166 build/C/man3/atanh.3:139 build/C/man3/cbrt.3:90 build/C/man3/ceil.3:89 build/C/man3/copysign.3:92 build/C/man3/cos.3:104 build/C/man3/cosh.3:119 build/C/man3/div.3:100 build/C/man3/erf.3:126 build/C/man3/erfc.3:122 build/C/man3/exp.3:128 build/C/man3/exp10.3:77 build/C/man3/exp2.3:91 build/C/man3/expm1.3:136 build/C/man3/fabs.3:93 build/C/man3/fdim.3:89 build/C/man3/fenv.3:265 build/C/man3/floor.3:88 build/C/man3/fma.3:156 build/C/man3/fmax.3:58 build/C/man3/fmin.3:58 build/C/man3/fmod.3:146 build/C/man3/fpclassify.3:118 build/C/man3/frexp.3:108 build/C/man3/gamma.3:65 build/C/man3/hypot.3:158 build/C/man3/ilogb.3:146 build/C/man3/infnan.3:87 build/C/man3/isgreater.3:125 build/C/man3/j0.3:150 build/C/man3/ldexp.3:129 build/C/man3/lgamma.3:156 build/C/man3/log.3:128 build/C/man3/log10.3:89 build/C/man3/log1p.3:142 build/C/man3/log2.3:91 build/C/man3/logb.3:143 build/C/man3/lrint.3:109 build/C/man3/lround.3:112 build/C/man3/modf.3:103 build/C/man3/nan.3:75 build/C/man3/nextafter.3:173 build/C/man3/pow.3:316 build/C/man3/pow10.3:49 build/C/man3/remainder.3:180 build/C/man3/remquo.3:124 build/C/man3/rint.3:116 build/C/man3/round.3:96 build/C/man3/scalb.3:177 build/C/man3/scalbln.3:171 build/C/man3/signbit.3:66 build/C/man3/significand.3:51 build/C/man3/sin.3:108 build/C/man3/sincos.3:75 build/C/man3/sinh.3:124 build/C/man3/sqrt.3:107 build/C/man3/tan.3:133 build/C/man3/tanh.3:100 build/C/man3/tgamma.3:162 build/C/man3/trunc.3:83 build/C/man3/y0.3:223
128 #, no-wrap
129 msgid "CONFORMING TO"
130 msgstr ""
131
132 #. type: Plain text
133 #: build/C/man3/INFINITY.3:79
134 msgid "C99."
135 msgstr ""
136
137 #. type: SH
138 #: build/C/man3/INFINITY.3:79
139 #, no-wrap
140 msgid "AVAILABILITY"
141 msgstr ""
142
143 #. type: Plain text
144 #: build/C/man3/INFINITY.3:101
145 msgid ""
146 "On a glibc system, the macro B<HUGE_VAL> is always available.  Availability "
147 "of the B<NAN> macro can be tested using B<#ifdef NAN>, and similarly for "
148 "B<INFINITY>, B<HUGE_VALF>, B<HUGE_VALL>.  They will be defined by "
149 "I<E<lt>math.hE<gt>> if B<_ISOC99_SOURCE> or B<_GNU_SOURCE> is defined, or "
150 "B<__STDC_VERSION__> is defined and has a value not less than 199901L."
151 msgstr ""
152
153 #. type: SH
154 #: build/C/man3/INFINITY.3:101 build/C/man3/abs.3:135 build/C/man3/acos.3:119 build/C/man3/acosh.3:126 build/C/man3/asin.3:117 build/C/man3/asinh.3:111 build/C/man3/atan.3:102 build/C/man3/atan2.3:172 build/C/man3/atanh.3:156 build/C/man3/cbrt.3:94 build/C/man3/ceil.3:120 build/C/man3/copysign.3:102 build/C/man3/cos.3:117 build/C/man3/cosh.3:130 build/C/man3/div.3:115 build/C/man3/erf.3:132 build/C/man3/erfc.3:135 build/C/man3/exp.3:134 build/C/man3/exp10.3:79 build/C/man3/exp2.3:97 build/C/man3/expm1.3:170 build/C/man3/fabs.3:99 build/C/man3/fdim.3:91 build/C/man3/fenv.3:323 build/C/man3/finite.3:155 build/C/man3/floor.3:110 build/C/man3/fma.3:158 build/C/man3/fmax.3:60 build/C/man3/fmin.3:60 build/C/man3/fmod.3:160 build/C/man3/fpclassify.3:132 build/C/man3/frexp.3:147 build/C/man3/gamma.3:97 build/C/man3/hypot.3:164 build/C/man3/ilogb.3:148 build/C/man3/isgreater.3:132 build/C/man3/j0.3:165 build/C/man3/ldexp.3:135 build/C/man3/lgamma.3:175 build/C/man3/log.3:141 build/C/man3/log10.3:95 build/C/man3/log1p.3:145 build/C/man3/log2.3:97 build/C/man3/logb.3:145 build/C/man3/lrint.3:111 build/C/man3/lround.3:114 build/C/man7/math_error.7:256 build/C/man3/matherr.3:425 build/C/man3/modf.3:109 build/C/man3/nan.3:79 build/C/man3/nextafter.3:182 build/C/man3/pow.3:365 build/C/man3/pow10.3:54 build/C/man3/remainder.3:215 build/C/man3/remquo.3:126 build/C/man3/rint.3:138 build/C/man3/round.3:119 build/C/man3/scalb.3:200 build/C/man3/scalbln.3:189 build/C/man3/signbit.3:70 build/C/man3/significand.3:57 build/C/man3/sin.3:121 build/C/man3/sincos.3:77 build/C/man3/sinh.3:130 build/C/man3/sqrt.3:113 build/C/man3/tan.3:146 build/C/man3/tanh.3:106 build/C/man3/tgamma.3:188 build/C/man3/trunc.3:94 build/C/man3/y0.3:246
155 #, no-wrap
156 msgid "SEE ALSO"
157 msgstr ""
158
159 #. type: Plain text
160 #: build/C/man3/INFINITY.3:104
161 msgid "B<fpclassify>(3), B<math_error>(7)"
162 msgstr ""
163
164 #. type: SH
165 #: build/C/man3/INFINITY.3:104 build/C/man3/abs.3:141 build/C/man3/acos.3:127 build/C/man3/acosh.3:133 build/C/man3/asin.3:125 build/C/man3/asinh.3:118 build/C/man3/atan.3:111 build/C/man3/atan2.3:180 build/C/man3/atanh.3:163 build/C/man3/cbrt.3:97 build/C/man3/ceil.3:127 build/C/man3/copysign.3:104 build/C/man3/cos.3:126 build/C/man3/cosh.3:137 build/C/man3/div.3:118 build/C/man3/erf.3:136 build/C/man3/erfc.3:139 build/C/man3/exp.3:140 build/C/man3/exp10.3:85 build/C/man3/exp2.3:103 build/C/man3/expm1.3:174 build/C/man3/fabs.3:106 build/C/man3/fdim.3:93 build/C/man3/fenv.3:325 build/C/man3/finite.3:157 build/C/man3/floor.3:117 build/C/man3/fma.3:161 build/C/man3/fmax.3:62 build/C/man3/fmin.3:62 build/C/man3/fmod.3:162 build/C/man3/fpclassify.3:137 build/C/man3/frexp.3:150 build/C/man3/gamma.3:101 build/C/man3/hypot.3:167 build/C/man3/ilogb.3:152 build/C/man3/infnan.3:92 build/C/man3/isgreater.3:135 build/C/man3/j0.3:167 build/C/man3/ldexp.3:139 build/C/man3/lgamma.3:177 build/C/man3/log.3:148 build/C/man3/log10.3:102 build/C/man3/log1p.3:149 build/C/man3/log2.3:103 build/C/man3/logb.3:148 build/C/man3/lrint.3:118 build/C/man3/lround.3:121 build/C/man7/math_error.7:267 build/C/man3/matherr.3:429 build/C/man3/modf.3:112 build/C/man3/nan.3:83 build/C/man3/nextafter.3:184 build/C/man3/pow.3:369 build/C/man3/pow10.3:57 build/C/man3/remainder.3:219 build/C/man3/remquo.3:130 build/C/man3/rint.3:144 build/C/man3/round.3:126 build/C/man3/scalb.3:203 build/C/man3/scalbln.3:192 build/C/man3/signbit.3:72 build/C/man3/significand.3:60 build/C/man3/sin.3:130 build/C/man3/sincos.3:81 build/C/man3/sinh.3:137 build/C/man3/sqrt.3:117 build/C/man3/tan.3:154 build/C/man3/tanh.3:113 build/C/man3/tgamma.3:191 build/C/man3/trunc.3:101 build/C/man3/y0.3:248
166 #, no-wrap
167 msgid "COLOPHON"
168 msgstr ""
169
170 #. type: Plain text
171 #: build/C/man3/INFINITY.3:111 build/C/man3/abs.3:148 build/C/man3/acos.3:134 build/C/man3/acosh.3:140 build/C/man3/asin.3:132 build/C/man3/asinh.3:125 build/C/man3/atan.3:118 build/C/man3/atan2.3:187 build/C/man3/atanh.3:170 build/C/man3/cbrt.3:104 build/C/man3/ceil.3:134 build/C/man3/copysign.3:111 build/C/man3/cos.3:133 build/C/man3/cosh.3:144 build/C/man3/div.3:125 build/C/man3/erf.3:143 build/C/man3/erfc.3:146 build/C/man3/exp.3:147 build/C/man3/exp10.3:92 build/C/man3/exp2.3:110 build/C/man3/expm1.3:181 build/C/man3/fabs.3:113 build/C/man3/fdim.3:100 build/C/man3/fenv.3:332 build/C/man3/finite.3:164 build/C/man3/floor.3:124 build/C/man3/fma.3:168 build/C/man3/fmax.3:69 build/C/man3/fmin.3:69 build/C/man3/fmod.3:169 build/C/man3/fpclassify.3:144 build/C/man3/frexp.3:157 build/C/man3/gamma.3:108 build/C/man3/hypot.3:174 build/C/man3/ilogb.3:159 build/C/man3/infnan.3:99 build/C/man3/isgreater.3:142 build/C/man3/j0.3:174 build/C/man3/ldexp.3:146 build/C/man3/lgamma.3:184 build/C/man3/log.3:155 build/C/man3/log10.3:109 build/C/man3/log1p.3:156 build/C/man3/log2.3:110 build/C/man3/logb.3:155 build/C/man3/lrint.3:125 build/C/man3/lround.3:128 build/C/man7/math_error.7:274 build/C/man3/matherr.3:436 build/C/man3/modf.3:119 build/C/man3/nan.3:90 build/C/man3/nextafter.3:191 build/C/man3/pow.3:376 build/C/man3/pow10.3:64 build/C/man3/remainder.3:226 build/C/man3/remquo.3:137 build/C/man3/rint.3:151 build/C/man3/round.3:133 build/C/man3/scalb.3:210 build/C/man3/scalbln.3:199 build/C/man3/signbit.3:79 build/C/man3/significand.3:67 build/C/man3/sin.3:137 build/C/man3/sincos.3:88 build/C/man3/sinh.3:144 build/C/man3/sqrt.3:124 build/C/man3/tan.3:161 build/C/man3/tanh.3:120 build/C/man3/tgamma.3:198 build/C/man3/trunc.3:108 build/C/man3/y0.3:255
172 msgid ""
173 "This page is part of release 3.53 of the Linux I<man-pages> project.  A "
174 "description of the project, and information about reporting bugs, can be "
175 "found at \\%http://www.kernel.org/doc/man-pages/."
176 msgstr ""
177
178 #. type: TH
179 #: build/C/man3/abs.3:34
180 #, no-wrap
181 msgid "ABS"
182 msgstr ""
183
184 #. type: TH
185 #: build/C/man3/abs.3:34 build/C/man3/ceil.3:27 build/C/man3/modf.3:33 build/C/man3/round.3:27 build/C/man3/scalbln.3:27 build/C/man3/trunc.3:25
186 #, no-wrap
187 msgid "2013-06-21"
188 msgstr ""
189
190 #. type: TH
191 #: build/C/man3/abs.3:34 build/C/man3/asinh.3:35 build/C/man3/cbrt.3:30 build/C/man3/copysign.3:31 build/C/man3/erf.3:35 build/C/man3/erfc.3:26 build/C/man3/exp10.3:35 build/C/man3/gamma.3:9 build/C/man3/infnan.3:33 build/C/man3/nan.3:11 build/C/man3/nextafter.3:11 build/C/man3/remquo.3:12 build/C/man3/signbit.3:11 build/C/man3/significand.3:9 build/C/man3/sincos.3:9 build/C/man3/tgamma.3:13
192 #, no-wrap
193 msgid "GNU"
194 msgstr ""
195
196 #. type: Plain text
197 #: build/C/man3/abs.3:37
198 msgid "abs, labs, llabs, imaxabs - compute the absolute value of an integer"
199 msgstr ""
200
201 #. type: Plain text
202 #: build/C/man3/abs.3:40 build/C/man3/div.3:41
203 #, no-wrap
204 msgid "B<#include E<lt>stdlib.hE<gt>>\n"
205 msgstr ""
206
207 #. type: Plain text
208 #: build/C/man3/abs.3:42
209 #, no-wrap
210 msgid "B<int abs(int >I<j>B<);>\n"
211 msgstr ""
212
213 #. type: Plain text
214 #: build/C/man3/abs.3:44
215 #, no-wrap
216 msgid "B<long int labs(long int >I<j>B<);>\n"
217 msgstr ""
218
219 #. type: Plain text
220 #: build/C/man3/abs.3:46
221 #, no-wrap
222 msgid "B<long long int llabs(long long int >I<j>B<);>\n"
223 msgstr ""
224
225 #. type: Plain text
226 #: build/C/man3/abs.3:48 build/C/man3/div.3:49
227 #, no-wrap
228 msgid "B<#include E<lt>inttypes.hE<gt>>\n"
229 msgstr ""
230
231 #. type: Plain text
232 #: build/C/man3/abs.3:50
233 #, no-wrap
234 msgid "B<intmax_t imaxabs(intmax_t >I<j>B<);>\n"
235 msgstr ""
236
237 #. type: Plain text
238 #: build/C/man3/abs.3:55 build/C/man3/acos.3:52 build/C/man3/acosh.3:54 build/C/man3/asin.3:54 build/C/man3/asinh.3:54 build/C/man3/atan.3:54 build/C/man3/atan2.3:52 build/C/man3/atanh.3:54 build/C/man3/cbrt.3:49 build/C/man3/ceil.3:47 build/C/man3/copysign.3:50 build/C/man3/cos.3:53 build/C/man3/cosh.3:55 build/C/man3/div.3:56 build/C/man3/erf.3:52 build/C/man3/erfc.3:43 build/C/man3/exp.3:55 build/C/man3/exp2.3:55 build/C/man3/expm1.3:49 build/C/man3/fabs.3:51 build/C/man3/fdim.3:26 build/C/man3/finite.3:55 build/C/man3/floor.3:46 build/C/man3/fma.3:31 build/C/man3/fmax.3:26 build/C/man3/fmin.3:26 build/C/man3/fmod.3:54 build/C/man3/fpclassify.3:34 build/C/man3/frexp.3:53 build/C/man3/gamma.3:26 build/C/man3/hypot.3:52 build/C/man3/ilogb.3:46 build/C/man3/isgreater.3:36 build/C/man3/j0.3:68 build/C/man3/ldexp.3:53 build/C/man3/lgamma.3:39 build/C/man3/log.3:55 build/C/man3/log10.3:55 build/C/man3/log1p.3:48 build/C/man3/log2.3:55 build/C/man3/logb.3:46 build/C/man3/lrint.3:52 build/C/man3/lround.3:53 build/C/man3/modf.3:53 build/C/man3/nan.3:28 build/C/man3/nextafter.3:35 build/C/man3/pow.3:54 build/C/man3/remainder.3:61 build/C/man3/remquo.3:31 build/C/man3/rint.3:53 build/C/man3/round.3:46 build/C/man3/scalb.3:45 build/C/man3/scalbln.3:51 build/C/man3/signbit.3:24 build/C/man3/significand.3:27 build/C/man3/sin.3:54 build/C/man3/sinh.3:55 build/C/man3/sqrt.3:53 build/C/man3/tan.3:54 build/C/man3/tanh.3:54 build/C/man3/tgamma.3:30 build/C/man3/trunc.3:44 build/C/man3/y0.3:68
239 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
240 msgstr ""
241
242 #. type: Plain text
243 #: build/C/man3/abs.3:59
244 msgid "B<llabs>():"
245 msgstr ""
246
247 #. type: Plain text
248 #: build/C/man3/abs.3:62 build/C/man3/div.3:63 build/C/man3/exp2.3:63 build/C/man3/fdim.3:34 build/C/man3/fma.3:40 build/C/man3/fmax.3:35 build/C/man3/fmin.3:35 build/C/man3/fpclassify.3:45 build/C/man3/isgreater.3:43 build/C/man3/log2.3:63 build/C/man3/lrint.3:59 build/C/man3/lround.3:60 build/C/man3/nan.3:37 build/C/man3/nextafter.3:65 build/C/man3/remquo.3:40 build/C/man3/round.3:55 build/C/man3/scalbln.3:60 build/C/man3/signbit.3:31 build/C/man3/tgamma.3:39 build/C/man3/trunc.3:53
249 msgid ""
250 "_XOPEN_SOURCE\\ E<gt>=\\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ "
251 "200112L;"
252 msgstr ""
253
254 #. type: Plain text
255 #: build/C/man3/abs.3:65 build/C/man3/acos.3:63 build/C/man3/acosh.3:65 build/C/man3/acosh.3:75 build/C/man3/asin.3:65 build/C/man3/asinh.3:65 build/C/man3/asinh.3:75 build/C/man3/atan.3:65 build/C/man3/atan2.3:63 build/C/man3/atanh.3:65 build/C/man3/atanh.3:75 build/C/man3/cbrt.3:61 build/C/man3/cbrt.3:70 build/C/man3/ceil.3:58 build/C/man3/copysign.3:62 build/C/man3/cos.3:64 build/C/man3/cosh.3:66 build/C/man3/div.3:66 build/C/man3/erf.3:62 build/C/man3/erf.3:72 build/C/man3/erfc.3:53 build/C/man3/erfc.3:63 build/C/man3/exp.3:66 build/C/man3/exp2.3:66 build/C/man3/expm1.3:60 build/C/man3/expm1.3:70 build/C/man3/fabs.3:62 build/C/man3/fdim.3:37 build/C/man3/finite.3:70 build/C/man3/finite.3:83 build/C/man3/floor.3:57 build/C/man3/fma.3:43 build/C/man3/fmax.3:38 build/C/man3/fmin.3:38 build/C/man3/fmod.3:65 build/C/man3/fpclassify.3:48 build/C/man3/fpclassify.3:56 build/C/man3/fpclassify.3:64 build/C/man3/frexp.3:64 build/C/man3/hypot.3:62 build/C/man3/hypot.3:72 build/C/man3/ilogb.3:58 build/C/man3/ilogb.3:68 build/C/man3/isgreater.3:46 build/C/man3/ldexp.3:64 build/C/man3/lgamma.3:49 build/C/man3/lgamma.3:59 build/C/man3/log.3:66 build/C/man3/log10.3:66 build/C/man3/log1p.3:59 build/C/man3/log1p.3:69 build/C/man3/log2.3:66 build/C/man3/logb.3:57 build/C/man3/logb.3:67 build/C/man3/lrint.3:62 build/C/man3/lround.3:63 build/C/man3/modf.3:64 build/C/man3/nan.3:40 build/C/man3/nextafter.3:47 build/C/man3/nextafter.3:57 build/C/man3/nextafter.3:68 build/C/man3/pow.3:65 build/C/man3/remainder.3:73 build/C/man3/remainder.3:83 build/C/man3/remquo.3:43 build/C/man3/rint.3:64 build/C/man3/rint.3:74 build/C/man3/rint.3:84 build/C/man3/round.3:58 build/C/man3/scalbln.3:63 build/C/man3/scalbln.3:74 build/C/man3/signbit.3:34 build/C/man3/sin.3:65 build/C/man3/sinh.3:66 build/C/man3/sqrt.3:64 build/C/man3/tan.3:65 build/C/man3/tanh.3:65 build/C/man3/tgamma.3:42 build/C/man3/trunc.3:56
256 msgid "or I<cc\\ -std=c99>"
257 msgstr ""
258
259 #. type: Plain text
260 #: build/C/man3/abs.3:79
261 msgid ""
262 "The B<abs>()  function computes the absolute value of the integer argument "
263 "I<j>.  The B<labs>(), B<llabs>()  and B<imaxabs>()  functions compute the "
264 "absolute value of the argument I<j> of the appropriate integer type for the "
265 "function."
266 msgstr ""
267
268 #. type: SH
269 #: build/C/man3/abs.3:79 build/C/man3/acos.3:73 build/C/man3/acosh.3:84 build/C/man3/asin.3:74 build/C/man3/asinh.3:84 build/C/man3/atan.3:74 build/C/man3/atan2.3:72 build/C/man3/atanh.3:84 build/C/man3/cbrt.3:79 build/C/man3/ceil.3:69 build/C/man3/copysign.3:78 build/C/man3/cos.3:75 build/C/man3/cosh.3:79 build/C/man3/div.3:89 build/C/man3/erf.3:83 build/C/man3/erfc.3:71 build/C/man3/exp.3:74 build/C/man3/exp10.3:58 build/C/man3/exp2.3:74 build/C/man3/expm1.3:88 build/C/man3/fabs.3:68 build/C/man3/fdim.3:42 build/C/man3/fenv.3:258 build/C/man3/floor.3:68 build/C/man3/fma.3:53 build/C/man3/fmax.3:45 build/C/man3/fmin.3:45 build/C/man3/fmod.3:87 build/C/man3/frexp.3:74 build/C/man3/gamma.3:59 build/C/man3/hypot.3:92 build/C/man3/ilogb.3:78 build/C/man3/infnan.3:56 build/C/man3/isgreater.3:111 build/C/man3/j0.3:114 build/C/man3/ldexp.3:73 build/C/man3/lgamma.3:94 build/C/man3/log.3:73 build/C/man3/log10.3:73 build/C/man3/log1p.3:83 build/C/man3/log2.3:73 build/C/man3/logb.3:94 build/C/man3/lrint.3:73 build/C/man3/lround.3:76 build/C/man3/modf.3:76 build/C/man3/nextafter.3:98 build/C/man3/pow.3:75 build/C/man3/remainder.3:118 build/C/man3/remquo.3:73 build/C/man3/rint.3:105 build/C/man3/round.3:75 build/C/man3/scalb.3:79 build/C/man3/scalbln.3:95 build/C/man3/signbit.3:53 build/C/man3/sin.3:76 build/C/man3/sincos.3:49 build/C/man3/sinh.3:79 build/C/man3/sqrt.3:71 build/C/man3/tan.3:76 build/C/man3/tanh.3:78 build/C/man3/tgamma.3:67 build/C/man3/trunc.3:63 build/C/man3/y0.3:119
270 #, no-wrap
271 msgid "RETURN VALUE"
272 msgstr ""
273
274 #. type: Plain text
275 #: build/C/man3/abs.3:82
276 msgid ""
277 "Returns the absolute value of the integer argument, of the appropriate "
278 "integer type for the function."
279 msgstr ""
280
281 #. type: SH
282 #: build/C/man3/abs.3:82 build/C/man3/ceil.3:81 build/C/man3/div.3:91 build/C/man3/fabs.3:85 build/C/man3/fdim.3:81 build/C/man3/finite.3:121 build/C/man3/floor.3:80 build/C/man3/modf.3:95 build/C/man3/round.3:88 build/C/man3/scalbln.3:160 build/C/man3/signbit.3:61 build/C/man3/trunc.3:75
283 #, no-wrap
284 msgid "ATTRIBUTES"
285 msgstr ""
286
287 #. type: SS
288 #: build/C/man3/abs.3:83 build/C/man3/ceil.3:82 build/C/man3/div.3:92 build/C/man3/fabs.3:86 build/C/man3/fdim.3:82 build/C/man3/finite.3:122 build/C/man3/floor.3:81 build/C/man3/modf.3:96 build/C/man3/round.3:89 build/C/man3/scalbln.3:161 build/C/man3/signbit.3:62 build/C/man3/trunc.3:76
289 #, no-wrap
290 msgid "Multithreading (see pthreads(7))"
291 msgstr ""
292
293 #. type: Plain text
294 #: build/C/man3/abs.3:91
295 msgid ""
296 "The B<abs>(), B<labs>(), B<llabs>(), and B<imaxabs>()  functions are "
297 "thread-safe."
298 msgstr ""
299
300 #.  POSIX.1 (1996 edition) requires only the
301 #.  .BR abs ()
302 #.  function.
303 #. type: Plain text
304 #: build/C/man3/abs.3:106
305 msgid ""
306 "SVr4, POSIX.1-2001, 4.3BSD, C99.  C89 only includes the B<abs>()  and "
307 "B<labs>()  functions; the functions B<llabs>()  and B<imaxabs>()  were added "
308 "in C99."
309 msgstr ""
310
311 #. type: SH
312 #: build/C/man3/abs.3:106 build/C/man3/ceil.3:95 build/C/man3/copysign.3:97 build/C/man3/erfc.3:128 build/C/man3/fenv.3:267 build/C/man3/finite.3:135 build/C/man3/floor.3:94 build/C/man3/fpclassify.3:125 build/C/man3/gamma.3:68 build/C/man3/infnan.3:89 build/C/man3/isgreater.3:127 build/C/man7/math_error.7:187 build/C/man3/pow10.3:51 build/C/man3/rint.3:118 build/C/man3/round.3:98 build/C/man3/scalbln.3:173 build/C/man3/tgamma.3:164 build/C/man3/trunc.3:85
313 #, no-wrap
314 msgid "NOTES"
315 msgstr ""
316
317 #. type: Plain text
318 #: build/C/man3/abs.3:109
319 msgid ""
320 "Trying to take the absolute value of the most negative integer is not "
321 "defined."
322 msgstr ""
323
324 #. type: Plain text
325 #: build/C/man3/abs.3:118
326 msgid ""
327 "The B<llabs>()  function is included in glibc since version 2.0, but is not "
328 "in libc5 or libc4.  The B<imaxabs>()  function is included in glibc since "
329 "version 2.1.1."
330 msgstr ""
331
332 #. type: Plain text
333 #: build/C/man3/abs.3:124
334 msgid ""
335 "For B<llabs>()  to be declared, it may be necessary to define "
336 "B<_ISOC99_SOURCE> or B<_ISOC9X_SOURCE> (depending on the version of glibc) "
337 "before including any standard headers."
338 msgstr ""
339
340 #. type: Plain text
341 #: build/C/man3/abs.3:135
342 msgid ""
343 "GCC handles B<abs>()  and B<labs>()  as built-in functions.  GCC 3.0 also "
344 "handles B<llabs>()  and B<imaxabs>()  as built-ins."
345 msgstr ""
346
347 #. type: Plain text
348 #: build/C/man3/abs.3:141
349 msgid "B<cabs>(3), B<ceil>(3), B<fabs>(3), B<floor>(3), B<rint>(3)"
350 msgstr ""
351
352 #. type: TH
353 #: build/C/man3/acos.3:35
354 #, no-wrap
355 msgid "ACOS"
356 msgstr ""
357
358 #. type: TH
359 #: build/C/man3/acos.3:35 build/C/man3/acosh.3:35 build/C/man3/asin.3:35 build/C/man3/asinh.3:35 build/C/man3/atan.3:35 build/C/man3/atan2.3:35 build/C/man3/cbrt.3:30 build/C/man3/cosh.3:36 build/C/man3/erf.3:35 build/C/man3/erfc.3:26 build/C/man3/exp.3:36 build/C/man3/exp2.3:36 build/C/man3/fma.3:12 build/C/man3/fmax.3:9 build/C/man3/fmin.3:9 build/C/man3/fpclassify.3:10 build/C/man3/frexp.3:33 build/C/man3/hypot.3:33 build/C/man3/ilogb.3:29 build/C/man3/j0.3:36 build/C/man3/ldexp.3:34 build/C/man3/log.3:36 build/C/man3/log10.3:36 build/C/man3/log1p.3:29 build/C/man3/logb.3:29 build/C/man3/lrint.3:27 build/C/man3/lround.3:27 build/C/man3/nan.3:11 build/C/man3/nextafter.3:11 build/C/man3/remainder.3:37 build/C/man3/remquo.3:12 build/C/man3/rint.3:27 build/C/man3/sinh.3:36 build/C/man3/sqrt.3:34 build/C/man3/tanh.3:35 build/C/man3/tgamma.3:13
360 #, no-wrap
361 msgid "2010-09-20"
362 msgstr ""
363
364 #. type: Plain text
365 #: build/C/man3/acos.3:38
366 msgid "acos, acosf, acosl - arc cosine function"
367 msgstr ""
368
369 #. type: Plain text
370 #: build/C/man3/acos.3:45
371 #, no-wrap
372 msgid ""
373 "B<double acos(double >I<x>B<);>\n"
374 "B<float acosf(float >I<x>B<);>\n"
375 "B<long double acosl(long double >I<x>B<);>\n"
376 msgstr ""
377
378 #. type: Plain text
379 #: build/C/man3/acos.3:48 build/C/man3/acosh.3:50 build/C/man3/asin.3:50 build/C/man3/asinh.3:50 build/C/man3/atan.3:50 build/C/man3/atan2.3:48 build/C/man3/atanh.3:50 build/C/man3/cbrt.3:45 build/C/man3/ceil.3:43 build/C/man3/copysign.3:46 build/C/man3/cos.3:49 build/C/man3/cosh.3:51 build/C/man3/erf.3:48 build/C/man3/erfc.3:39 build/C/man3/exp.3:51 build/C/man3/exp10.3:52 build/C/man3/exp2.3:51 build/C/man3/expm1.3:45 build/C/man3/fabs.3:47 build/C/man3/fdim.3:22 build/C/man3/fenv.3:61 build/C/man3/floor.3:42 build/C/man3/fma.3:27 build/C/man3/fmax.3:22 build/C/man3/fmin.3:22 build/C/man3/fmod.3:50 build/C/man3/fpclassify.3:30 build/C/man3/frexp.3:49 build/C/man3/gamma.3:22 build/C/man3/hypot.3:48 build/C/man3/ilogb.3:42 build/C/man3/infnan.3:44 build/C/man3/isgreater.3:32 build/C/man3/j0.3:64 build/C/man3/ldexp.3:49 build/C/man3/lgamma.3:35 build/C/man3/log.3:51 build/C/man3/log10.3:51 build/C/man3/log1p.3:44 build/C/man3/log2.3:51 build/C/man3/logb.3:42 build/C/man3/lrint.3:48 build/C/man3/lround.3:49 build/C/man3/matherr.3:41 build/C/man3/modf.3:49 build/C/man3/nan.3:24 build/C/man3/nextafter.3:31 build/C/man3/pow.3:50 build/C/man3/pow10.3:41 build/C/man3/remainder.3:57 build/C/man3/remquo.3:27 build/C/man3/rint.3:49 build/C/man3/round.3:42 build/C/man3/scalb.3:41 build/C/man3/scalbln.3:47 build/C/man3/signbit.3:20 build/C/man3/significand.3:23 build/C/man3/sin.3:50 build/C/man3/sincos.3:25 build/C/man3/sinh.3:51 build/C/man3/sqrt.3:49 build/C/man3/tan.3:50 build/C/man3/tanh.3:50 build/C/man3/tgamma.3:26 build/C/man3/trunc.3:40 build/C/man3/y0.3:64
380 msgid "Link with I<-lm>."
381 msgstr ""
382
383 #. type: Plain text
384 #: build/C/man3/acos.3:57
385 msgid "B<acosf>(), B<acosl>():"
386 msgstr ""
387
388 #. type: Plain text
389 #: build/C/man3/acos.3:60 build/C/man3/acosh.3:72 build/C/man3/asin.3:62 build/C/man3/asinh.3:72 build/C/man3/atan.3:62 build/C/man3/atan2.3:60 build/C/man3/atanh.3:72 build/C/man3/ceil.3:55 build/C/man3/cos.3:61 build/C/man3/cosh.3:63 build/C/man3/erf.3:69 build/C/man3/exp.3:63 build/C/man3/expm1.3:67 build/C/man3/fabs.3:59 build/C/man3/floor.3:54 build/C/man3/fmod.3:62 build/C/man3/fpclassify.3:61 build/C/man3/frexp.3:61 build/C/man3/hypot.3:69 build/C/man3/ilogb.3:65 build/C/man3/ldexp.3:61 build/C/man3/lgamma.3:56 build/C/man3/log.3:63 build/C/man3/log10.3:63 build/C/man3/log1p.3:66 build/C/man3/logb.3:64 build/C/man3/modf.3:61 build/C/man3/nextafter.3:54 build/C/man3/pow.3:62 build/C/man3/remainder.3:80 build/C/man3/rint.3:81 build/C/man3/scalbln.3:71 build/C/man3/sin.3:62 build/C/man3/sinh.3:63 build/C/man3/sqrt.3:61 build/C/man3/tan.3:62 build/C/man3/tanh.3:62
390 msgid ""
391 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
392 "_ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
393 msgstr ""
394
395 #. type: Plain text
396 #: build/C/man3/acos.3:73
397 msgid ""
398 "The B<acos>()  function calculates the arc cosine of I<x>; that is the value "
399 "whose cosine is I<x>."
400 msgstr ""
401
402 #. type: Plain text
403 #: build/C/man3/acos.3:77
404 msgid ""
405 "On success, these functions return the arc cosine of I<x> in radians; the "
406 "return value is in the range [0,\\ pi]."
407 msgstr ""
408
409 #. type: Plain text
410 #: build/C/man3/acos.3:81 build/C/man3/acosh.3:91 build/C/man3/asin.3:82 build/C/man3/asinh.3:91 build/C/man3/atan.3:82 build/C/man3/atanh.3:91 build/C/man3/cos.3:82 build/C/man3/cosh.3:86 build/C/man3/erf.3:91 build/C/man3/erfc.3:79 build/C/man3/exp.3:82 build/C/man3/expm1.3:96 build/C/man3/fabs.3:75 build/C/man3/j0.3:122 build/C/man3/ldexp.3:87 build/C/man3/lgamma.3:100 build/C/man3/log.3:81 build/C/man3/log1p.3:91 build/C/man3/logb.3:102 build/C/man3/scalbln.3:106 build/C/man3/sin.3:83 build/C/man3/sinh.3:86 build/C/man3/sqrt.3:78 build/C/man3/tan.3:83 build/C/man3/tanh.3:85 build/C/man3/tgamma.3:73 build/C/man3/y0.3:127
411 msgid "If I<x> is a NaN, a NaN is returned."
412 msgstr ""
413
414 #. type: Plain text
415 #: build/C/man3/acos.3:86 build/C/man3/acosh.3:95
416 msgid "If I<x> is +1, +0 is returned."
417 msgstr ""
418
419 #. type: Plain text
420 #: build/C/man3/acos.3:92 build/C/man3/cos.3:88 build/C/man3/sin.3:92 build/C/man3/tan.3:89
421 msgid ""
422 "If I<x> is positive infinity or negative infinity, a domain error occurs, "
423 "and a NaN is returned."
424 msgstr ""
425
426 #
427 #.  POSIX.1-2001 documents an optional range error for subnormal x;
428 #.  glibc 2.8 does not do this.
429 #. type: Plain text
430 #: build/C/man3/acos.3:98 build/C/man3/asin.3:96
431 msgid ""
432 "If I<x> is outside the range [-1,\\ 1], a domain error occurs, and a NaN is "
433 "returned."
434 msgstr ""
435
436 #. type: SH
437 #: build/C/man3/acos.3:98 build/C/man3/acosh.3:105 build/C/man3/asin.3:96 build/C/man3/asinh.3:103 build/C/man3/atan.3:94 build/C/man3/atan2.3:162 build/C/man3/atanh.3:115 build/C/man3/cbrt.3:88 build/C/man3/ceil.3:78 build/C/man3/copysign.3:90 build/C/man3/cos.3:88 build/C/man3/cosh.3:104 build/C/man3/erf.3:106 build/C/man3/erfc.3:102 build/C/man3/exp.3:105 build/C/man3/exp10.3:65 build/C/man3/exp2.3:81 build/C/man3/expm1.3:117 build/C/man3/fabs.3:83 build/C/man3/fdim.3:59 build/C/man3/floor.3:77 build/C/man3/fma.3:117 build/C/man3/fmax.3:54 build/C/man3/fmin.3:54 build/C/man3/fmod.3:120 build/C/man3/frexp.3:106 build/C/man3/gamma.3:62 build/C/man3/hypot.3:128 build/C/man3/ilogb.3:110 build/C/man3/infnan.3:76 build/C/man3/isgreater.3:123 build/C/man3/j0.3:129 build/C/man3/ldexp.3:106 build/C/man3/lgamma.3:130 build/C/man3/log.3:105 build/C/man3/log10.3:81 build/C/man3/log1p.3:113 build/C/man3/log2.3:81 build/C/man3/logb.3:116 build/C/man3/lrint.3:87 build/C/man3/lround.3:90 build/C/man3/modf.3:93 build/C/man3/nextafter.3:143 build/C/man3/pow.3:256 build/C/man3/remainder.3:150 build/C/man3/remquo.3:101 build/C/man3/rint.3:113 build/C/man3/round.3:83 build/C/man3/scalb.3:138 build/C/man3/scalbln.3:130 build/C/man3/signbit.3:59 build/C/man3/sin.3:92 build/C/man3/sincos.3:52 build/C/man3/sinh.3:109 build/C/man3/sqrt.3:92 build/C/man3/tan.3:107 build/C/man3/tanh.3:98 build/C/man3/tgamma.3:107 build/C/man3/trunc.3:71 build/C/man3/y0.3:164
438 #, no-wrap
439 msgid "ERRORS"
440 msgstr ""
441
442 #. type: Plain text
443 #: build/C/man3/acos.3:103 build/C/man3/acosh.3:110 build/C/man3/asin.3:101 build/C/man3/atanh.3:120 build/C/man3/cos.3:93 build/C/man3/cosh.3:109 build/C/man3/erf.3:111 build/C/man3/erfc.3:107 build/C/man3/exp.3:110 build/C/man3/exp10.3:70 build/C/man3/exp2.3:86 build/C/man3/expm1.3:122 build/C/man3/fdim.3:64 build/C/man3/fma.3:122 build/C/man3/fmod.3:125 build/C/man3/hypot.3:133 build/C/man3/ilogb.3:115 build/C/man3/j0.3:134 build/C/man3/ldexp.3:111 build/C/man3/lgamma.3:135 build/C/man3/log.3:110 build/C/man3/log10.3:86 build/C/man3/log1p.3:118 build/C/man3/log2.3:86 build/C/man3/logb.3:121 build/C/man3/lrint.3:92 build/C/man3/lround.3:95 build/C/man3/nextafter.3:148 build/C/man3/pow.3:281 build/C/man3/remainder.3:155 build/C/man3/remquo.3:106 build/C/man3/scalb.3:143 build/C/man3/scalbln.3:135 build/C/man3/sin.3:97 build/C/man3/sincos.3:57 build/C/man3/sinh.3:114 build/C/man3/sqrt.3:97 build/C/man3/tan.3:112 build/C/man3/tgamma.3:112 build/C/man3/y0.3:169
444 msgid ""
445 "See B<math_error>(7)  for information on how to determine whether an error "
446 "has occurred when calling these functions."
447 msgstr ""
448
449 #. type: Plain text
450 #: build/C/man3/acos.3:105 build/C/man3/acosh.3:112 build/C/man3/asin.3:103 build/C/man3/atanh.3:122 build/C/man3/cos.3:95 build/C/man3/cosh.3:111 build/C/man3/erf.3:113 build/C/man3/erfc.3:109 build/C/man3/exp.3:112 build/C/man3/expm1.3:124 build/C/man3/fdim.3:66 build/C/man3/fma.3:124 build/C/man3/fmod.3:127 build/C/man3/hypot.3:135 build/C/man3/ilogb.3:117 build/C/man3/j0.3:136 build/C/man3/ldexp.3:113 build/C/man3/lgamma.3:137 build/C/man3/log.3:112 build/C/man3/log1p.3:120 build/C/man3/logb.3:123 build/C/man3/lrint.3:94 build/C/man3/lround.3:97 build/C/man3/nextafter.3:150 build/C/man3/pow.3:283 build/C/man3/remainder.3:157 build/C/man3/remquo.3:108 build/C/man3/scalb.3:145 build/C/man3/scalbln.3:137 build/C/man3/sin.3:99 build/C/man3/sincos.3:59 build/C/man3/sinh.3:116 build/C/man3/sqrt.3:99 build/C/man3/tan.3:114 build/C/man3/tgamma.3:114 build/C/man3/y0.3:171
451 msgid "The following errors can occur:"
452 msgstr ""
453
454 #. type: TP
455 #: build/C/man3/acos.3:105 build/C/man3/asin.3:103
456 #, no-wrap
457 msgid "Domain error: I<x> is outside the range [-1,\\ 1]"
458 msgstr ""
459
460 #. type: Plain text
461 #: build/C/man3/acos.3:113 build/C/man3/acosh.3:120 build/C/man3/asin.3:111 build/C/man3/atanh.3:130 build/C/man3/fmod.3:146 build/C/man3/log.3:120 build/C/man3/pow.3:291 build/C/man3/remainder.3:180 build/C/man3/sqrt.3:107 build/C/man3/y0.3:179
462 msgid ""
463 "I<errno> is set to B<EDOM>.  An invalid floating-point exception "
464 "(B<FE_INVALID>)  is raised."
465 msgstr ""
466
467 #. type: Plain text
468 #: build/C/man3/acos.3:119 build/C/man3/acosh.3:126 build/C/man3/asin.3:117 build/C/man3/asinh.3:111 build/C/man3/atan.3:102 build/C/man3/atan2.3:172 build/C/man3/atanh.3:145 build/C/man3/ceil.3:95 build/C/man3/exp.3:134 build/C/man3/exp2.3:97 build/C/man3/fabs.3:99 build/C/man3/floor.3:94 build/C/man3/fmod.3:152 build/C/man3/frexp.3:114 build/C/man3/ldexp.3:135 build/C/man3/log.3:134 build/C/man3/log10.3:95 build/C/man3/modf.3:109 build/C/man3/pow.3:322 build/C/man3/sin.3:114 build/C/man3/sinh.3:130 build/C/man3/sqrt.3:113 build/C/man3/tan.3:139 build/C/man3/tanh.3:106
469 msgid ""
470 "C99, POSIX.1-2001.  The variant returning I<double> also conforms to SVr4, "
471 "4.3BSD, C89."
472 msgstr ""
473
474 #. type: Plain text
475 #: build/C/man3/acos.3:127
476 msgid ""
477 "B<asin>(3), B<atan>(3), B<atan2>(3), B<cacos>(3), B<cos>(3), B<sin>(3), "
478 "B<tan>(3)"
479 msgstr ""
480
481 #. type: TH
482 #: build/C/man3/acosh.3:35
483 #, no-wrap
484 msgid "ACOSH"
485 msgstr ""
486
487 #. type: Plain text
488 #: build/C/man3/acosh.3:38
489 msgid "acosh, acoshf, acoshl - inverse hyperbolic cosine function"
490 msgstr ""
491
492 #. type: Plain text
493 #: build/C/man3/acosh.3:43
494 #, no-wrap
495 msgid "B<double acosh(double >I<x>B<);>\n"
496 msgstr ""
497
498 #. type: Plain text
499 #: build/C/man3/acosh.3:45
500 #, no-wrap
501 msgid "B<float acoshf(float >I<x>B<);>\n"
502 msgstr ""
503
504 #. type: Plain text
505 #: build/C/man3/acosh.3:47
506 #, no-wrap
507 msgid "B<long double acoshl(long double >I<x>B<);>\n"
508 msgstr ""
509
510 #. type: Plain text
511 #: build/C/man3/acosh.3:58
512 msgid "B<acosh>():"
513 msgstr ""
514
515 #. type: Plain text
516 #: build/C/man3/acosh.3:62 build/C/man3/asinh.3:62 build/C/man3/atanh.3:62 build/C/man3/cbrt.3:58 build/C/man3/expm1.3:57 build/C/man3/ilogb.3:55 build/C/man3/log1p.3:56 build/C/man3/logb.3:54 build/C/man3/nextafter.3:44 build/C/man3/rint.3:71
517 msgid ""
518 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
519 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || "
520 "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
521 msgstr ""
522
523 #. type: Plain text
524 #: build/C/man3/acosh.3:69
525 msgid "B<acoshf>(), B<acoshl>():"
526 msgstr ""
527
528 #. type: Plain text
529 #: build/C/man3/acosh.3:84
530 msgid ""
531 "The B<acosh>()  function calculates the inverse hyperbolic cosine of I<x>; "
532 "that is the value whose hyperbolic cosine is I<x>."
533 msgstr ""
534
535 #. type: Plain text
536 #: build/C/man3/acosh.3:87
537 msgid "On success, these functions return the inverse hyperbolic cosine of I<x>."
538 msgstr ""
539
540 #. type: Plain text
541 #: build/C/man3/acosh.3:99 build/C/man3/exp.3:87 build/C/man3/expm1.3:105 build/C/man3/log.3:90 build/C/man3/log1p.3:95 build/C/man3/sqrt.3:86 build/C/man3/tgamma.3:77
542 msgid "If I<x> is positive infinity, positive infinity is returned."
543 msgstr ""
544
545 #. type: Plain text
546 #: build/C/man3/acosh.3:105
547 msgid ""
548 "If I<x> is less than 1, a domain error occurs, and the functions return a "
549 "NaN."
550 msgstr ""
551
552 #. type: TP
553 #: build/C/man3/acosh.3:112
554 #, no-wrap
555 msgid "Domain error: I<x> is less than 1"
556 msgstr ""
557
558 #. type: Plain text
559 #: build/C/man3/acosh.3:133
560 msgid "B<asinh>(3), B<atanh>(3), B<cacosh>(3), B<cosh>(3), B<sinh>(3), B<tanh>(3)"
561 msgstr ""
562
563 #. type: TH
564 #: build/C/man3/asin.3:35
565 #, no-wrap
566 msgid "ASIN"
567 msgstr ""
568
569 #. type: Plain text
570 #: build/C/man3/asin.3:38
571 msgid "asin, asinf, asinl - arc sine function"
572 msgstr ""
573
574 #. type: Plain text
575 #: build/C/man3/asin.3:43
576 #, no-wrap
577 msgid "B<double asin(double >I<x>B<);>\n"
578 msgstr ""
579
580 #. type: Plain text
581 #: build/C/man3/asin.3:45
582 #, no-wrap
583 msgid "B<float asinf(float >I<x>B<);>\n"
584 msgstr ""
585
586 #. type: Plain text
587 #: build/C/man3/asin.3:47
588 #, no-wrap
589 msgid "B<long double asinl(long double >I<x>B<);>\n"
590 msgstr ""
591
592 #. type: Plain text
593 #: build/C/man3/asin.3:59
594 msgid "B<asinf>(), B<asinl>():"
595 msgstr ""
596
597 #. type: Plain text
598 #: build/C/man3/asin.3:74
599 msgid ""
600 "The B<asin>()  function calculates the principal value of the arc sine of "
601 "I<x>; that is the value whose sine is I<x>."
602 msgstr ""
603
604 #. type: Plain text
605 #: build/C/man3/asin.3:78
606 msgid ""
607 "On success, these functions return the principal value of the arc sine of "
608 "I<x> in radians; the return value is in the range [-pi/2,\\ pi/2]."
609 msgstr ""
610
611 #. type: Plain text
612 #: build/C/man3/asin.3:87 build/C/man3/asinh.3:95 build/C/man3/atan.3:87 build/C/man3/atanh.3:95 build/C/man3/erf.3:95 build/C/man3/expm1.3:101 build/C/man3/scalbln.3:115 build/C/man3/sinh.3:90 build/C/man3/sqrt.3:82 build/C/man3/tanh.3:89
613 msgid "If I<x> is +0 (-0), +0 (-0) is returned."
614 msgstr ""
615
616 #. type: Plain text
617 #: build/C/man3/asin.3:125
618 msgid ""
619 "B<acos>(3), B<atan>(3), B<atan2>(3), B<casin>(3), B<cos>(3), B<sin>(3), "
620 "B<tan>(3)"
621 msgstr ""
622
623 #. type: TH
624 #: build/C/man3/asinh.3:35
625 #, no-wrap
626 msgid "ASINH"
627 msgstr ""
628
629 #. type: Plain text
630 #: build/C/man3/asinh.3:38
631 msgid "asinh, asinhf, asinhl - inverse hyperbolic sine function"
632 msgstr ""
633
634 #. type: Plain text
635 #: build/C/man3/asinh.3:43
636 #, no-wrap
637 msgid "B<double asinh(double >I<x>B<);>\n"
638 msgstr ""
639
640 #. type: Plain text
641 #: build/C/man3/asinh.3:45
642 #, no-wrap
643 msgid "B<float asinhf(float >I<x>B<);>\n"
644 msgstr ""
645
646 #. type: Plain text
647 #: build/C/man3/asinh.3:47
648 #, no-wrap
649 msgid "B<long double asinhl(long double >I<x>B<);>\n"
650 msgstr ""
651
652 #. type: Plain text
653 #: build/C/man3/asinh.3:58
654 msgid "B<asinh>():"
655 msgstr ""
656
657 #. type: Plain text
658 #: build/C/man3/asinh.3:69
659 msgid "B<asinhf>(), B<asinhl>():"
660 msgstr ""
661
662 #. type: Plain text
663 #: build/C/man3/asinh.3:84
664 msgid ""
665 "The B<asinh>()  function calculates the inverse hyperbolic sine of I<x>; "
666 "that is the value whose hyperbolic sine is I<x>."
667 msgstr ""
668
669 #. type: Plain text
670 #: build/C/man3/asinh.3:87
671 msgid "On success, these functions return the inverse hyperbolic sine of I<x>."
672 msgstr ""
673
674 #. type: Plain text
675 #: build/C/man3/asinh.3:103 build/C/man3/ldexp.3:92 build/C/man3/scalbln.3:111 build/C/man3/sinh.3:95
676 msgid ""
677 "If I<x> is positive infinity (negative infinity), positive infinity "
678 "(negative infinity) is returned."
679 msgstr ""
680
681 #. type: Plain text
682 #: build/C/man3/asinh.3:105 build/C/man3/atan.3:96 build/C/man3/atan2.3:166 build/C/man3/cbrt.3:90 build/C/man3/copysign.3:92 build/C/man3/fabs.3:85 build/C/man3/fmax.3:56 build/C/man3/fmin.3:56 build/C/man3/frexp.3:108 build/C/man3/isgreater.3:125 build/C/man3/modf.3:95 build/C/man3/signbit.3:61 build/C/man3/tanh.3:100 build/C/man3/trunc.3:73
683 msgid "No errors occur."
684 msgstr ""
685
686 #. type: Plain text
687 #: build/C/man3/asinh.3:118
688 msgid "B<acosh>(3), B<atanh>(3), B<casinh>(3), B<cosh>(3), B<sinh>(3), B<tanh>(3)"
689 msgstr ""
690
691 #. type: TH
692 #: build/C/man3/atan.3:35
693 #, no-wrap
694 msgid "ATAN"
695 msgstr ""
696
697 #. type: Plain text
698 #: build/C/man3/atan.3:38
699 msgid "atan, atanf, atanl - arc tangent function"
700 msgstr ""
701
702 #. type: Plain text
703 #: build/C/man3/atan.3:43
704 #, no-wrap
705 msgid "B<double atan(double >I<x>B<);>\n"
706 msgstr ""
707
708 #. type: Plain text
709 #: build/C/man3/atan.3:45
710 #, no-wrap
711 msgid "B<float atanf(float >I<x>B<);>\n"
712 msgstr ""
713
714 #. type: Plain text
715 #: build/C/man3/atan.3:47
716 #, no-wrap
717 msgid "B<long double atanl( long double >I<x>B<);>\n"
718 msgstr ""
719
720 #. type: Plain text
721 #: build/C/man3/atan.3:59
722 msgid "B<atanf>(), B<atanl>():"
723 msgstr ""
724
725 #. type: Plain text
726 #: build/C/man3/atan.3:74
727 msgid ""
728 "The B<atan>()  function calculates the principal value of the arc tangent of "
729 "I<x>; that is the value whose tangent is I<x>."
730 msgstr ""
731
732 #. type: Plain text
733 #: build/C/man3/atan.3:78
734 msgid ""
735 "On success, these functions return the principal value of the arc tangent of "
736 "I<x> in radians; the return value is in the range [-pi/2,\\ pi/2]."
737 msgstr ""
738
739 #
740 #.  POSIX.1-2001 documents an optional range error for subnormal x;
741 #.  glibc 2.8 does not do this.
742 #. type: Plain text
743 #: build/C/man3/atan.3:94
744 msgid "If I<x> is positive infinity (negative infinity), +pi/2 (-pi/2) is returned."
745 msgstr ""
746
747 #. type: Plain text
748 #: build/C/man3/atan.3:111
749 msgid ""
750 "B<acos>(3), B<asin>(3), B<atan2>(3), B<carg>(3), B<catan>(3), B<cos>(3), "
751 "B<sin>(3), B<tan>(3)"
752 msgstr ""
753
754 #. type: TH
755 #: build/C/man3/atan2.3:35
756 #, no-wrap
757 msgid "ATAN2"
758 msgstr ""
759
760 #. type: Plain text
761 #: build/C/man3/atan2.3:38
762 msgid "atan2, atan2f, atan2l - arc tangent function of two variables"
763 msgstr ""
764
765 #. type: Plain text
766 #: build/C/man3/atan2.3:45
767 #, no-wrap
768 msgid ""
769 "B<double atan2(double >I<y>B<, double >I<x>B<);>\n"
770 "B<float atan2f(float >I<y>B<, float >I<x>B<);>\n"
771 "B<long double atan2l(long double >I<y>B<, long double >I<x>B<);>\n"
772 msgstr ""
773
774 #. type: Plain text
775 #: build/C/man3/atan2.3:57
776 msgid "B<atan2f>(), B<atan2l>():"
777 msgstr ""
778
779 #. type: Plain text
780 #: build/C/man3/atan2.3:72
781 msgid ""
782 "The B<atan2>()  function calculates the principal value of the arc tangent "
783 "of I<y/x>, using the signs of the two arguments to determine the quadrant of "
784 "the result."
785 msgstr ""
786
787 #. type: Plain text
788 #: build/C/man3/atan2.3:76
789 msgid ""
790 "On success, these functions return the principal value of the arc tangent of "
791 "I<y/x> in radians; the return value is in the range [-pi,\\ pi]."
792 msgstr ""
793
794 #. type: Plain text
795 #: build/C/man3/atan2.3:82
796 msgid "If I<y> is +0 (-0) and I<x> is less than 0, +pi (-pi) is returned."
797 msgstr ""
798
799 #. type: Plain text
800 #: build/C/man3/atan2.3:88
801 msgid "If I<y> is +0 (-0) and I<x> is greater than 0, +0 (-0) is returned."
802 msgstr ""
803
804 #. type: Plain text
805 #: build/C/man3/atan2.3:94
806 msgid "If I<y> is less than 0 and I<x> is +0 or -0, -pi/2 is returned."
807 msgstr ""
808
809 #. type: Plain text
810 #: build/C/man3/atan2.3:100
811 msgid "If I<y> is greater than 0 and I<x> is +0 or -0, pi/2 is returned."
812 msgstr ""
813
814 #.  POSIX.1 says:
815 #.  If
816 #.  .I x
817 #.  is 0, a pole error shall not occur.
818 #. type: Plain text
819 #: build/C/man3/atan2.3:111
820 msgid "If either I<x> or I<y> is NaN, a NaN is returned."
821 msgstr ""
822
823 #.  POSIX.1 says:
824 #.  If the result underflows, a range error may occur and
825 #.  .I y/x
826 #.  should be returned.
827 #. type: Plain text
828 #: build/C/man3/atan2.3:122
829 msgid "If I<y> is +0 (-0) and I<x> is -0, +pi (-pi) is returned."
830 msgstr ""
831
832 #. type: Plain text
833 #: build/C/man3/atan2.3:128
834 msgid "If I<y> is +0 (-0) and I<x> is +0, +0 (-0) is returned."
835 msgstr ""
836
837 #. type: Plain text
838 #: build/C/man3/atan2.3:134
839 msgid ""
840 "If I<y> is a finite value greater (less) than 0, and I<x> is negative "
841 "infinity, +pi (-pi) is returned."
842 msgstr ""
843
844 #. type: Plain text
845 #: build/C/man3/atan2.3:140
846 msgid ""
847 "If I<y> is a finite value greater (less) than 0, and I<x> is positive "
848 "infinity, +0 (-0) is returned."
849 msgstr ""
850
851 #. type: Plain text
852 #: build/C/man3/atan2.3:147
853 msgid ""
854 "If I<y> is positive infinity (negative infinity), and I<x> is finite, pi/2 "
855 "(-pi/2) is returned."
856 msgstr ""
857
858 #. type: Plain text
859 #: build/C/man3/atan2.3:153
860 msgid ""
861 "If I<y> is positive infinity (negative infinity) and I<x> is negative "
862 "infinity, +3*pi/4 (-3*pi/4) is returned."
863 msgstr ""
864
865 #
866 #.  POSIX.1 says:
867 #.  If both arguments are 0, a domain error shall not occur.
868 #. type: Plain text
869 #: build/C/man3/atan2.3:162
870 msgid ""
871 "If I<y> is positive infinity (negative infinity) and I<x> is positive "
872 "infinity, +pi/4 (-pi/4) is returned."
873 msgstr ""
874
875 #. type: Plain text
876 #: build/C/man3/atan2.3:180
877 msgid ""
878 "B<acos>(3), B<asin>(3), B<atan>(3), B<carg>(3), B<cos>(3), B<sin>(3), "
879 "B<tan>(3)"
880 msgstr ""
881
882 #. type: TH
883 #: build/C/man3/atanh.3:35
884 #, no-wrap
885 msgid "ATANH"
886 msgstr ""
887
888 #. type: TH
889 #: build/C/man3/atanh.3:35 build/C/man3/cos.3:34 build/C/man3/lgamma.3:11 build/C/man3/sin.3:35 build/C/man3/tan.3:35
890 #, no-wrap
891 msgid "2010-09-11"
892 msgstr ""
893
894 #. type: Plain text
895 #: build/C/man3/atanh.3:38
896 msgid "atanh, atanhf, atanhl - inverse hyperbolic tangent function"
897 msgstr ""
898
899 #. type: Plain text
900 #: build/C/man3/atanh.3:43
901 #, no-wrap
902 msgid "B<double atanh(double >I<x>B<);>\n"
903 msgstr ""
904
905 #. type: Plain text
906 #: build/C/man3/atanh.3:45
907 #, no-wrap
908 msgid "B<float atanhf(float >I<x>B<);>\n"
909 msgstr ""
910
911 #. type: Plain text
912 #: build/C/man3/atanh.3:47
913 #, no-wrap
914 msgid "B<long double atanhl(long double >I<x>B<);>\n"
915 msgstr ""
916
917 #. type: Plain text
918 #: build/C/man3/atanh.3:58
919 msgid "B<atanh>():"
920 msgstr ""
921
922 #. type: Plain text
923 #: build/C/man3/atanh.3:69
924 msgid "B<atanhf>(), B<atanhl>():"
925 msgstr ""
926
927 #. type: Plain text
928 #: build/C/man3/atanh.3:84
929 msgid ""
930 "The B<atanh>()  function calculates the inverse hyperbolic tangent of I<x>; "
931 "that is the value whose hyperbolic tangent is I<x>."
932 msgstr ""
933
934 #. type: Plain text
935 #: build/C/man3/atanh.3:87
936 msgid "On success, these functions return the inverse hyperbolic tangent of I<x>."
937 msgstr ""
938
939 #. type: Plain text
940 #: build/C/man3/atanh.3:106
941 msgid ""
942 "If I<x> is +1 or -1, a pole error occurs, and the functions return "
943 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the "
944 "mathematically correct sign."
945 msgstr ""
946
947 #
948 #.  POSIX.1-2001 documents an optional range error for subnormal x;
949 #.  glibc 2.8 does not do this.
950 #. type: Plain text
951 #: build/C/man3/atanh.3:115
952 msgid ""
953 "If the absolute value of I<x> is greater than 1, a domain error occurs, and "
954 "a NaN is returned."
955 msgstr ""
956
957 #. type: TP
958 #: build/C/man3/atanh.3:122
959 #, no-wrap
960 msgid "Domain error: I<x> less than -1 or greater than +1"
961 msgstr ""
962
963 #. type: TP
964 #: build/C/man3/atanh.3:130
965 #, no-wrap
966 msgid "Pole error: I<x> is +1 or -1"
967 msgstr ""
968
969 #. type: Plain text
970 #: build/C/man3/atanh.3:139 build/C/man3/lgamma.3:146 build/C/man3/pow.3:300
971 msgid ""
972 "I<errno> is set to B<ERANGE> (but see BUGS).  A divide-by-zero "
973 "floating-point exception (B<FE_DIVBYZERO>)  is raised."
974 msgstr ""
975
976 #. type: SH
977 #: build/C/man3/atanh.3:145 build/C/man3/cos.3:110 build/C/man3/cosh.3:125 build/C/man3/expm1.3:139 build/C/man3/fenv.3:312 build/C/man3/fmod.3:152 build/C/man3/j0.3:156 build/C/man3/lgamma.3:165 build/C/man3/log.3:134 build/C/man3/nextafter.3:177 build/C/man3/pow.3:322 build/C/man3/remainder.3:204 build/C/man3/sin.3:114 build/C/man3/tan.3:139 build/C/man3/tgamma.3:171 build/C/man3/y0.3:229
978 #, no-wrap
979 msgid "BUGS"
980 msgstr ""
981
982 #.  Bug: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6759
983 #.  This can be seen in sysdeps/ieee754/k_standard.c
984 #. type: Plain text
985 #: build/C/man3/atanh.3:156
986 msgid ""
987 "In glibc 2.9 and earlier, when a pole error occurs, I<errno> as set to "
988 "B<EDOM> instead of the POSIX-mandated B<ERANGE>.  Since version 2.10, glibc "
989 "does the right thing."
990 msgstr ""
991
992 #. type: Plain text
993 #: build/C/man3/atanh.3:163
994 msgid "B<acosh>(3), B<asinh>(3), B<catanh>(3), B<cosh>(3), B<sinh>(3), B<tanh>(3)"
995 msgstr ""
996
997 #. type: TH
998 #: build/C/man3/cbrt.3:30
999 #, no-wrap
1000 msgid "CBRT"
1001 msgstr ""
1002
1003 #. type: Plain text
1004 #: build/C/man3/cbrt.3:33
1005 msgid "cbrt, cbrtf, cbrtl - cube root function"
1006 msgstr ""
1007
1008 #. type: Plain text
1009 #: build/C/man3/cbrt.3:38
1010 #, no-wrap
1011 msgid "B<double cbrt(double >I<x>B<);>\n"
1012 msgstr ""
1013
1014 #. type: Plain text
1015 #: build/C/man3/cbrt.3:40
1016 #, no-wrap
1017 msgid "B<float cbrtf(float >I<x>B<);>\n"
1018 msgstr ""
1019
1020 #. type: Plain text
1021 #: build/C/man3/cbrt.3:42
1022 #, no-wrap
1023 msgid "B<long double cbrtl(long double >I<x>B<);>\n"
1024 msgstr ""
1025
1026 #. type: Plain text
1027 #: build/C/man3/cbrt.3:53
1028 msgid "B<cbrt>():"
1029 msgstr ""
1030
1031 #. type: Plain text
1032 #: build/C/man3/cbrt.3:64
1033 msgid "B<cbrtf>(), B<cbrtl>():"
1034 msgstr ""
1035
1036 #. type: Plain text
1037 #: build/C/man3/cbrt.3:67
1038 msgid ""
1039 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
1040 "_ISOC99_SOURCE || _POSIX_C_SOUCE\\ E<gt>=\\ 200112L;"
1041 msgstr ""
1042
1043 #. type: Plain text
1044 #: build/C/man3/cbrt.3:79
1045 msgid ""
1046 "The B<cbrt>()  function returns the (real) cube root of I<x>.  This function "
1047 "cannot fail; every representable real value has a representable real cube "
1048 "root."
1049 msgstr ""
1050
1051 #. type: Plain text
1052 #: build/C/man3/cbrt.3:82
1053 msgid "These functions return the cube root of I<x>."
1054 msgstr ""
1055
1056 #. type: Plain text
1057 #: build/C/man3/cbrt.3:88
1058 msgid ""
1059 "If I<x> is +0, -0, positive infinity, negative infinity, or NaN, I<x> is "
1060 "returned."
1061 msgstr ""
1062
1063 #. type: Plain text
1064 #: build/C/man3/cbrt.3:94 build/C/man3/expm1.3:139 build/C/man3/fdim.3:91 build/C/man3/fma.3:158 build/C/man3/fmax.3:60 build/C/man3/fmin.3:60 build/C/man3/ilogb.3:148 build/C/man3/isgreater.3:127 build/C/man3/log1p.3:145 build/C/man3/logb.3:145 build/C/man3/lrint.3:111 build/C/man3/lround.3:114 build/C/man3/remquo.3:126 build/C/man3/rint.3:118 build/C/man3/round.3:98 build/C/man3/scalbln.3:173 build/C/man3/tgamma.3:164 build/C/man3/trunc.3:85
1065 msgid "C99, POSIX.1-2001."
1066 msgstr ""
1067
1068 #. type: Plain text
1069 #: build/C/man3/cbrt.3:97
1070 msgid "B<pow>(3), B<sqrt>(3)"
1071 msgstr ""
1072
1073 #. type: TH
1074 #: build/C/man3/ceil.3:27
1075 #, no-wrap
1076 msgid "CEIL"
1077 msgstr ""
1078
1079 #. type: Plain text
1080 #: build/C/man3/ceil.3:31
1081 msgid ""
1082 "ceil, ceilf, ceill - ceiling function: smallest integral value not less than "
1083 "argument"
1084 msgstr ""
1085
1086 #. type: Plain text
1087 #: build/C/man3/ceil.3:36
1088 #, no-wrap
1089 msgid "B<double ceil(double >I<x>B<);>\n"
1090 msgstr ""
1091
1092 #. type: Plain text
1093 #: build/C/man3/ceil.3:38
1094 #, no-wrap
1095 msgid "B<float ceilf(float >I<x>B<);>\n"
1096 msgstr ""
1097
1098 #. type: Plain text
1099 #: build/C/man3/ceil.3:40
1100 #, no-wrap
1101 msgid "B<long double ceill(long double >I<x>B<);>\n"
1102 msgstr ""
1103
1104 #. type: Plain text
1105 #: build/C/man3/ceil.3:52
1106 msgid "B<ceilf>(), B<ceill>():"
1107 msgstr ""
1108
1109 #. type: Plain text
1110 #: build/C/man3/ceil.3:63
1111 msgid ""
1112 "These functions return the smallest integral value that is not less than "
1113 "I<x>."
1114 msgstr ""
1115
1116 #. type: Plain text
1117 #: build/C/man3/ceil.3:69
1118 msgid "For example, I<ceil(0.5)> is 1.0, and I<ceil(-0.5)> is 0.0."
1119 msgstr ""
1120
1121 #. type: Plain text
1122 #: build/C/man3/ceil.3:72
1123 msgid "These functions return the ceiling of I<x>."
1124 msgstr ""
1125
1126 #. type: Plain text
1127 #: build/C/man3/ceil.3:78 build/C/man3/rint.3:113 build/C/man3/round.3:83
1128 msgid "If I<x> is integral, +0, -0, NaN, or infinite, I<x> itself is returned."
1129 msgstr ""
1130
1131 #. type: Plain text
1132 #: build/C/man3/ceil.3:81 build/C/man3/floor.3:80 build/C/man3/rint.3:116 build/C/man3/round.3:86
1133 msgid ""
1134 "No errors occur.  POSIX.1-2001 documents a range error for overflows, but "
1135 "see NOTES."
1136 msgstr ""
1137
1138 #. type: Plain text
1139 #: build/C/man3/ceil.3:89
1140 msgid "The B<ceil>(), B<ceilf>(), and B<ceill>()  functions are thread-safe."
1141 msgstr ""
1142
1143 #. type: Plain text
1144 #: build/C/man3/ceil.3:111 build/C/man3/floor.3:110 build/C/man3/rint.3:133
1145 msgid ""
1146 "SUSv2 and POSIX.1-2001 contain text about overflow (which might set I<errno> "
1147 "to B<ERANGE>, or raise an B<FE_OVERFLOW> exception).  In practice, the "
1148 "result cannot overflow on any current machine, so this error-handling stuff "
1149 "is just nonsense.  (More precisely, overflow can happen only when the "
1150 "maximum value of the exponent is smaller than the number of mantissa bits.  "
1151 "For the IEEE-754 standard 32-bit and 64-bit floating-point numbers the "
1152 "maximum value of the exponent is 128 (respectively, 1024), and the number of "
1153 "mantissa bits is 24 (respectively, 53).)"
1154 msgstr ""
1155
1156 #. type: Plain text
1157 #: build/C/man3/ceil.3:120 build/C/man3/trunc.3:94
1158 msgid ""
1159 "The integral value returned by these functions may be too large to store in "
1160 "an integer type (I<int>, I<long>, etc.).  To avoid an overflow, which will "
1161 "produce undefined results, an application should perform a range check on "
1162 "the returned value before assigning it to an integer type."
1163 msgstr ""
1164
1165 #. type: Plain text
1166 #: build/C/man3/ceil.3:127
1167 msgid ""
1168 "B<floor>(3), B<lrint>(3), B<nearbyint>(3), B<rint>(3), B<round>(3), "
1169 "B<trunc>(3)"
1170 msgstr ""
1171
1172 #. type: TH
1173 #: build/C/man3/copysign.3:31
1174 #, no-wrap
1175 msgid "COPYSIGN"
1176 msgstr ""
1177
1178 #. type: TH
1179 #: build/C/man3/copysign.3:31
1180 #, no-wrap
1181 msgid "2012-03-25"
1182 msgstr ""
1183
1184 #. type: Plain text
1185 #: build/C/man3/copysign.3:34
1186 msgid "copysign, copysignf, copysignl - copy sign of a number"
1187 msgstr ""
1188
1189 #. type: Plain text
1190 #: build/C/man3/copysign.3:39
1191 #, no-wrap
1192 msgid "B<double copysign(double >I<x>B<, double >I<y>B<);>\n"
1193 msgstr ""
1194
1195 #. type: Plain text
1196 #: build/C/man3/copysign.3:41
1197 #, no-wrap
1198 msgid "B<float copysignf(float >I<x>B<, float >I<y>B<);>\n"
1199 msgstr ""
1200
1201 #. type: Plain text
1202 #: build/C/man3/copysign.3:43
1203 #, no-wrap
1204 msgid "B<long double copysignl(long double >I<x>B<, long double >I<y>B<);>\n"
1205 msgstr ""
1206
1207 #. type: Plain text
1208 #: build/C/man3/copysign.3:56
1209 msgid "B<copysign>(), B<copysignf>(), B<copysignl>():"
1210 msgstr ""
1211
1212 #. type: Plain text
1213 #: build/C/man3/copysign.3:59
1214 msgid ""
1215 "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
1216 "_ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
1217 msgstr ""
1218
1219 #. type: Plain text
1220 #: build/C/man3/copysign.3:72
1221 msgid ""
1222 "The B<copysign>()  functions return a value whose absolute value matches "
1223 "that of I<x>, but whose sign bit matches that of I<y>."
1224 msgstr ""
1225
1226 #. type: Plain text
1227 #: build/C/man3/copysign.3:78
1228 msgid ""
1229 "For example, I<copysign(42.0,\\ -1.0)> and I<copysign(-42.0, -1.0)> both "
1230 "return -42.0."
1231 msgstr ""
1232
1233 #. type: Plain text
1234 #: build/C/man3/copysign.3:83
1235 msgid ""
1236 "On success, these functions return a value whose magnitude is taken from "
1237 "I<x> and whose sign is taken from I<y>."
1238 msgstr ""
1239
1240 #. type: Plain text
1241 #: build/C/man3/copysign.3:90
1242 msgid "If I<x> is a NaN, a NaN with the sign bit of I<y> is returned."
1243 msgstr ""
1244
1245 #. type: Plain text
1246 #: build/C/man3/copysign.3:97 build/C/man3/nextafter.3:177 build/C/man3/signbit.3:70
1247 msgid ""
1248 "C99, POSIX.1-2001.  This function is defined in IEC 559 (and the appendix "
1249 "with recommended functions in IEEE 754/IEEE 854)."
1250 msgstr ""
1251
1252 #. type: Plain text
1253 #: build/C/man3/copysign.3:102
1254 msgid ""
1255 "On architectures where the floating-point formats are not IEEE 754 "
1256 "compliant, the B<copysign>()  functions may treat a negative zero as "
1257 "positive."
1258 msgstr ""
1259
1260 #. type: Plain text
1261 #: build/C/man3/copysign.3:104
1262 msgid "B<signbit>(3)"
1263 msgstr ""
1264
1265 #. type: TH
1266 #: build/C/man3/cos.3:34
1267 #, no-wrap
1268 msgid "COS"
1269 msgstr ""
1270
1271 #. type: Plain text
1272 #: build/C/man3/cos.3:37
1273 msgid "cos, cosf, cosl - cosine function"
1274 msgstr ""
1275
1276 #. type: Plain text
1277 #: build/C/man3/cos.3:42
1278 #, no-wrap
1279 msgid "B<double cos(double >I<x>B<);>\n"
1280 msgstr ""
1281
1282 #. type: Plain text
1283 #: build/C/man3/cos.3:44
1284 #, no-wrap
1285 msgid "B<float cosf(float >I<x>B<);>\n"
1286 msgstr ""
1287
1288 #. type: Plain text
1289 #: build/C/man3/cos.3:46
1290 #, no-wrap
1291 msgid "B<long double cosl(long double >I<x>B<);>\n"
1292 msgstr ""
1293
1294 #. type: Plain text
1295 #: build/C/man3/cos.3:58
1296 msgid "B<cosf>(), B<cosl>():"
1297 msgstr ""
1298
1299 #. type: Plain text
1300 #: build/C/man3/cos.3:75
1301 msgid ""
1302 "The B<cos>()  function returns the cosine of I<x>, where I<x> is given in "
1303 "radians."
1304 msgstr ""
1305
1306 #. type: Plain text
1307 #: build/C/man3/cos.3:78
1308 msgid "On success, these functions return the cosine of I<x>."
1309 msgstr ""
1310
1311 #. type: TP
1312 #: build/C/man3/cos.3:95 build/C/man3/fmod.3:127 build/C/man3/ilogb.3:130 build/C/man3/sin.3:99 build/C/man3/sincos.3:59 build/C/man3/tan.3:114
1313 #, no-wrap
1314 msgid "Domain error: I<x> is an infinity"
1315 msgstr ""
1316
1317 #. type: Plain text
1318 #: build/C/man3/cos.3:104 build/C/man3/fmod.3:136 build/C/man3/sin.3:108 build/C/man3/tan.3:123
1319 msgid ""
1320 "I<errno> is set to B<EDOM> (but see BUGS).  An invalid floating-point "
1321 "exception (B<FE_INVALID>)  is raised."
1322 msgstr ""
1323
1324 #. type: Plain text
1325 #: build/C/man3/cos.3:110 build/C/man3/cosh.3:125 build/C/man3/erf.3:132 build/C/man3/erfc.3:128 build/C/man3/hypot.3:164 build/C/man3/log2.3:97
1326 msgid ""
1327 "C99, POSIX.1-2001.  The variant returning I<double> also conforms to SVr4, "
1328 "4.3BSD."
1329 msgstr ""
1330
1331 #.  http://sourceware.org/bugzilla/show_bug.cgi?id=6782
1332 #. type: Plain text
1333 #: build/C/man3/cos.3:117 build/C/man3/sin.3:121 build/C/man3/tan.3:146
1334 msgid ""
1335 "Before version 2.10, the glibc implementation did not set I<errno> to "
1336 "B<EDOM> when a domain error occurred."
1337 msgstr ""
1338
1339 #. type: Plain text
1340 #: build/C/man3/cos.3:126
1341 msgid ""
1342 "B<acos>(3), B<asin>(3), B<atan>(3), B<atan2>(3), B<ccos>(3), B<sin>(3), "
1343 "B<sincos>(3), B<tan>(3)"
1344 msgstr ""
1345
1346 #. type: TH
1347 #: build/C/man3/cosh.3:36
1348 #, no-wrap
1349 msgid "COSH"
1350 msgstr ""
1351
1352 #. type: Plain text
1353 #: build/C/man3/cosh.3:39
1354 msgid "cosh, coshf, coshl - hyperbolic cosine function"
1355 msgstr ""
1356
1357 #. type: Plain text
1358 #: build/C/man3/cosh.3:44
1359 #, no-wrap
1360 msgid "B<double cosh(double >I<x>B<);>\n"
1361 msgstr ""
1362
1363 #. type: Plain text
1364 #: build/C/man3/cosh.3:46
1365 #, no-wrap
1366 msgid "B<float coshf(float >I<x>B<);>\n"
1367 msgstr ""
1368
1369 #. type: Plain text
1370 #: build/C/man3/cosh.3:48
1371 #, no-wrap
1372 msgid "B<long double coshl(long double >I<x>B<);>\n"
1373 msgstr ""
1374
1375 #. type: Plain text
1376 #: build/C/man3/cosh.3:60
1377 msgid "B<coshf>(), B<coshl>():"
1378 msgstr ""
1379
1380 #. type: Plain text
1381 #: build/C/man3/cosh.3:75
1382 msgid ""
1383 "The B<cosh>()  function returns the hyperbolic cosine of I<x>, which is "
1384 "defined mathematically as:"
1385 msgstr ""
1386
1387 #. type: Plain text
1388 #: build/C/man3/cosh.3:78
1389 #, no-wrap
1390 msgid "    cosh(x) = (exp(x) + exp(-x)) / 2\n"
1391 msgstr ""
1392
1393 #. type: Plain text
1394 #: build/C/man3/cosh.3:82
1395 msgid "On success, these functions return the hyperbolic cosine of I<x>."
1396 msgstr ""
1397
1398 #. type: Plain text
1399 #: build/C/man3/cosh.3:90 build/C/man3/erfc.3:83
1400 msgid "If I<x> is +0 or -0, 1 is returned."
1401 msgstr ""
1402
1403 #. type: Plain text
1404 #: build/C/man3/cosh.3:95 build/C/man3/lgamma.3:109
1405 msgid ""
1406 "If I<x> is positive infinity or negative infinity, positive infinity is "
1407 "returned."
1408 msgstr ""
1409
1410 #. type: Plain text
1411 #: build/C/man3/cosh.3:104 build/C/man3/exp.3:105
1412 msgid ""
1413 "If the result overflows, a range error occurs, and the functions return "
1414 "+B<HUGE_VAL>, +B<HUGE_VALF>, or +B<HUGE_VALL>, respectively."
1415 msgstr ""
1416
1417 #. type: TP
1418 #: build/C/man3/cosh.3:111 build/C/man3/fdim.3:66 build/C/man3/fma.3:133 build/C/man3/hypot.3:135 build/C/man3/lgamma.3:146 build/C/man3/nextafter.3:150 build/C/man3/sinh.3:116 build/C/man3/tan.3:123 build/C/man3/tgamma.3:132 build/C/man3/y0.3:210
1419 #, no-wrap
1420 msgid "Range error: result overflow"
1421 msgstr ""
1422
1423 #. type: Plain text
1424 #: build/C/man3/cosh.3:119 build/C/man3/exp.3:120 build/C/man3/hypot.3:143 build/C/man3/ldexp.3:121 build/C/man3/lgamma.3:156 build/C/man3/pow.3:308 build/C/man3/sinh.3:124 build/C/man3/tgamma.3:140
1425 msgid ""
1426 "I<errno> is set to B<ERANGE>.  An overflow floating-point exception "
1427 "(B<FE_OVERFLOW>)  is raised."
1428 msgstr ""
1429
1430 #. type: Plain text
1431 #: build/C/man3/cosh.3:130
1432 msgid ""
1433 "In glibc version 2.3.4 and earlier, an overflow floating-point "
1434 "(B<FE_OVERFLOW>)  exception is not raised when an overflow occurs."
1435 msgstr ""
1436
1437 #. type: Plain text
1438 #: build/C/man3/cosh.3:137
1439 msgid "B<acosh>(3), B<asinh>(3), B<atanh>(3), B<ccos>(3), B<sinh>(3), B<tanh>(3)"
1440 msgstr ""
1441
1442 #. type: TH
1443 #: build/C/man3/div.3:34
1444 #, no-wrap
1445 msgid "DIV"
1446 msgstr ""
1447
1448 #. type: TH
1449 #: build/C/man3/div.3:34
1450 #, no-wrap
1451 msgid "2013-07-05"
1452 msgstr ""
1453
1454 #. type: Plain text
1455 #: build/C/man3/div.3:38
1456 msgid ""
1457 "div, ldiv, lldiv, imaxdiv - compute quotient and remainder of an integer "
1458 "division"
1459 msgstr ""
1460
1461 #. type: Plain text
1462 #: build/C/man3/div.3:43
1463 #, no-wrap
1464 msgid "B<div_t div(int >I<numerator>B<, int >I<denominator>B<);>\n"
1465 msgstr ""
1466
1467 #. type: Plain text
1468 #: build/C/man3/div.3:45
1469 #, no-wrap
1470 msgid "B<ldiv_t ldiv(long >I<numerator>B<, long >I<denominator>B<);>\n"
1471 msgstr ""
1472
1473 #. type: Plain text
1474 #: build/C/man3/div.3:47
1475 #, no-wrap
1476 msgid "B<lldiv_t lldiv(long long >I<numerator>B<, long long >I<denominator>B<);>\n"
1477 msgstr ""
1478
1479 #. type: Plain text
1480 #: build/C/man3/div.3:51
1481 #, no-wrap
1482 msgid ""
1483 "B<imaxdiv_t imaxdiv(intmax_t >I<numerator>B<, intmax_t "
1484 ">I<denominator>B<);>\n"
1485 msgstr ""
1486
1487 #. type: Plain text
1488 #: build/C/man3/div.3:60
1489 msgid "B<lldiv>():"
1490 msgstr ""
1491
1492 #. type: Plain text
1493 #: build/C/man3/div.3:78
1494 msgid ""
1495 "The B<div>()  function computes the value I<numerator>/I<denominator> and "
1496 "returns the quotient and remainder in a structure named I<div_t> that "
1497 "contains two integer members (in unspecified order) named I<quot> and "
1498 "I<rem>.  The quotient is rounded toward zero.  The result satisfies "
1499 "I<quot>*I<denominator>+I<rem> = I<numerator>."
1500 msgstr ""
1501
1502 #. type: Plain text
1503 #: build/C/man3/div.3:89
1504 msgid ""
1505 "The B<ldiv>(), B<lldiv>(), and B<imaxdiv>()  functions do the same, dividing "
1506 "numbers of the indicated type and returning the result in a structure of the "
1507 "indicated name, in all cases with fields I<quot> and I<rem> of the same type "
1508 "as the function arguments."
1509 msgstr ""
1510
1511 #. type: Plain text
1512 #: build/C/man3/div.3:91
1513 msgid "The I<div_t> (etc.) structure."
1514 msgstr ""
1515
1516 #. type: Plain text
1517 #: build/C/man3/div.3:100
1518 msgid ""
1519 "The B<div>(), B<ldiv>(), B<lldiv>(), and B<imaxdiv>()  functions are "
1520 "thread-safe."
1521 msgstr ""
1522
1523 #. type: Plain text
1524 #: build/C/man3/div.3:107
1525 msgid ""
1526 "SVr4, 4.3BSD, C89. C99.  The functions B<lldiv>()  and B<imaxdiv>()  were "
1527 "added in C99."
1528 msgstr ""
1529
1530 #. type: SH
1531 #: build/C/man3/div.3:107 build/C/man3/frexp.3:114 build/C/man3/matherr.3:275 build/C/man3/remainder.3:213
1532 #, no-wrap
1533 msgid "EXAMPLE"
1534 msgstr ""
1535
1536 #. type: Plain text
1537 #: build/C/man3/div.3:109
1538 msgid "After"
1539 msgstr ""
1540
1541 #. type: Plain text
1542 #: build/C/man3/div.3:112
1543 #, no-wrap
1544 msgid "        div_t q = div(-5, 3);\n"
1545 msgstr ""
1546
1547 #. type: Plain text
1548 #: build/C/man3/div.3:115
1549 msgid "the values I<q.quot> and I<q.rem> are -1 and -2, respectively."
1550 msgstr ""
1551
1552 #. type: Plain text
1553 #: build/C/man3/div.3:118
1554 msgid "B<abs>(3), B<remainder>(3)"
1555 msgstr ""
1556
1557 #. type: TH
1558 #: build/C/man3/erf.3:35
1559 #, no-wrap
1560 msgid "ERF"
1561 msgstr ""
1562
1563 #. type: Plain text
1564 #: build/C/man3/erf.3:38
1565 msgid "erf, erff, erfl, - error function"
1566 msgstr ""
1567
1568 #. type: Plain text
1569 #: build/C/man3/erf.3:45
1570 #, no-wrap
1571 msgid ""
1572 "B<double erf(double >I<x>B<);>\n"
1573 "B<float erff(float >I<x>B<);>\n"
1574 "B<long double erfl(long double >I<x>B<);>\n"
1575 msgstr ""
1576
1577 #. type: Plain text
1578 #: build/C/man3/erf.3:56
1579 msgid "B<erf>():"
1580 msgstr ""
1581
1582 #. type: Plain text
1583 #: build/C/man3/erf.3:59 build/C/man3/erfc.3:50 build/C/man3/fpclassify.3:53 build/C/man3/hypot.3:59 build/C/man3/lgamma.3:46
1584 msgid ""
1585 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || "
1586 "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
1587 msgstr ""
1588
1589 #. type: Plain text
1590 #: build/C/man3/erf.3:66
1591 msgid "B<erff>(), B<erfl>():"
1592 msgstr ""
1593
1594 #. type: Plain text
1595 #: build/C/man3/erf.3:81
1596 msgid "The B<erf>()  function returns the error function of I<x>, defined as"
1597 msgstr ""
1598
1599 #. type: TP
1600 #: build/C/man3/erf.3:81
1601 #, no-wrap
1602 msgid "    erf(x) = 2/sqrt(pi)* integral from 0 to x of exp(-t*t) dt"
1603 msgstr ""
1604
1605 #. type: Plain text
1606 #: build/C/man3/erf.3:87
1607 msgid ""
1608 "On success, these functions return the error function of I<x>, a value in "
1609 "the range [-1,\\ 1]."
1610 msgstr ""
1611
1612 #
1613 #.  POSIX.1-2001 documents an optional range error (underflow)
1614 #.  for subnormal x;
1615 #.  glibc 2.8 does not do this.
1616 #. type: Plain text
1617 #: build/C/man3/erf.3:100 build/C/man3/tanh.3:98
1618 msgid "If I<x> is positive infinity (negative infinity), +1 (-1) is returned."
1619 msgstr ""
1620
1621 #. type: Plain text
1622 #: build/C/man3/erf.3:106
1623 msgid ""
1624 "If I<x> is subnormal, a range error occurs, and the return value is "
1625 "2*x/sqrt(pi)."
1626 msgstr ""
1627
1628 #. type: TP
1629 #: build/C/man3/erf.3:113
1630 #, no-wrap
1631 msgid "Range error: result underflow (I<x> is subnormal)"
1632 msgstr ""
1633
1634 #.  e.g., tgamma(-172.5) on glibc 2.8/x86-32
1635 #.  .I errno
1636 #.  is set to
1637 #.  .BR ERANGE .
1638 #. type: Plain text
1639 #: build/C/man3/erf.3:121 build/C/man3/erfc.3:117 build/C/man3/fma.3:149 build/C/man3/hypot.3:151 build/C/man3/nextafter.3:168 build/C/man3/scalb.3:171 build/C/man3/scalbln.3:153 build/C/man3/tgamma.3:152
1640 msgid "An underflow floating-point exception (B<FE_UNDERFLOW>)  is raised."
1641 msgstr ""
1642
1643 #.  FIXME . Is it intentional that these functions do not set errno?
1644 #.  sin() and cos() also don't set errno; bugs have been raised for
1645 #.  those functions.
1646 #. type: Plain text
1647 #: build/C/man3/erf.3:126 build/C/man3/erfc.3:122 build/C/man3/fdim.3:79 build/C/man3/fma.3:154 build/C/man3/log1p.3:142 build/C/man3/logb.3:143 build/C/man3/lrint.3:107 build/C/man3/lround.3:110 build/C/man3/nextafter.3:173 build/C/man3/remquo.3:122 build/C/man3/scalb.3:177 build/C/man3/scalbln.3:158 build/C/man3/sincos.3:73
1648 msgid "These functions do not set I<errno>."
1649 msgstr ""
1650
1651 #. type: Plain text
1652 #: build/C/man3/erf.3:136
1653 msgid "B<cerf>(3), B<erfc>(3), B<exp>(3)"
1654 msgstr ""
1655
1656 #. type: TH
1657 #: build/C/man3/erfc.3:26
1658 #, no-wrap
1659 msgid "ERFC"
1660 msgstr ""
1661
1662 #. type: Plain text
1663 #: build/C/man3/erfc.3:29
1664 msgid "erfc, erfcf, erfcl - complementary error function"
1665 msgstr ""
1666
1667 #. type: Plain text
1668 #: build/C/man3/erfc.3:36
1669 #, no-wrap
1670 msgid ""
1671 "B<double erfc(double >I<x>B<);>\n"
1672 "B<float erfcf(float >I<x>B<);>\n"
1673 "B<long double erfcl(long double >I<x>B<);>\n"
1674 msgstr ""
1675
1676 #. type: Plain text
1677 #: build/C/man3/erfc.3:47
1678 msgid "B<erfc>():"
1679 msgstr ""
1680
1681 #. type: Plain text
1682 #: build/C/man3/erfc.3:57
1683 msgid "B<erfcf>(), B<erfcl>():"
1684 msgstr ""
1685
1686 #. type: Plain text
1687 #: build/C/man3/erfc.3:60
1688 msgid ""
1689 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600|| _ISOC99_SOURCE "
1690 "|| _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
1691 msgstr ""
1692
1693 #. type: Plain text
1694 #: build/C/man3/erfc.3:71
1695 msgid ""
1696 "The B<erfc>()  function returns the complementary error function of I<x>, "
1697 "that is, 1.0 - erf(x)."
1698 msgstr ""
1699
1700 #. type: Plain text
1701 #: build/C/man3/erfc.3:75
1702 msgid ""
1703 "On success, these functions return the complementary error function of I<x>, "
1704 "a value in the range [0,2]."
1705 msgstr ""
1706
1707 #. type: Plain text
1708 #: build/C/man3/erfc.3:88
1709 msgid "If I<x> is positive infinity, +0 is returned."
1710 msgstr ""
1711
1712 #. type: Plain text
1713 #: build/C/man3/erfc.3:93
1714 msgid "If I<x> is negative infinity, +2 is returned."
1715 msgstr ""
1716
1717 #. type: Plain text
1718 #: build/C/man3/erfc.3:96
1719 msgid ""
1720 "If the function result underflows and produces an unrepresentable value, the "
1721 "return value is 0.0."
1722 msgstr ""
1723
1724 #.  e.g., erfc(27) on x86-32
1725 #. type: Plain text
1726 #: build/C/man3/erfc.3:102
1727 msgid ""
1728 "If the function result underflows but produces a representable (i.e., "
1729 "subnormal) value, that value is returned, and a range error occurs."
1730 msgstr ""
1731
1732 #. type: TP
1733 #: build/C/man3/erfc.3:109
1734 #, no-wrap
1735 msgid "Range error: result underflow (result is subnormal)"
1736 msgstr ""
1737
1738 #. type: Plain text
1739 #: build/C/man3/erfc.3:135
1740 msgid ""
1741 "The B<erfc>()  functions are provided to avoid the loss accuracy that would "
1742 "occur for the calculation 1-erf(x) for large values of I<x> (for which the "
1743 "value of erf(x) approaches 1)."
1744 msgstr ""
1745
1746 #. type: Plain text
1747 #: build/C/man3/erfc.3:139
1748 msgid "B<cerf>(3), B<erf>(3), B<exp>(3)"
1749 msgstr ""
1750
1751 #. type: TH
1752 #: build/C/man3/exp.3:36
1753 #, no-wrap
1754 msgid "EXP"
1755 msgstr ""
1756
1757 #. type: Plain text
1758 #: build/C/man3/exp.3:39
1759 msgid "exp, expf, expl - base-e exponential function"
1760 msgstr ""
1761
1762 #. type: Plain text
1763 #: build/C/man3/exp.3:44
1764 #, no-wrap
1765 msgid "B<double exp(double >I<x>B<);>\n"
1766 msgstr ""
1767
1768 #. type: Plain text
1769 #: build/C/man3/exp.3:46
1770 #, no-wrap
1771 msgid "B<float expf(float >I<x>B<);>\n"
1772 msgstr ""
1773
1774 #. type: Plain text
1775 #: build/C/man3/exp.3:48
1776 #, no-wrap
1777 msgid "B<long double expl(long double >I<x>B<);>\n"
1778 msgstr ""
1779
1780 #. type: Plain text
1781 #: build/C/man3/exp.3:60
1782 msgid "B<expf>(), B<expl>():"
1783 msgstr ""
1784
1785 #. type: Plain text
1786 #: build/C/man3/exp.3:74
1787 msgid ""
1788 "The B<exp>()  function returns the value of e (the base of natural "
1789 "logarithms) raised to the power of I<x>."
1790 msgstr ""
1791
1792 #. type: Plain text
1793 #: build/C/man3/exp.3:77
1794 msgid "On success, these functions return the exponential value of I<x>."
1795 msgstr ""
1796
1797 #. type: Plain text
1798 #: build/C/man3/exp.3:92
1799 msgid "If I<x> is negative infinity, +0 is returned."
1800 msgstr ""
1801
1802 #. type: Plain text
1803 #: build/C/man3/exp.3:96 build/C/man3/ldexp.3:96
1804 msgid "If the result underflows, a range error occurs, and zero is returned."
1805 msgstr ""
1806
1807 #. type: TP
1808 #: build/C/man3/exp.3:112 build/C/man3/expm1.3:124 build/C/man3/ldexp.3:113 build/C/man3/scalb.3:155 build/C/man3/scalbln.3:137
1809 #, no-wrap
1810 msgid "Range error, overflow"
1811 msgstr ""
1812
1813 #. type: TP
1814 #: build/C/man3/exp.3:120 build/C/man3/ldexp.3:121 build/C/man3/scalb.3:163 build/C/man3/scalbln.3:145
1815 #, no-wrap
1816 msgid "Range error, underflow"
1817 msgstr ""
1818
1819 #. type: Plain text
1820 #: build/C/man3/exp.3:128 build/C/man3/ldexp.3:129 build/C/man3/pow.3:316
1821 msgid ""
1822 "I<errno> is set to B<ERANGE>.  An underflow floating-point exception "
1823 "(B<FE_UNDERFLOW>)  is raised."
1824 msgstr ""
1825
1826 #. type: Plain text
1827 #: build/C/man3/exp.3:140
1828 msgid "B<cbrt>(3), B<cexp>(3), B<exp10>(3), B<exp2>(3), B<sqrt>(3)"
1829 msgstr ""
1830
1831 #. type: TH
1832 #: build/C/man3/exp10.3:35
1833 #, no-wrap
1834 msgid "EXP10"
1835 msgstr ""
1836
1837 #. type: TH
1838 #: build/C/man3/exp10.3:35 build/C/man7/math_error.7:26 build/C/man3/pow10.3:25 build/C/man3/sincos.3:9
1839 #, no-wrap
1840 msgid "2008-08-11"
1841 msgstr ""
1842
1843 #. type: Plain text
1844 #: build/C/man3/exp10.3:38
1845 msgid "exp10, exp10f, exp10l - base-10 exponential function"
1846 msgstr ""
1847
1848 #. type: Plain text
1849 #: build/C/man3/exp10.3:41 build/C/man3/fenv.3:290
1850 #, no-wrap
1851 msgid "B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
1852 msgstr ""
1853
1854 #. type: Plain text
1855 #: build/C/man3/exp10.3:45
1856 #, no-wrap
1857 msgid "B<double exp10(double >I<x>B<);>\n"
1858 msgstr ""
1859
1860 #. type: Plain text
1861 #: build/C/man3/exp10.3:47
1862 #, no-wrap
1863 msgid "B<float exp10f(float >I<x>B<);>\n"
1864 msgstr ""
1865
1866 #. type: Plain text
1867 #: build/C/man3/exp10.3:49
1868 #, no-wrap
1869 msgid "B<long double exp10l(long double >I<x>B<);>\n"
1870 msgstr ""
1871
1872 #. type: Plain text
1873 #: build/C/man3/exp10.3:58
1874 msgid ""
1875 "The B<exp10>()  function returns the value of 10 raised to the power of "
1876 "I<x>."
1877 msgstr ""
1878
1879 #. type: Plain text
1880 #: build/C/man3/exp10.3:61
1881 msgid "On success, these functions return the base-10 exponential value of I<x>."
1882 msgstr ""
1883
1884 #. type: Plain text
1885 #: build/C/man3/exp10.3:65 build/C/man3/exp2.3:81
1886 msgid ""
1887 "For various special cases, including the handling of infinity and NaN, as "
1888 "well as overflows and underflows, see B<exp>(3)."
1889 msgstr ""
1890
1891 #. type: Plain text
1892 #: build/C/man3/exp10.3:75 build/C/man3/exp2.3:89
1893 msgid ""
1894 "For a discussion of the errors that can occur for these functions, see "
1895 "B<exp>(3)."
1896 msgstr ""
1897
1898 #. type: SH
1899 #: build/C/man3/exp10.3:75 build/C/man3/exp2.3:89 build/C/man3/fdim.3:79 build/C/man3/fenv.3:263 build/C/man3/fma.3:154 build/C/man3/fmax.3:56 build/C/man3/fmin.3:56 build/C/man3/log2.3:89 build/C/man3/lrint.3:107 build/C/man3/lround.3:110 build/C/man3/nan.3:73 build/C/man3/pow10.3:47 build/C/man3/remquo.3:122 build/C/man3/round.3:86 build/C/man3/scalbln.3:158 build/C/man3/sincos.3:73 build/C/man3/tgamma.3:160 build/C/man3/trunc.3:73
1900 #, no-wrap
1901 msgid "VERSIONS"
1902 msgstr ""
1903
1904 #. type: Plain text
1905 #: build/C/man3/exp10.3:77 build/C/man3/exp2.3:91 build/C/man3/fdim.3:81 build/C/man3/fenv.3:265 build/C/man3/fma.3:156 build/C/man3/fmax.3:58 build/C/man3/fmin.3:58 build/C/man3/log2.3:91 build/C/man3/lrint.3:109 build/C/man3/lround.3:112 build/C/man3/nan.3:75 build/C/man3/pow10.3:49 build/C/man3/remquo.3:124 build/C/man3/round.3:88 build/C/man3/scalbln.3:160 build/C/man3/sincos.3:75 build/C/man3/tgamma.3:162 build/C/man3/trunc.3:75
1906 msgid "These functions first appeared in glibc in version 2.1."
1907 msgstr ""
1908
1909 #. type: Plain text
1910 #: build/C/man3/exp10.3:79
1911 msgid "These functions are GNU extensions."
1912 msgstr ""
1913
1914 #. type: Plain text
1915 #: build/C/man3/exp10.3:85
1916 msgid "B<cbrt>(3), B<exp>(3), B<exp2>(3), B<log10>(3), B<sqrt>(3)"
1917 msgstr ""
1918
1919 #. type: TH
1920 #: build/C/man3/exp2.3:36
1921 #, no-wrap
1922 msgid "EXP2"
1923 msgstr ""
1924
1925 #. type: Plain text
1926 #: build/C/man3/exp2.3:39
1927 msgid "exp2, exp2f, exp2l - base-2 exponential function"
1928 msgstr ""
1929
1930 #. type: Plain text
1931 #: build/C/man3/exp2.3:44
1932 #, no-wrap
1933 msgid "B<double exp2(double >I<x>B<);>\n"
1934 msgstr ""
1935
1936 #. type: Plain text
1937 #: build/C/man3/exp2.3:46
1938 #, no-wrap
1939 msgid "B<float exp2f(float >I<x>B<);>\n"
1940 msgstr ""
1941
1942 #. type: Plain text
1943 #: build/C/man3/exp2.3:48
1944 #, no-wrap
1945 msgid "B<long double exp2l(long double >I<x>B<);>\n"
1946 msgstr ""
1947
1948 #. type: Plain text
1949 #: build/C/man3/exp2.3:61
1950 msgid "B<exp2>(), B<exp2f>(), B<exp2l>():"
1951 msgstr ""
1952
1953 #. type: Plain text
1954 #: build/C/man3/exp2.3:74
1955 msgid "The B<exp2>()  function returns the value of 2 raised to the power of I<x>."
1956 msgstr ""
1957
1958 #. type: Plain text
1959 #: build/C/man3/exp2.3:77
1960 msgid "On success, these functions return the base-2 exponential value of I<x>."
1961 msgstr ""
1962
1963 #. type: Plain text
1964 #: build/C/man3/exp2.3:103
1965 msgid "B<cbrt>(3), B<cexp2>(3), B<exp>(3), B<exp10>(3), B<sqrt>(3)"
1966 msgstr ""
1967
1968 #. type: TH
1969 #: build/C/man3/expm1.3:30
1970 #, no-wrap
1971 msgid "EXPM1"
1972 msgstr ""
1973
1974 #. type: TH
1975 #: build/C/man3/expm1.3:30 build/C/man3/log2.3:36 build/C/man3/pow.3:35
1976 #, no-wrap
1977 msgid "2010-09-12"
1978 msgstr ""
1979
1980 #. type: Plain text
1981 #: build/C/man3/expm1.3:33
1982 msgid "expm1, expm1f, expm1l - exponential minus 1"
1983 msgstr ""
1984
1985 #. type: Plain text
1986 #: build/C/man3/expm1.3:38
1987 #, no-wrap
1988 msgid "B<double expm1(double >I<x>B<);>\n"
1989 msgstr ""
1990
1991 #. type: Plain text
1992 #: build/C/man3/expm1.3:40
1993 #, no-wrap
1994 msgid "B<float expm1f(float >I<x>B<);>\n"
1995 msgstr ""
1996
1997 #. type: Plain text
1998 #: build/C/man3/expm1.3:42
1999 #, no-wrap
2000 msgid "B<long double expm1l(long double >I<x>B<);>\n"
2001 msgstr ""
2002
2003 #. type: Plain text
2004 #: build/C/man3/expm1.3:53
2005 msgid "B<expm1>():"
2006 msgstr ""
2007
2008 #. type: Plain text
2009 #: build/C/man3/expm1.3:64
2010 msgid "B<expm1f>(), B<expm1l>():"
2011 msgstr ""
2012
2013 #. type: Plain text
2014 #: build/C/man3/expm1.3:75
2015 msgid "I<expm1(x)> returns a value equivalent to"
2016 msgstr ""
2017
2018 #. type: Plain text
2019 #: build/C/man3/expm1.3:78
2020 #, no-wrap
2021 msgid "    exp(x) - 1\n"
2022 msgstr ""
2023
2024 #. type: Plain text
2025 #: build/C/man3/expm1.3:88
2026 msgid ""
2027 "It is computed in a way that is accurate even if the value of I<x> is near "
2028 "zero\\(ema case where I<exp(x) - 1> would be inaccurate due to subtraction "
2029 "of two numbers that are nearly equal."
2030 msgstr ""
2031
2032 #. type: Plain text
2033 #: build/C/man3/expm1.3:91
2034 msgid "On success, these functions return I<exp(x)\\ -\\ 1>."
2035 msgstr ""
2036
2037 #. type: Plain text
2038 #: build/C/man3/expm1.3:109
2039 msgid "If I<x> is negative infinity, -1 is returned."
2040 msgstr ""
2041
2042 #. type: Plain text
2043 #: build/C/man3/expm1.3:117
2044 msgid ""
2045 "If the result overflows, a range error occurs, and the functions return "
2046 "-B<HUGE_VAL>, -B<HUGE_VALF>, or -B<HUGE_VALL>, respectively."
2047 msgstr ""
2048
2049 #
2050 #.  POSIX.1 specifies an optional range error (underflow) if
2051 #.  x is subnormal.  Glibc does not implement this.
2052 #. type: Plain text
2053 #: build/C/man3/expm1.3:136
2054 msgid ""
2055 "I<errno> is set to B<ERANGE> (but see BUGS).  An overflow floating-point "
2056 "exception (B<FE_OVERFLOW>)  is raised."
2057 msgstr ""
2058
2059 #.  FIXME .
2060 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778
2061 #. type: Plain text
2062 #: build/C/man3/expm1.3:147
2063 msgid ""
2064 "For some large negative I<x> values (where the function result approaches "
2065 "-1), B<expm1>()  raises a bogus underflow floating-point exception."
2066 msgstr ""
2067
2068 #.  FIXME .
2069 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814
2070 #.  e.g., expm1(1e5) through expm1(1.00199970127e5),
2071 #.  but not expm1(1.00199970128e5) and beyond.
2072 #. type: Plain text
2073 #: build/C/man3/expm1.3:158
2074 msgid ""
2075 "For some large positive I<x> values, B<expm1>()  raises a bogus invalid "
2076 "floating-point exception in addition to the expected overflow exception, and "
2077 "returns a NaN instead of positive infinity."
2078 msgstr ""
2079
2080 #.  It looks like the fix was in 2.11, or possibly 2.12.
2081 #.  I have no test system for 2.11, but 2.12 passes.
2082 #.  From the source (sysdeps/i386/fpu/s_expm1.S) it looks
2083 #.  like the changes were in 2.11.
2084 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788
2085 #. type: Plain text
2086 #: build/C/man3/expm1.3:170
2087 msgid ""
2088 "Before version 2.11, the glibc implementation did not set I<errno> to "
2089 "B<ERANGE> when a range error occurred."
2090 msgstr ""
2091
2092 #. type: Plain text
2093 #: build/C/man3/expm1.3:174
2094 msgid "B<exp>(3), B<log>(3), B<log1p>(3)"
2095 msgstr ""
2096
2097 #. type: TH
2098 #: build/C/man3/fabs.3:32
2099 #, no-wrap
2100 msgid "FABS"
2101 msgstr ""
2102
2103 #. type: TH
2104 #: build/C/man3/fabs.3:32
2105 #, no-wrap
2106 msgid "2013-07-10"
2107 msgstr ""
2108
2109 #. type: Plain text
2110 #: build/C/man3/fabs.3:35
2111 msgid "fabs, fabsf, fabsl - absolute value of floating-point number"
2112 msgstr ""
2113
2114 #. type: Plain text
2115 #: build/C/man3/fabs.3:40
2116 #, no-wrap
2117 msgid "B<double fabs(double >I<x>B<);>\n"
2118 msgstr ""
2119
2120 #. type: Plain text
2121 #: build/C/man3/fabs.3:42
2122 #, no-wrap
2123 msgid "B<float fabsf(float >I<x>B<);>\n"
2124 msgstr ""
2125
2126 #. type: Plain text
2127 #: build/C/man3/fabs.3:44
2128 #, no-wrap
2129 msgid "B<long double fabsl(long double >I<x>B<);>\n"
2130 msgstr ""
2131
2132 #. type: Plain text
2133 #: build/C/man3/fabs.3:56
2134 msgid "B<fabsf>(), B<fabsl>():"
2135 msgstr ""
2136
2137 #. type: Plain text
2138 #: build/C/man3/fabs.3:68
2139 msgid "These functions return the absolute value of the floating-point number I<x>."
2140 msgstr ""
2141
2142 #. type: Plain text
2143 #: build/C/man3/fabs.3:71
2144 msgid "These functions return the absolute value of I<x>."
2145 msgstr ""
2146
2147 #. type: Plain text
2148 #: build/C/man3/fabs.3:79
2149 msgid "If I<x> is -0, +0 is returned."
2150 msgstr ""
2151
2152 #. type: Plain text
2153 #: build/C/man3/fabs.3:83
2154 msgid ""
2155 "If I<x> is negative infinity or positive infinity, positive infinity is "
2156 "returned."
2157 msgstr ""
2158
2159 #. type: Plain text
2160 #: build/C/man3/fabs.3:93
2161 msgid "The B<fabs>(), B<fabsf>(), and B<fabsl>()  functions are thread-safe."
2162 msgstr ""
2163
2164 #. type: Plain text
2165 #: build/C/man3/fabs.3:106
2166 msgid "B<abs>(3), B<cabs>(3), B<ceil>(3), B<floor>(3), B<labs>(3), B<rint>(3)"
2167 msgstr ""
2168
2169 #. type: TH
2170 #: build/C/man3/fdim.3:9
2171 #, no-wrap
2172 msgid "FDIM"
2173 msgstr ""
2174
2175 #. type: TH
2176 #: build/C/man3/fdim.3:9
2177 #, no-wrap
2178 msgid "2013-07-15"
2179 msgstr ""
2180
2181 #. type: Plain text
2182 #: build/C/man3/fdim.3:12
2183 msgid "fdim, fdimf, fdiml - positive difference"
2184 msgstr ""
2185
2186 #. type: Plain text
2187 #: build/C/man3/fdim.3:14 build/C/man3/fmax.3:14 build/C/man3/fmin.3:14 build/C/man3/gamma.3:14 build/C/man3/ilogb.3:34 build/C/man3/logb.3:34 build/C/man3/nan.3:16 build/C/man3/nextafter.3:17 build/C/man3/scalb.3:33 build/C/man3/scalbln.3:33 build/C/man3/signbit.3:16 build/C/man3/significand.3:15 build/C/man3/tgamma.3:18
2188 msgid "B<#include E<lt>math.hE<gt>>"
2189 msgstr ""
2190
2191 #. type: Plain text
2192 #: build/C/man3/fdim.3:16
2193 msgid "B<double fdim(double >I<x>B<, double >I<y>B<);>"
2194 msgstr ""
2195
2196 #. type: Plain text
2197 #: build/C/man3/fdim.3:18
2198 msgid "B<float fdimf(float >I<x>B<, float >I<y>B<);>"
2199 msgstr ""
2200
2201 #. type: Plain text
2202 #: build/C/man3/fdim.3:20
2203 msgid "B<long double fdiml(long double >I<x>B<, long double >I<y>B<);>"
2204 msgstr ""
2205
2206 #. type: Plain text
2207 #: build/C/man3/fdim.3:31
2208 msgid "B<fdimf>(), B<fdiml>():"
2209 msgstr ""
2210
2211 #. type: Plain text
2212 #: build/C/man3/fdim.3:42
2213 msgid ""
2214 "These functions return the positive difference, max(I<x>-I<y>,0), between "
2215 "their arguments."
2216 msgstr ""
2217
2218 #. type: Plain text
2219 #: build/C/man3/fdim.3:44
2220 msgid "On success, these functions return the positive difference."
2221 msgstr ""
2222
2223 #. type: Plain text
2224 #: build/C/man3/fdim.3:50 build/C/man3/fma.3:63 build/C/man3/fmod.3:102 build/C/man3/nextafter.3:121 build/C/man3/remainder.3:130 build/C/man3/remquo.3:83
2225 msgid "If I<x> or I<y> is a NaN, a NaN is returned."
2226 msgstr ""
2227
2228 #. type: Plain text
2229 #: build/C/man3/fdim.3:59 build/C/man3/hypot.3:122
2230 msgid ""
2231 "If the result overflows, a range error occurs, and the functions return "
2232 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively."
2233 msgstr ""
2234
2235 #.  Unable to test this case, since the best approximation of
2236 #.  pi/2 in double precision only yields a tan() value of 1.633e16.
2237 #.  .I errno
2238 #.  is set to
2239 #.  .BR ERANGE .
2240 #. type: Plain text
2241 #: build/C/man3/fdim.3:74 build/C/man3/fma.3:141 build/C/man3/nextafter.3:159 build/C/man3/scalb.3:163 build/C/man3/scalbln.3:145 build/C/man3/tan.3:133
2242 msgid "An overflow floating-point exception (B<FE_OVERFLOW>)  is raised."
2243 msgstr ""
2244
2245 #. type: Plain text
2246 #: build/C/man3/fdim.3:89
2247 msgid "The B<fdim>(), B<fdimf>(), and B<fdiml>()  functions are thread-safe."
2248 msgstr ""
2249
2250 #. type: Plain text
2251 #: build/C/man3/fdim.3:93 build/C/man3/fmin.3:62
2252 msgid "B<fmax>(3)"
2253 msgstr ""
2254
2255 #. type: TH
2256 #: build/C/man3/fenv.3:27
2257 #, no-wrap
2258 msgid "FENV"
2259 msgstr ""
2260
2261 #. type: TH
2262 #: build/C/man3/fenv.3:27
2263 #, no-wrap
2264 msgid "2010-10-31"
2265 msgstr ""
2266
2267 #. type: TH
2268 #: build/C/man3/fenv.3:27 build/C/man7/math_error.7:26 build/C/man3/matherr.3:27
2269 #, no-wrap
2270 msgid "Linux"
2271 msgstr ""
2272
2273 #. type: Plain text
2274 #: build/C/man3/fenv.3:33
2275 msgid ""
2276 "feclearexcept, fegetexceptflag, feraiseexcept, fesetexceptflag, "
2277 "fetestexcept, fegetenv, fegetround, feholdexcept, fesetround, fesetenv, "
2278 "feupdateenv, feenableexcept, fedisableexcept, fegetexcept - floating-point "
2279 "rounding and exception handling"
2280 msgstr ""
2281
2282 #. type: Plain text
2283 #: build/C/man3/fenv.3:36 build/C/man3/fenv.3:292
2284 #, no-wrap
2285 msgid "B<#include E<lt>fenv.hE<gt>>\n"
2286 msgstr ""
2287
2288 #. type: Plain text
2289 #: build/C/man3/fenv.3:38
2290 #, no-wrap
2291 msgid "B<int feclearexcept(int >I<excepts>B<);>\n"
2292 msgstr ""
2293
2294 #. type: Plain text
2295 #: build/C/man3/fenv.3:40
2296 #, no-wrap
2297 msgid "B<int fegetexceptflag(fexcept_t *>I<flagp>B<, int >I<excepts>B<);>\n"
2298 msgstr ""
2299
2300 #. type: Plain text
2301 #: build/C/man3/fenv.3:42
2302 #, no-wrap
2303 msgid "B<int feraiseexcept(int >I<excepts>B<);>\n"
2304 msgstr ""
2305
2306 #. type: Plain text
2307 #: build/C/man3/fenv.3:44
2308 #, no-wrap
2309 msgid "B<int fesetexceptflag(const fexcept_t *>I<flagp>B<, int >I<excepts>B<);>\n"
2310 msgstr ""
2311
2312 #. type: Plain text
2313 #: build/C/man3/fenv.3:46
2314 #, no-wrap
2315 msgid "B<int fetestexcept(int >I<excepts>B<);>\n"
2316 msgstr ""
2317
2318 #. type: Plain text
2319 #: build/C/man3/fenv.3:48
2320 #, no-wrap
2321 msgid "B<int fegetround(void);>\n"
2322 msgstr ""
2323
2324 #. type: Plain text
2325 #: build/C/man3/fenv.3:50
2326 #, no-wrap
2327 msgid "B<int fesetround(int >I<rounding_mode>B<);>\n"
2328 msgstr ""
2329
2330 #. type: Plain text
2331 #: build/C/man3/fenv.3:52
2332 #, no-wrap
2333 msgid "B<int fegetenv(fenv_t *>I<envp>B<);>\n"
2334 msgstr ""
2335
2336 #. type: Plain text
2337 #: build/C/man3/fenv.3:54
2338 #, no-wrap
2339 msgid "B<int feholdexcept(fenv_t *>I<envp>B<);>\n"
2340 msgstr ""
2341
2342 #. type: Plain text
2343 #: build/C/man3/fenv.3:56
2344 #, no-wrap
2345 msgid "B<int fesetenv(const fenv_t *>I<envp>B<);>\n"
2346 msgstr ""
2347
2348 #. type: Plain text
2349 #: build/C/man3/fenv.3:58
2350 #, no-wrap
2351 msgid "B<int feupdateenv(const fenv_t *>I<envp>B<);>\n"
2352 msgstr ""
2353
2354 #. type: Plain text
2355 #: build/C/man3/fenv.3:64
2356 msgid ""
2357 "These eleven functions were defined in C99, and describe the handling of "
2358 "floating-point rounding and exceptions (overflow, zero-divide, etc.)."
2359 msgstr ""
2360
2361 #. type: SS
2362 #: build/C/man3/fenv.3:64
2363 #, no-wrap
2364 msgid "Exceptions"
2365 msgstr ""
2366
2367 #. type: Plain text
2368 #: build/C/man3/fenv.3:69
2369 msgid ""
2370 "The I<divide-by-zero> exception occurs when an operation on finite numbers "
2371 "produces infinity as exact answer."
2372 msgstr ""
2373
2374 #. type: Plain text
2375 #: build/C/man3/fenv.3:75
2376 msgid ""
2377 "The I<overflow> exception occurs when a result has to be represented as a "
2378 "floating-point number, but has (much) larger absolute value than the largest "
2379 "(finite) floating-point number that is representable."
2380 msgstr ""
2381
2382 #. type: Plain text
2383 #: build/C/man3/fenv.3:82
2384 msgid ""
2385 "The I<underflow> exception occurs when a result has to be represented as a "
2386 "floating-point number, but has smaller absolute value than the smallest "
2387 "positive normalized floating-point number (and would lose much accuracy when "
2388 "represented as a denormalized number)."
2389 msgstr ""
2390
2391 #. type: Plain text
2392 #: build/C/man3/fenv.3:92
2393 msgid ""
2394 "The I<inexact> exception occurs when the rounded result of an operation is "
2395 "not equal to the infinite precision result.  It may occur whenever "
2396 "I<overflow> or I<underflow> occurs."
2397 msgstr ""
2398
2399 #. type: Plain text
2400 #: build/C/man3/fenv.3:97
2401 msgid ""
2402 "The I<invalid> exception occurs when there is no well-defined result for an "
2403 "operation, as for 0/0 or infinity - infinity or sqrt(-1)."
2404 msgstr ""
2405
2406 #. type: SS
2407 #: build/C/man3/fenv.3:97
2408 #, no-wrap
2409 msgid "Exception handling"
2410 msgstr ""
2411
2412 #. type: Plain text
2413 #: build/C/man3/fenv.3:103
2414 msgid ""
2415 "Exceptions are represented in two ways: as a single bit (exception "
2416 "present/absent), and these bits correspond in some implementation-defined "
2417 "way with bit positions in an integer, and also as an opaque structure that "
2418 "may contain more information about the exception (perhaps the code address "
2419 "where it occurred)."
2420 msgstr ""
2421
2422 #. type: Plain text
2423 #: build/C/man3/fenv.3:119
2424 msgid ""
2425 "Each of the macros B<FE_DIVBYZERO>, B<FE_INEXACT>, B<FE_INVALID>, "
2426 "B<FE_OVERFLOW>, B<FE_UNDERFLOW> is defined when the implementation supports "
2427 "handling of the corresponding exception, and if so then defines the "
2428 "corresponding bit(s), so that one can call exception handling functions, for "
2429 "example, using the integer argument B<FE_OVERFLOW>|B<FE_UNDERFLOW>.  Other "
2430 "exceptions may be supported.  The macro B<FE_ALL_EXCEPT> is the bitwise OR "
2431 "of all bits corresponding to supported exceptions."
2432 msgstr ""
2433
2434 #. type: Plain text
2435 #: build/C/man3/fenv.3:124
2436 msgid ""
2437 "The B<feclearexcept>()  function clears the supported exceptions represented "
2438 "by the bits in its argument."
2439 msgstr ""
2440
2441 #. type: Plain text
2442 #: build/C/man3/fenv.3:132
2443 msgid ""
2444 "The B<fegetexceptflag>()  function stores a representation of the state of "
2445 "the exception flags represented by the argument I<excepts> in the opaque "
2446 "object I<*flagp>."
2447 msgstr ""
2448
2449 #. type: Plain text
2450 #: build/C/man3/fenv.3:137
2451 msgid ""
2452 "The B<feraiseexcept>()  function raises the supported exceptions represented "
2453 "by the bits in I<excepts>."
2454 msgstr ""
2455
2456 #. type: Plain text
2457 #: build/C/man3/fenv.3:148
2458 msgid ""
2459 "The B<fesetexceptflag>()  function sets the complete status for the "
2460 "exceptions represented by I<excepts> to the value I<*flagp>.  This value "
2461 "must have been obtained by an earlier call of B<fegetexceptflag>()  with a "
2462 "last argument that contained all bits in I<excepts>."
2463 msgstr ""
2464
2465 #. type: Plain text
2466 #: build/C/man3/fenv.3:155
2467 msgid ""
2468 "The B<fetestexcept>()  function returns a word in which the bits are set "
2469 "that were set in the argument I<excepts> and for which the corresponding "
2470 "exception is currently set."
2471 msgstr ""
2472
2473 #. type: SS
2474 #: build/C/man3/fenv.3:155
2475 #, no-wrap
2476 msgid "Rounding mode"
2477 msgstr ""
2478
2479 #. type: Plain text
2480 #: build/C/man3/fenv.3:163
2481 msgid ""
2482 "The rounding mode determines how the result of floating-point operations is "
2483 "treated when the result cannot be exactly represented in the significand.  "
2484 "Various rounding modes may be provided: round to nearest (the default), "
2485 "round up (toward positive infinity), round down (toward negative infinity), "
2486 "and round toward zero."
2487 msgstr ""
2488
2489 #. type: Plain text
2490 #: build/C/man3/fenv.3:172
2491 msgid ""
2492 "Each of the macros B<FE_TONEAREST>, B<FE_UPWARD>, B<FE_DOWNWARD>, and "
2493 "B<FE_TOWARDZERO> is defined when the implementation supports getting and "
2494 "setting the corresponding rounding direction."
2495 msgstr ""
2496
2497 #. type: Plain text
2498 #: build/C/man3/fenv.3:177
2499 msgid ""
2500 "The B<fegetround>()  function returns the macro corresponding to the current "
2501 "rounding mode."
2502 msgstr ""
2503
2504 #. type: Plain text
2505 #: build/C/man3/fenv.3:182
2506 msgid ""
2507 "The B<fesetround>()  function sets the rounding mode as specified by its "
2508 "argument and returns zero when it was successful."
2509 msgstr ""
2510
2511 #. type: Plain text
2512 #: build/C/man3/fenv.3:190
2513 msgid ""
2514 "C99 and POSIX.1-2008 specify an identifier, B<FLT_ROUNDS>, defined in "
2515 "I<E<lt>float.hE<gt>>, which indicates the implementation-defined rounding "
2516 "behavior for floating-point addition.  This identifier has one of the "
2517 "following values:"
2518 msgstr ""
2519
2520 #. type: IP
2521 #: build/C/man3/fenv.3:190
2522 #, no-wrap
2523 msgid "-1"
2524 msgstr ""
2525
2526 #. type: Plain text
2527 #: build/C/man3/fenv.3:192
2528 msgid "The rounding mode is not determinable."
2529 msgstr ""
2530
2531 #. type: IP
2532 #: build/C/man3/fenv.3:192
2533 #, no-wrap
2534 msgid "0"
2535 msgstr ""
2536
2537 #. type: Plain text
2538 #: build/C/man3/fenv.3:194
2539 msgid "Rounding is toward 0."
2540 msgstr ""
2541
2542 #. type: IP
2543 #: build/C/man3/fenv.3:194
2544 #, no-wrap
2545 msgid "1"
2546 msgstr ""
2547
2548 #. type: Plain text
2549 #: build/C/man3/fenv.3:196
2550 msgid "Rounding is toward nearest number."
2551 msgstr ""
2552
2553 #. type: IP
2554 #: build/C/man3/fenv.3:196
2555 #, no-wrap
2556 msgid "2"
2557 msgstr ""
2558
2559 #. type: Plain text
2560 #: build/C/man3/fenv.3:198
2561 msgid "Rounding is toward positive infinity."
2562 msgstr ""
2563
2564 #. type: IP
2565 #: build/C/man3/fenv.3:198
2566 #, no-wrap
2567 msgid "3"
2568 msgstr ""
2569
2570 #. type: Plain text
2571 #: build/C/man3/fenv.3:200
2572 msgid "Rounding is toward negative infinity."
2573 msgstr ""
2574
2575 #. type: Plain text
2576 #: build/C/man3/fenv.3:202
2577 msgid "Other values represent machine-dependent, nonstandard rounding modes."
2578 msgstr ""
2579
2580 #. type: Plain text
2581 #: build/C/man3/fenv.3:208
2582 msgid ""
2583 "The value of B<FLT_ROUNDS> should reflect the current rounding mode as set "
2584 "by B<fesetround>()  (but see BUGS)."
2585 msgstr ""
2586
2587 #. type: SS
2588 #: build/C/man3/fenv.3:208
2589 #, no-wrap
2590 msgid "Floating-point environment"
2591 msgstr ""
2592
2593 #. type: Plain text
2594 #: build/C/man3/fenv.3:220
2595 msgid ""
2596 "The entire floating-point environment, including control modes and status "
2597 "flags, can be handled as one opaque object, of type I<fenv_t>.  The default "
2598 "environment is denoted by B<FE_DFL_ENV> (of type I<const fenv_t\\ *>).  This "
2599 "is the environment setup at program start and it is defined by ISO C to have "
2600 "round to nearest, all exceptions cleared and a nonstop (continue on "
2601 "exceptions) mode."
2602 msgstr ""
2603
2604 #. type: Plain text
2605 #: build/C/man3/fenv.3:225
2606 msgid ""
2607 "The B<fegetenv>()  function saves the current floating-point environment in "
2608 "the object I<*envp>."
2609 msgstr ""
2610
2611 #. type: Plain text
2612 #: build/C/man3/fenv.3:232
2613 msgid ""
2614 "The B<feholdexcept>()  function does the same, then clears all exception "
2615 "flags, and sets a nonstop (continue on exceptions) mode, if available.  It "
2616 "returns zero when successful."
2617 msgstr ""
2618
2619 #. type: Plain text
2620 #: build/C/man3/fenv.3:245
2621 msgid ""
2622 "The B<fesetenv>()  function restores the floating-point environment from the "
2623 "object I<*envp>.  This object must be known to be valid, for example, the "
2624 "result of a call to B<fegetenv>()  or B<feholdexcept>()  or equal to "
2625 "B<FE_DFL_ENV>.  This call does not raise exceptions."
2626 msgstr ""
2627
2628 #. type: Plain text
2629 #: build/C/man3/fenv.3:258
2630 msgid ""
2631 "The B<feupdateenv>()  function installs the floating-point environment "
2632 "represented by the object I<*envp>, except that currently raised exceptions "
2633 "are not cleared.  After calling this function, the raised exceptions will be "
2634 "a bitwise OR of those previously set with those in I<*envp>.  As before, the "
2635 "object I<*envp> must be known to be valid."
2636 msgstr ""
2637
2638 #.  Earlier seven of these functions were listed as returning void.
2639 #.  This was corrected in Corrigendum 1 (ISO/IEC 9899:1999/Cor.1:2001(E))
2640 #.  of the C99 Standard.
2641 #. type: Plain text
2642 #: build/C/man3/fenv.3:263
2643 msgid "These functions return zero on success and nonzero if an error occurred."
2644 msgstr ""
2645
2646 #. type: Plain text
2647 #: build/C/man3/fenv.3:267
2648 msgid "IEC 60559 (IEC 559:1989), ANSI/IEEE 854, C99, POSIX.1-2001."
2649 msgstr ""
2650
2651 #. type: SS
2652 #: build/C/man3/fenv.3:268
2653 #, no-wrap
2654 msgid "Glibc notes"
2655 msgstr ""
2656
2657 #. type: Plain text
2658 #: build/C/man3/fenv.3:287
2659 msgid ""
2660 "If possible, the GNU C Library defines a macro B<FE_NOMASK_ENV> which "
2661 "represents an environment where every exception raised causes a trap to "
2662 "occur.  You can test for this macro using B<#ifdef>.  It is defined only if "
2663 "B<_GNU_SOURCE> is defined.  The C99 standard does not define a way to set "
2664 "individual bits in the floating-point mask, for example, to trap on specific "
2665 "flags.  Since version 2.2, glibc supports the functions B<feenableexcept>()  "
2666 "and B<fedisableexcept>()  to set individual floating-point traps, and "
2667 "B<fegetexcept>()  to query the state."
2668 msgstr ""
2669
2670 #. type: Plain text
2671 #: build/C/man3/fenv.3:294
2672 #, no-wrap
2673 msgid "B<int feenableexcept(int >I<excepts>B<);>\n"
2674 msgstr ""
2675
2676 #. type: Plain text
2677 #: build/C/man3/fenv.3:296
2678 #, no-wrap
2679 msgid "B<int fedisableexcept(int >I<excepts>B<);>\n"
2680 msgstr ""
2681
2682 #. type: Plain text
2683 #: build/C/man3/fenv.3:298
2684 #, no-wrap
2685 msgid "B<int fegetexcept(void);>\n"
2686 msgstr ""
2687
2688 #. type: Plain text
2689 #: build/C/man3/fenv.3:312
2690 msgid ""
2691 "The B<feenableexcept>()  and B<fedisableexcept>()  functions enable "
2692 "(disable) traps for each of the exceptions represented by I<excepts> and "
2693 "return the previous set of enabled exceptions when successful, and -1 "
2694 "otherwise.  The B<fegetexcept>()  function returns the set of all currently "
2695 "enabled exceptions."
2696 msgstr ""
2697
2698 #.  Aug 08, glibc 2.8
2699 #.  See http://gcc.gnu.org/ml/gcc/2002-02/msg01535.html
2700 #. type: Plain text
2701 #: build/C/man3/fenv.3:323
2702 msgid ""
2703 "C99 specifies that the value of B<FLT_ROUNDS> should reflect changes to the "
2704 "current rounding mode, as set by B<fesetround>().  Currently, this does not "
2705 "occur: B<FLT_ROUNDS> always has the value 1."
2706 msgstr ""
2707
2708 #. type: Plain text
2709 #: build/C/man3/fenv.3:325
2710 msgid "B<math_error>(7)"
2711 msgstr ""
2712
2713 #. type: TH
2714 #: build/C/man3/finite.3:25
2715 #, no-wrap
2716 msgid "FINITE"
2717 msgstr ""
2718
2719 #. type: TH
2720 #: build/C/man3/finite.3:25
2721 #, no-wrap
2722 msgid "2013-07-22"
2723 msgstr ""
2724
2725 #. type: Plain text
2726 #: build/C/man3/finite.3:29
2727 msgid ""
2728 "finite, finitef, finitel, isinf, isinff, isinfl, isnan, isnanf, isnanl - BSD "
2729 "floating-point classification functions"
2730 msgstr ""
2731
2732 #. type: Plain text
2733 #: build/C/man3/finite.3:34
2734 #, no-wrap
2735 msgid "B<int finite(double >I<x>B<);>\n"
2736 msgstr ""
2737
2738 #. type: Plain text
2739 #: build/C/man3/finite.3:36
2740 #, no-wrap
2741 msgid "B<int finitef(float >I<x>B<);>\n"
2742 msgstr ""
2743
2744 #. type: Plain text
2745 #: build/C/man3/finite.3:38
2746 #, no-wrap
2747 msgid "B<int finitel(long double >I<x>B<);>\n"
2748 msgstr ""
2749
2750 #. type: Plain text
2751 #: build/C/man3/finite.3:40
2752 #, no-wrap
2753 msgid "B<int isinf(double >I<x>B<);>\n"
2754 msgstr ""
2755
2756 #. type: Plain text
2757 #: build/C/man3/finite.3:42
2758 #, no-wrap
2759 msgid "B<int isinff(float >I<x>B<);>\n"
2760 msgstr ""
2761
2762 #. type: Plain text
2763 #: build/C/man3/finite.3:44
2764 #, no-wrap
2765 msgid "B<int isinfl(long double >I<x>B<);>\n"
2766 msgstr ""
2767
2768 #. type: Plain text
2769 #: build/C/man3/finite.3:46
2770 #, no-wrap
2771 msgid "B<int isnan(double >I<x>B<);>\n"
2772 msgstr ""
2773
2774 #. type: Plain text
2775 #: build/C/man3/finite.3:48
2776 #, no-wrap
2777 msgid "B<int isnanf(float >I<x>B<);>\n"
2778 msgstr ""
2779
2780 #. type: Plain text
2781 #: build/C/man3/finite.3:50
2782 #, no-wrap
2783 msgid "B<int isnanl(long double >I<x>B<);>\n"
2784 msgstr ""
2785
2786 #. type: Plain text
2787 #: build/C/man3/finite.3:61
2788 msgid "B<finite>(), B<finitef>(), B<finitel>():"
2789 msgstr ""
2790
2791 #. type: Plain text
2792 #: build/C/man3/finite.3:63 build/C/man3/finite.3:76 build/C/man3/lgamma.3:65
2793 msgid "_BSD_SOURCE || _SVID_SOURCE"
2794 msgstr ""
2795
2796 #. type: Plain text
2797 #: build/C/man3/finite.3:65 build/C/man3/fpclassify.3:58
2798 msgid "B<isinf>():"
2799 msgstr ""
2800
2801 #. type: Plain text
2802 #: build/C/man3/finite.3:67
2803 msgid ""
2804 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
2805 "_ISOC99_SOURCE;"
2806 msgstr ""
2807
2808 #. type: Plain text
2809 #: build/C/man3/finite.3:74
2810 msgid "B<isinff>(), B<isinfl>():"
2811 msgstr ""
2812
2813 #. type: Plain text
2814 #: build/C/man3/finite.3:78 build/C/man3/fpclassify.3:50
2815 msgid "B<isnan>():"
2816 msgstr ""
2817
2818 #. type: Plain text
2819 #: build/C/man3/finite.3:80
2820 msgid "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE;"
2821 msgstr ""
2822
2823 #. type: Plain text
2824 #: build/C/man3/finite.3:86
2825 msgid "B<isnanf>(), B<isnanl>():"
2826 msgstr ""
2827
2828 #. type: Plain text
2829 #: build/C/man3/finite.3:88 build/C/man3/gamma.3:38 build/C/man3/scalb.3:58
2830 msgid "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600"
2831 msgstr ""
2832
2833 #. type: Plain text
2834 #: build/C/man3/finite.3:100
2835 msgid ""
2836 "The B<finite>(), B<finitef>(), and B<finitel>()  functions return a nonzero "
2837 "value if I<x> is neither infinite nor a \"not-a-number\" (NaN) value, and 0 "
2838 "otherwise."
2839 msgstr ""
2840
2841 #. type: Plain text
2842 #: build/C/man3/finite.3:110
2843 msgid ""
2844 "The B<isnan>(), B<isnanf>(), and B<isnanl>()  functions return a nonzero "
2845 "value if I<x> is a NaN value, and 0 otherwise."
2846 msgstr ""
2847
2848 #. type: Plain text
2849 #: build/C/man3/finite.3:121
2850 msgid ""
2851 "The B<isinf>(), B<isinff>(), and B<isinfl>()  functions return 1 if I<x> is "
2852 "positive infinity, -1 if I<x> is negative infinity, and 0 otherwise."
2853 msgstr ""
2854
2855 #. type: Plain text
2856 #: build/C/man3/finite.3:135
2857 msgid ""
2858 "The B<finite>(), B<finitef>(), B<finitel>(), B<isinf>(), B<isinff>(), "
2859 "B<isinfl>(), B<isnan>(), B<isnanf>(), and B<isnanl>()  functions are "
2860 "thread-safe."
2861 msgstr ""
2862
2863 #
2864 #.  finite* not on HP-UX; they exist on Tru64.
2865 #.  .SH HISTORY
2866 #.  The
2867 #.  .BR finite ()
2868 #.  function occurs in 4.3BSD.
2869 #.  see IEEE.3 in the 4.3BSD manual
2870 #. type: Plain text
2871 #: build/C/man3/finite.3:155
2872 msgid ""
2873 "Note that these functions are obsolete.  C99 defines macros B<isfinite>(), "
2874 "B<isinf>(), and B<isnan>()  (for all types) replacing them.  Further note "
2875 "that the C99 B<isinf>()  has weaker guarantees on the return value.  See "
2876 "B<fpclassify>(3)."
2877 msgstr ""
2878
2879 #. type: Plain text
2880 #: build/C/man3/finite.3:157
2881 msgid "B<fpclassify>(3)"
2882 msgstr ""
2883
2884 #. type: TH
2885 #: build/C/man3/floor.3:27
2886 #, no-wrap
2887 msgid "FLOOR"
2888 msgstr ""
2889
2890 #. type: TH
2891 #: build/C/man3/floor.3:27
2892 #, no-wrap
2893 msgid "2013-07-23"
2894 msgstr ""
2895
2896 #. type: Plain text
2897 #: build/C/man3/floor.3:30
2898 msgid "floor, floorf, floorl - largest integral value not greater than argument"
2899 msgstr ""
2900
2901 #. type: Plain text
2902 #: build/C/man3/floor.3:35
2903 #, no-wrap
2904 msgid "B<double floor(double >I<x>B<);>\n"
2905 msgstr ""
2906
2907 #. type: Plain text
2908 #: build/C/man3/floor.3:37
2909 #, no-wrap
2910 msgid "B<float floorf(float >I<x>B<);>\n"
2911 msgstr ""
2912
2913 #. type: Plain text
2914 #: build/C/man3/floor.3:39
2915 #, no-wrap
2916 msgid "B<long double floorl(long double >I<x>B<);>\n"
2917 msgstr ""
2918
2919 #. type: Plain text
2920 #: build/C/man3/floor.3:51
2921 msgid "B<floorf>(), B<floorl>():"
2922 msgstr ""
2923
2924 #. type: Plain text
2925 #: build/C/man3/floor.3:62
2926 msgid ""
2927 "These functions return the largest integral value that is not greater than "
2928 "I<x>."
2929 msgstr ""
2930
2931 #. type: Plain text
2932 #: build/C/man3/floor.3:68
2933 msgid "For example, I<floor(0.5)> is 0.0, and I<floor(-0.5)> is -1.0."
2934 msgstr ""
2935
2936 #. type: Plain text
2937 #: build/C/man3/floor.3:71
2938 msgid "These functions return the floor of I<x>."
2939 msgstr ""
2940
2941 #. type: Plain text
2942 #: build/C/man3/floor.3:77
2943 msgid "If I<x> is integral, +0, -0, NaN, or an infinity, I<x> itself is returned."
2944 msgstr ""
2945
2946 #. type: Plain text
2947 #: build/C/man3/floor.3:88
2948 msgid "The B<floor>(), B<floorf>(), and B<floorl>()  functions are thread-safe."
2949 msgstr ""
2950
2951 #. type: Plain text
2952 #: build/C/man3/floor.3:117
2953 msgid ""
2954 "B<ceil>(3), B<lrint>(3), B<nearbyint>(3), B<rint>(3), B<round>(3), "
2955 "B<trunc>(3)"
2956 msgstr ""
2957
2958 #. type: TH
2959 #: build/C/man3/fma.3:12
2960 #, no-wrap
2961 msgid "FMA"
2962 msgstr ""
2963
2964 #. type: Plain text
2965 #: build/C/man3/fma.3:15
2966 msgid "fma, fmaf, fmal - floating-point multiply and add"
2967 msgstr ""
2968
2969 #. type: Plain text
2970 #: build/C/man3/fma.3:20
2971 #, no-wrap
2972 msgid "B<double fma(double >I<x>B<, double >I<y>B<, double >I<z>B<);>\n"
2973 msgstr ""
2974
2975 #. type: Plain text
2976 #: build/C/man3/fma.3:22
2977 #, no-wrap
2978 msgid "B<float fmaf(float >I<x>B<, float >I<y>B<, float >I<z>B<);>\n"
2979 msgstr ""
2980
2981 #. type: Plain text
2982 #: build/C/man3/fma.3:24
2983 #, no-wrap
2984 msgid ""
2985 "B<long double fmal(long double >I<x>B<, long double >I<y>B<, long double "
2986 ">I<z>B<);>\n"
2987 msgstr ""
2988
2989 #. type: Plain text
2990 #: build/C/man3/fma.3:37
2991 msgid "B<fma>(), B<fmaf>(), B<fmal>():"
2992 msgstr ""
2993
2994 #. type: Plain text
2995 #: build/C/man3/fma.3:53
2996 msgid ""
2997 "The B<fma>()  function computes I<x> * I<y> + I<z>.  The result is rounded "
2998 "as one ternary operation according to the current rounding mode (see "
2999 "B<fenv>(3))."
3000 msgstr ""
3001
3002 #. type: Plain text
3003 #: build/C/man3/fma.3:57
3004 msgid ""
3005 "These functions return the value of I<x> * I<y> + I<z>, rounded as one "
3006 "ternary operation."
3007 msgstr ""
3008
3009 #. type: Plain text
3010 #: build/C/man3/fma.3:73
3011 msgid ""
3012 "If I<x> times I<y> is an exact infinity, and I<z> is an infinity with the "
3013 "opposite sign, a domain error occurs, and a NaN is returned."
3014 msgstr ""
3015
3016 #.  POSIX.1-2008 allows some possible differences for the following two
3017 #.  domain error cases, but on Linux they are treated the same (AFAICS).
3018 #.  Nevertheless, we'll mirror POSIX.1 and describe the two cases
3019 #.  separately.
3020 #.  POSIX.1 says that a NaN or an implementation-defined value shall
3021 #.  be returned for this case.
3022 #. type: Plain text
3023 #: build/C/man3/fma.3:89
3024 msgid ""
3025 "If one of I<x> or I<y> is an infinity, the other is 0, and I<z> is not a "
3026 "NaN, a domain error occurs, and a NaN is returned."
3027 msgstr ""
3028
3029 #.  POSIX.1 makes the domain error optional for this case.
3030 #. type: Plain text
3031 #: build/C/man3/fma.3:100
3032 msgid ""
3033 "If one of I<x> or I<y> is an infinity, and the other is 0, and I<z> is a "
3034 "NaN, a domain error occurs, and a NaN is returned."
3035 msgstr ""
3036
3037 #. type: Plain text
3038 #: build/C/man3/fma.3:109
3039 msgid ""
3040 "If I<x> times I<y> is not an infinity times zero (or vice versa), and I<z> "
3041 "is a NaN, a NaN is returned."
3042 msgstr ""
3043
3044 #. type: Plain text
3045 #: build/C/man3/fma.3:113
3046 msgid ""
3047 "If the result overflows, a range error occurs, and an infinity with the "
3048 "correct sign is returned."
3049 msgstr ""
3050
3051 #. type: Plain text
3052 #: build/C/man3/fma.3:117
3053 msgid "If the result underflows, a range error occurs, and a signed 0 is returned."
3054 msgstr ""
3055
3056 #. type: TP
3057 #: build/C/man3/fma.3:124
3058 #, no-wrap
3059 msgid ""
3060 "Domain error: I<x> * I<y> + I<z>, or I<x> * I<y> is invalid and I<z> is not "
3061 "a NaN"
3062 msgstr ""
3063
3064 #.  .I errno
3065 #.  is set to
3066 #.  .BR EDOM .
3067 #. type: Plain text
3068 #: build/C/man3/fma.3:133 build/C/man3/ilogb.3:125 build/C/man3/log1p.3:128 build/C/man3/lrint.3:102 build/C/man3/lround.3:105 build/C/man3/remainder.3:165 build/C/man3/remquo.3:117 build/C/man3/scalb.3:155 build/C/man3/sincos.3:67
3069 msgid "An invalid floating-point exception (B<FE_INVALID>)  is raised."
3070 msgstr ""
3071
3072 #. type: TP
3073 #: build/C/man3/fma.3:141 build/C/man3/hypot.3:143 build/C/man3/tgamma.3:143 build/C/man3/y0.3:194
3074 #, no-wrap
3075 msgid "Range error: result underflow"
3076 msgstr ""
3077
3078 #. type: Plain text
3079 #: build/C/man3/fma.3:161
3080 msgid "B<remainder>(3), B<remquo>(3)"
3081 msgstr ""
3082
3083 #. type: TH
3084 #: build/C/man3/fmax.3:9
3085 #, no-wrap
3086 msgid "FMAX"
3087 msgstr ""
3088
3089 #. type: Plain text
3090 #: build/C/man3/fmax.3:12
3091 msgid "fmax, fmaxf, fmaxl - determine maximum of two floating-point numbers"
3092 msgstr ""
3093
3094 #. type: Plain text
3095 #: build/C/man3/fmax.3:16
3096 msgid "B<double fmax(double >I<x>B<, double >I<y>B<);>"
3097 msgstr ""
3098
3099 #. type: Plain text
3100 #: build/C/man3/fmax.3:18
3101 msgid "B<float fmaxf(float >I<x>B<, float >I<y>B<);>"
3102 msgstr ""
3103
3104 #. type: Plain text
3105 #: build/C/man3/fmax.3:20
3106 msgid "B<long double fmaxl(long double >I<x>B<, long double >I<y>B<);>"
3107 msgstr ""
3108
3109 #. type: Plain text
3110 #: build/C/man3/fmax.3:32
3111 msgid "B<fmax>(), B<fmaxf>(), B<fmaxl>():"
3112 msgstr ""
3113
3114 #. type: Plain text
3115 #: build/C/man3/fmax.3:45
3116 msgid "These functions return the larger value of I<x> and I<y>."
3117 msgstr ""
3118
3119 #. type: Plain text
3120 #: build/C/man3/fmax.3:50
3121 msgid "These functions return the maximum of I<x> and I<y>."
3122 msgstr ""
3123
3124 #. type: Plain text
3125 #: build/C/man3/fmax.3:52 build/C/man3/fmin.3:52
3126 msgid "If one argument is a NaN, the other argument is returned."
3127 msgstr ""
3128
3129 #. type: Plain text
3130 #: build/C/man3/fmax.3:54 build/C/man3/fmin.3:54
3131 msgid "If both arguments are NaN, a NaN is returned."
3132 msgstr ""
3133
3134 #. type: Plain text
3135 #: build/C/man3/fmax.3:62
3136 msgid "B<fmin>(3)"
3137 msgstr ""
3138
3139 #. type: TH
3140 #: build/C/man3/fmin.3:9
3141 #, no-wrap
3142 msgid "FMIN"
3143 msgstr ""
3144
3145 #. type: Plain text
3146 #: build/C/man3/fmin.3:12
3147 msgid "fmin, fminf, fminl - determine minimum of two floating-point numbers"
3148 msgstr ""
3149
3150 #. type: Plain text
3151 #: build/C/man3/fmin.3:16
3152 msgid "B<double fmin(double >I<x>B<, double >I<y>B<);>"
3153 msgstr ""
3154
3155 #. type: Plain text
3156 #: build/C/man3/fmin.3:18
3157 msgid "B<float fminf(float >I<x>B<, float >I<y>B<);>"
3158 msgstr ""
3159
3160 #. type: Plain text
3161 #: build/C/man3/fmin.3:20
3162 msgid "B<long double fminl(long double >I<x>B<, long double >I<y>B<);>"
3163 msgstr ""
3164
3165 #. type: Plain text
3166 #: build/C/man3/fmin.3:32
3167 msgid "B<fmin>(), B<fminf>(), B<fminl>():"
3168 msgstr ""
3169
3170 #. type: Plain text
3171 #: build/C/man3/fmin.3:45
3172 msgid "These functions the lesser value of I<x> and I<y>."
3173 msgstr ""
3174
3175 #. type: Plain text
3176 #: build/C/man3/fmin.3:50
3177 msgid "These functions return the minimum of I<x> and I<y>."
3178 msgstr ""
3179
3180 #. type: TH
3181 #: build/C/man3/fmod.3:35
3182 #, no-wrap
3183 msgid "FMOD"
3184 msgstr ""
3185
3186 #. type: TH
3187 #: build/C/man3/fmod.3:35
3188 #, no-wrap
3189 msgid "2012-03-15"
3190 msgstr ""
3191
3192 #. type: Plain text
3193 #: build/C/man3/fmod.3:38
3194 msgid "fmod, fmodf, fmodl - floating-point remainder function"
3195 msgstr ""
3196
3197 #. type: Plain text
3198 #: build/C/man3/fmod.3:43
3199 #, no-wrap
3200 msgid "B<double fmod(double >I<x>B<, double >I<y>B<);>\n"
3201 msgstr ""
3202
3203 #. type: Plain text
3204 #: build/C/man3/fmod.3:45
3205 #, no-wrap
3206 msgid "B<float fmodf(float >I<x>B<, float >I<y>B<);>\n"
3207 msgstr ""
3208
3209 #. type: Plain text
3210 #: build/C/man3/fmod.3:47
3211 #, no-wrap
3212 msgid "B<long double fmodl(long double >I<x>B<, long double >I<y>B<);>\n"
3213 msgstr ""
3214
3215 #. type: Plain text
3216 #: build/C/man3/fmod.3:59
3217 msgid "B<fmodf>(), B<fmodl>():"
3218 msgstr ""
3219
3220 #. type: Plain text
3221 #: build/C/man3/fmod.3:87
3222 msgid ""
3223 "The B<fmod>()  function computes the floating-point remainder of dividing "
3224 "I<x> by I<y>.  The return value is I<x> - I<n> * I<y>, where I<n> is the "
3225 "quotient of I<x> / I<y>, rounded toward zero to an integer."
3226 msgstr ""
3227
3228 #. type: Plain text
3229 #: build/C/man3/fmod.3:96
3230 msgid ""
3231 "On success, these functions return the value I<x>\\ -\\ I<n>*I<y>, for some "
3232 "integer I<n>, such that the returned value has the same sign as I<x> and a "
3233 "magnitude less than the magnitude of I<y>."
3234 msgstr ""
3235
3236 #. type: Plain text
3237 #: build/C/man3/fmod.3:108
3238 msgid "If I<x> is an infinity, a domain error occurs, and a NaN is returned."
3239 msgstr ""
3240
3241 #. type: Plain text
3242 #: build/C/man3/fmod.3:114
3243 msgid "If I<y> is zero, a domain error occurs, and a NaN is returned."
3244 msgstr ""
3245
3246 #. type: Plain text
3247 #: build/C/man3/fmod.3:120
3248 msgid "If I<x> is +0 (-0), and I<y> is not zero, +0 (-0) is returned."
3249 msgstr ""
3250
3251 #.  [XXX see bug above] and \fIx\fP is not a NaN
3252 #. type: TP
3253 #: build/C/man3/fmod.3:136 build/C/man3/remainder.3:172
3254 #, no-wrap
3255 msgid "Domain error: I<y> is zero"
3256 msgstr ""
3257
3258 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784
3259 #. type: Plain text
3260 #: build/C/man3/fmod.3:160
3261 msgid ""
3262 "Before version 2.10, the glibc implementation did not set I<errno> to "
3263 "B<EDOM> when a domain error occurred for an infinite I<x>."
3264 msgstr ""
3265
3266 #. type: Plain text
3267 #: build/C/man3/fmod.3:162
3268 msgid "B<remainder>(3)"
3269 msgstr ""
3270
3271 #. type: TH
3272 #: build/C/man3/fpclassify.3:10
3273 #, no-wrap
3274 msgid "FPCLASSIFY"
3275 msgstr ""
3276
3277 #. type: Plain text
3278 #: build/C/man3/fpclassify.3:14
3279 msgid ""
3280 "fpclassify, isfinite, isnormal, isnan, isinf - floating-point classification "
3281 "macros"
3282 msgstr ""
3283
3284 #. type: Plain text
3285 #: build/C/man3/fpclassify.3:19
3286 #, no-wrap
3287 msgid "B<int fpclassify(>I<x>B<);>\n"
3288 msgstr ""
3289
3290 #. type: Plain text
3291 #: build/C/man3/fpclassify.3:21
3292 #, no-wrap
3293 msgid "B<int isfinite(>I<x>B<);>\n"
3294 msgstr ""
3295
3296 #. type: Plain text
3297 #: build/C/man3/fpclassify.3:23
3298 #, no-wrap
3299 msgid "B<int isnormal(>I<x>B<);>\n"
3300 msgstr ""
3301
3302 #. type: Plain text
3303 #: build/C/man3/fpclassify.3:25
3304 #, no-wrap
3305 msgid "B<int isnan(>I<x>B<);>\n"
3306 msgstr ""
3307
3308 #. type: Plain text
3309 #: build/C/man3/fpclassify.3:27
3310 #, no-wrap
3311 msgid "B<int isinf(>I<x>B<);>\n"
3312 msgstr ""
3313
3314 #. type: Plain text
3315 #: build/C/man3/fpclassify.3:42
3316 msgid "B<fpclassify>(), B<isfinite>(), B<isnormal>():"
3317 msgstr ""
3318
3319 #. type: Plain text
3320 #: build/C/man3/fpclassify.3:76
3321 msgid ""
3322 "Floating point numbers can have special values, such as infinite or NaN.  "
3323 "With the macro B<fpclassify(>I<x>B<)> you can find out what type I<x> is.  "
3324 "The macro takes any floating-point expression as argument.  The result is "
3325 "one of the following values:"
3326 msgstr ""
3327
3328 #. type: TP
3329 #: build/C/man3/fpclassify.3:76
3330 #, no-wrap
3331 msgid "B<FP_NAN>"
3332 msgstr ""
3333
3334 #. type: Plain text
3335 #: build/C/man3/fpclassify.3:80
3336 msgid "I<x> is \"Not a Number\"."
3337 msgstr ""
3338
3339 #. type: TP
3340 #: build/C/man3/fpclassify.3:80
3341 #, no-wrap
3342 msgid "B<FP_INFINITE>"
3343 msgstr ""
3344
3345 #. type: Plain text
3346 #: build/C/man3/fpclassify.3:84
3347 msgid "I<x> is either positive infinity or negative infinity."
3348 msgstr ""
3349
3350 #. type: TP
3351 #: build/C/man3/fpclassify.3:84
3352 #, no-wrap
3353 msgid "B<FP_ZERO>"
3354 msgstr ""
3355
3356 #. type: Plain text
3357 #: build/C/man3/fpclassify.3:88
3358 msgid "I<x> is zero."
3359 msgstr ""
3360
3361 #. type: TP
3362 #: build/C/man3/fpclassify.3:88
3363 #, no-wrap
3364 msgid "B<FP_SUBNORMAL>"
3365 msgstr ""
3366
3367 #. type: Plain text
3368 #: build/C/man3/fpclassify.3:92
3369 msgid "I<x> is too small to be represented in normalized format."
3370 msgstr ""
3371
3372 #. type: TP
3373 #: build/C/man3/fpclassify.3:92
3374 #, no-wrap
3375 msgid "B<FP_NORMAL>"
3376 msgstr ""
3377
3378 #. type: Plain text
3379 #: build/C/man3/fpclassify.3:96
3380 msgid ""
3381 "if nothing of the above is correct then it must be a normal floating-point "
3382 "number."
3383 msgstr ""
3384
3385 #. type: Plain text
3386 #: build/C/man3/fpclassify.3:98
3387 msgid "The other macros provide a short answer to some standard questions."
3388 msgstr ""
3389
3390 #. type: TP
3391 #: build/C/man3/fpclassify.3:98
3392 #, no-wrap
3393 msgid "B<isfinite(>I<x>B<)>"
3394 msgstr ""
3395
3396 #. type: Plain text
3397 #: build/C/man3/fpclassify.3:101
3398 msgid "returns a nonzero value if"
3399 msgstr ""
3400
3401 #. type: Plain text
3402 #: build/C/man3/fpclassify.3:103
3403 msgid "(fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)"
3404 msgstr ""
3405
3406 #. type: TP
3407 #: build/C/man3/fpclassify.3:103
3408 #, no-wrap
3409 msgid "B<isnormal(>I<x>B<)>"
3410 msgstr ""
3411
3412 #. type: Plain text
3413 #: build/C/man3/fpclassify.3:107
3414 msgid "returns a nonzero value if (fpclassify(x) == FP_NORMAL)"
3415 msgstr ""
3416
3417 #. type: TP
3418 #: build/C/man3/fpclassify.3:107
3419 #, no-wrap
3420 msgid "B<isnan(>I<x>B<)>"
3421 msgstr ""
3422
3423 #. type: Plain text
3424 #: build/C/man3/fpclassify.3:111
3425 msgid "returns a nonzero value if (fpclassify(x) == FP_NAN)"
3426 msgstr ""
3427
3428 #. type: TP
3429 #: build/C/man3/fpclassify.3:111
3430 #, no-wrap
3431 msgid "B<isinf(>I<x>B<)>"
3432 msgstr ""
3433
3434 #. type: Plain text
3435 #: build/C/man3/fpclassify.3:118
3436 msgid "returns 1 if I<x> is positive infinity, and -1 if I<x> is negative infinity."
3437 msgstr ""
3438
3439 #. type: Plain text
3440 #: build/C/man3/fpclassify.3:120
3441 msgid "C99, POSIX.1."
3442 msgstr ""
3443
3444 #. type: Plain text
3445 #: build/C/man3/fpclassify.3:125
3446 msgid ""
3447 "For B<isinf>(), the standards merely say that the return value is nonzero if "
3448 "and only if the argument has an infinite value."
3449 msgstr ""
3450
3451 #. type: Plain text
3452 #: build/C/man3/fpclassify.3:132
3453 msgid ""
3454 "In glibc 2.01 and earlier, B<isinf>()  returns a nonzero value (actually: 1) "
3455 "if I<x> is positive infinity or negative infinity.  (This is all that C99 "
3456 "requires.)"
3457 msgstr ""
3458
3459 #. type: Plain text
3460 #: build/C/man3/fpclassify.3:137
3461 msgid "B<finite>(3), B<INFINITY>(3), B<isgreater>(3), B<signbit>(3)"
3462 msgstr ""
3463
3464 #. type: TH
3465 #: build/C/man3/frexp.3:33
3466 #, no-wrap
3467 msgid "FREXP"
3468 msgstr ""
3469
3470 #. type: Plain text
3471 #: build/C/man3/frexp.3:37
3472 msgid ""
3473 "frexp, frexpf, frexpl - convert floating-point number to fractional and "
3474 "integral components"
3475 msgstr ""
3476
3477 #. type: Plain text
3478 #: build/C/man3/frexp.3:42
3479 #, no-wrap
3480 msgid "B<double frexp(double >I<x>B<, int *>I<exp>B<);>\n"
3481 msgstr ""
3482
3483 #. type: Plain text
3484 #: build/C/man3/frexp.3:44
3485 #, no-wrap
3486 msgid "B<float frexpf(float >I<x>B<, int *>I<exp>B<);>\n"
3487 msgstr ""
3488
3489 #. type: Plain text
3490 #: build/C/man3/frexp.3:46
3491 #, no-wrap
3492 msgid "B<long double frexpl(long double >I<x>B<, int *>I<exp>B<);>\n"
3493 msgstr ""
3494
3495 #. type: Plain text
3496 #: build/C/man3/frexp.3:58
3497 msgid "B<frexpf>(), B<frexpl>():"
3498 msgstr ""
3499
3500 #. type: Plain text
3501 #: build/C/man3/frexp.3:74
3502 msgid ""
3503 "The B<frexp>()  function is used to split the number I<x> into a normalized "
3504 "fraction and an exponent which is stored in I<exp>."
3505 msgstr ""
3506
3507 #. type: Plain text
3508 #: build/C/man3/frexp.3:86
3509 msgid ""
3510 "The B<frexp>()  function returns the normalized fraction.  If the argument "
3511 "I<x> is not zero, the normalized fraction is I<x> times a power of two, and "
3512 "its absolute value is always in the range 1/2 (inclusive) to 1 (exclusive), "
3513 "that is, [0.5,1)."
3514 msgstr ""
3515
3516 #. type: Plain text
3517 #: build/C/man3/frexp.3:92
3518 msgid ""
3519 "If I<x> is zero, then the normalized fraction is zero and zero is stored in "
3520 "I<exp>."
3521 msgstr ""
3522
3523 #. type: Plain text
3524 #: build/C/man3/frexp.3:99
3525 msgid ""
3526 "If I<x> is a NaN, a NaN is returned, and the value of I<*exp> is "
3527 "unspecified."
3528 msgstr ""
3529
3530 #. type: Plain text
3531 #: build/C/man3/frexp.3:106
3532 msgid ""
3533 "If I<x> is positive infinity (negative infinity), positive infinity "
3534 "(negative infinity) is returned, and the value of I<*exp> is unspecified."
3535 msgstr ""
3536
3537 #. type: Plain text
3538 #: build/C/man3/frexp.3:116
3539 msgid "The program below produces results such as the following:"
3540 msgstr ""
3541
3542 #. type: Plain text
3543 #: build/C/man3/frexp.3:123
3544 #, no-wrap
3545 msgid ""
3546 "$B< ./a.out 2560>\n"
3547 "frexp(2560, &e) = 0.625: 0.625 * 2^12 = 2560\n"
3548 "$B< ./a.out -4>\n"
3549 "frexp(-4, &e) = -0.5: -0.5 * 2^3 = -4\n"
3550 msgstr ""
3551
3552 #. type: SS
3553 #: build/C/man3/frexp.3:125 build/C/man3/matherr.3:360
3554 #, no-wrap
3555 msgid "Program source"
3556 msgstr ""
3557
3558 #. type: Plain text
3559 #: build/C/man3/frexp.3:132
3560 #, no-wrap
3561 msgid ""
3562 "#include E<lt>math.hE<gt>\n"
3563 "#include E<lt>float.hE<gt>\n"
3564 "#include E<lt>stdio.hE<gt>\n"
3565 "#include E<lt>stdlib.hE<gt>\n"
3566 msgstr ""
3567
3568 #. type: Plain text
3569 #: build/C/man3/frexp.3:138
3570 #, no-wrap
3571 msgid ""
3572 "int\n"
3573 "main(int argc, char *argv[])\n"
3574 "{\n"
3575 "    double x, r;\n"
3576 "    int exp;\n"
3577 msgstr ""
3578
3579 #. type: Plain text
3580 #: build/C/man3/frexp.3:141
3581 #, no-wrap
3582 msgid ""
3583 "    x = strtod(argv[1], NULL);\n"
3584 "    r = frexp(x, &exp);\n"
3585 msgstr ""
3586
3587 #. type: Plain text
3588 #: build/C/man3/frexp.3:146
3589 #, no-wrap
3590 msgid ""
3591 "    printf(\"frexp(%g, &e) = %g: %g * %d^%d = %g\\en\",\n"
3592 "           x, r, r, FLT_RADIX, exp, x);\n"
3593 "    exit(EXIT_SUCCESS);\n"
3594 "}\n"
3595 msgstr ""
3596
3597 #. type: Plain text
3598 #: build/C/man3/frexp.3:150
3599 msgid "B<ldexp>(3), B<modf>(3)"
3600 msgstr ""
3601
3602 #. type: TH
3603 #: build/C/man3/gamma.3:9
3604 #, no-wrap
3605 msgid "GAMMA"
3606 msgstr ""
3607
3608 #. type: TH
3609 #: build/C/man3/gamma.3:9
3610 #, no-wrap
3611 msgid "2008-08-05"
3612 msgstr ""
3613
3614 #. type: Plain text
3615 #: build/C/man3/gamma.3:12
3616 msgid "gamma, gammaf, gammal - (logarithm of the) gamma function"
3617 msgstr ""
3618
3619 #. type: Plain text
3620 #: build/C/man3/gamma.3:16
3621 msgid "B<double gamma(double >I<x>B<);>"
3622 msgstr ""
3623
3624 #. type: Plain text
3625 #: build/C/man3/gamma.3:18
3626 msgid "B<float gammaf(float >I<x>B<);>"
3627 msgstr ""
3628
3629 #. type: Plain text
3630 #: build/C/man3/gamma.3:20
3631 msgid "B<long double gammal(long double >I<x>B<);>"
3632 msgstr ""
3633
3634 #. type: Plain text
3635 #: build/C/man3/gamma.3:30
3636 msgid "B<gamma>():"
3637 msgstr ""
3638
3639 #. type: Plain text
3640 #: build/C/man3/gamma.3:32 build/C/man3/lgamma.3:69
3641 msgid "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE"
3642 msgstr ""
3643
3644 #. type: Plain text
3645 #: build/C/man3/gamma.3:35
3646 msgid "B<gammaf>(), B<gammal>():"
3647 msgstr ""
3648
3649 #. type: Plain text
3650 #: build/C/man3/gamma.3:46
3651 msgid ""
3652 "These functions are deprecated: instead, use either the B<tgamma>(3)  or the "
3653 "B<lgamma>(3)  functions, as appropriate."
3654 msgstr ""
3655
3656 #. type: Plain text
3657 #: build/C/man3/gamma.3:49 build/C/man3/lgamma.3:74
3658 msgid "For the definition of the Gamma function, see B<tgamma>(3)."
3659 msgstr ""
3660
3661 #. type: SS
3662 #: build/C/man3/gamma.3:49
3663 #, no-wrap
3664 msgid "*BSD version"
3665 msgstr ""
3666
3667 #. type: Plain text
3668 #: build/C/man3/gamma.3:53
3669 msgid ""
3670 "The libm in 4.4BSD and some versions of FreeBSD had a B<gamma>()  function "
3671 "that computes the Gamma function, as one would expect."
3672 msgstr ""
3673
3674 #. type: SS
3675 #: build/C/man3/gamma.3:53
3676 #, no-wrap
3677 msgid "glibc version"
3678 msgstr ""
3679
3680 #. type: Plain text
3681 #: build/C/man3/gamma.3:59
3682 msgid ""
3683 "Glibc has a B<gamma>()  function that is equivalent to B<lgamma>(3)  and "
3684 "computes the natural logarithm of the Gamma function."
3685 msgstr ""
3686
3687 #. type: Plain text
3688 #: build/C/man3/gamma.3:62 build/C/man3/gamma.3:65
3689 msgid "See B<lgamma>(3)."
3690 msgstr ""
3691
3692 #. type: Plain text
3693 #: build/C/man3/gamma.3:68
3694 msgid ""
3695 "Because of historical variations in behavior across systems, this function "
3696 "is not specified in any standard."
3697 msgstr ""
3698
3699 #. type: SS
3700 #: build/C/man3/gamma.3:69
3701 #, no-wrap
3702 msgid "History"
3703 msgstr ""
3704
3705 #. type: Plain text
3706 #: build/C/man3/gamma.3:81
3707 msgid ""
3708 "4.2BSD had a B<gamma>()  that computed ln(|Gamma(|I<x>|)|), leaving the sign "
3709 "of Gamma(|I<x>|)  in the external integer I<signgam>.  In 4.3BSD the name "
3710 "was changed to B<lgamma>(3), and the man page promises"
3711 msgstr ""
3712
3713 #. type: Plain text
3714 #: build/C/man3/gamma.3:85
3715 msgid ""
3716 "At some time in the future the name gamma will be rehabilitated and used for "
3717 "the Gamma function"
3718 msgstr ""
3719
3720 #.  The FreeBSD man page says about gamma() that it is like lgamma()
3721 #.  except that is does not set signgam.
3722 #.  Also, that 4.4BSD has a gamma() that computes the true gamma function.
3723 #. type: Plain text
3724 #: build/C/man3/gamma.3:97
3725 msgid ""
3726 "This did indeed happen in 4.4BSD, where B<gamma>()  computes the Gamma "
3727 "function (with no effect on I<signgam>).  However, this came too late, and "
3728 "we now have B<tgamma>(3), the \"true gamma\" function."
3729 msgstr ""
3730
3731 #. type: Plain text
3732 #: build/C/man3/gamma.3:101
3733 msgid "B<lgamma>(3), B<signgam>(3), B<tgamma>(3)"
3734 msgstr ""
3735
3736 #. type: TH
3737 #: build/C/man3/hypot.3:33
3738 #, no-wrap
3739 msgid "HYPOT"
3740 msgstr ""
3741
3742 #. type: Plain text
3743 #: build/C/man3/hypot.3:36
3744 msgid "hypot, hypotf, hypotl - Euclidean distance function"
3745 msgstr ""
3746
3747 #. type: Plain text
3748 #: build/C/man3/hypot.3:41
3749 #, no-wrap
3750 msgid "B<double hypot(double >I<x>B<, double >I<y>B<);>\n"
3751 msgstr ""
3752
3753 #. type: Plain text
3754 #: build/C/man3/hypot.3:43
3755 #, no-wrap
3756 msgid "B<float hypotf(float >I<x>B<, float >I<y>B<);>\n"
3757 msgstr ""
3758
3759 #. type: Plain text
3760 #: build/C/man3/hypot.3:45
3761 #, no-wrap
3762 msgid "B<long double hypotl(long double >I<x>B<, long double >I<y>B<);>\n"
3763 msgstr ""
3764
3765 #. type: Plain text
3766 #: build/C/man3/hypot.3:56
3767 msgid "B<hypot>():"
3768 msgstr ""
3769
3770 #. type: Plain text
3771 #: build/C/man3/hypot.3:66
3772 msgid "B<hypotf>(), B<hypotl>():"
3773 msgstr ""
3774
3775 #. type: Plain text
3776 #: build/C/man3/hypot.3:87
3777 msgid ""
3778 "The B<hypot>()  function returns sqrt(I<x>*I<x>+I<y>*I<y>).  This is the "
3779 "length of the hypotenuse of a right-angled triangle with sides of length "
3780 "I<x> and I<y>, or the distance of the point (I<x>,I<y>)  from the origin."
3781 msgstr ""
3782
3783 #.  e.g., hypot(DBL_MIN, DBL_MIN) does the right thing, as does, say
3784 #.  hypot(DBL_MAX/2.0, DBL_MAX/2.0).
3785 #. type: Plain text
3786 #: build/C/man3/hypot.3:92
3787 msgid ""
3788 "The calculation is performed without undue overflow or underflow during the "
3789 "intermediate steps of the calculation."
3790 msgstr ""
3791
3792 #. type: Plain text
3793 #: build/C/man3/hypot.3:98
3794 msgid ""
3795 "On success, these functions return the length of a right-angled triangle "
3796 "with sides of length I<x> and I<y>."
3797 msgstr ""
3798
3799 #. type: Plain text
3800 #: build/C/man3/hypot.3:105
3801 msgid "If I<x> or I<y> is an infinity, positive infinity is returned."
3802 msgstr ""
3803
3804 #. type: Plain text
3805 #: build/C/man3/hypot.3:113
3806 msgid ""
3807 "If I<x> or I<y> is a NaN, and the other argument is not an infinity, a NaN "
3808 "is returned."
3809 msgstr ""
3810
3811 #.  Actually, could the result not be subnormal if both arguments
3812 #.  are subnormal?  I think not -- mtk, Jul 2008
3813 #. type: Plain text
3814 #: build/C/man3/hypot.3:128
3815 msgid ""
3816 "If both arguments are subnormal, and the result is subnormal, a range error "
3817 "occurs, and the correct result is returned."
3818 msgstr ""
3819
3820 #.  FIXME . Is it intentional that these functions do not set errno?
3821 #.  They do set errno for the y == 0 case, below.
3822 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783
3823 #. type: Plain text
3824 #: build/C/man3/hypot.3:158 build/C/man3/ilogb.3:130 build/C/man3/remainder.3:172
3825 msgid "These functions do not set I<errno> for this case."
3826 msgstr ""
3827
3828 #. type: Plain text
3829 #: build/C/man3/hypot.3:167
3830 msgid "B<cabs>(3), B<sqrt>(3)"
3831 msgstr ""
3832
3833 #. type: TH
3834 #: build/C/man3/ilogb.3:29
3835 #, no-wrap
3836 msgid "ILOGB"
3837 msgstr ""
3838
3839 #. type: Plain text
3840 #: build/C/man3/ilogb.3:32
3841 msgid "ilogb, ilogbf, ilogbl - get integer exponent of a floating-point value"
3842 msgstr ""
3843
3844 #. type: Plain text
3845 #: build/C/man3/ilogb.3:36
3846 msgid "B<int ilogb(double >I<x>B<);>"
3847 msgstr ""
3848
3849 #. type: Plain text
3850 #: build/C/man3/ilogb.3:38
3851 msgid "B<int ilogbf(float >I<x>B<);>"
3852 msgstr ""
3853
3854 #. type: Plain text
3855 #: build/C/man3/ilogb.3:40
3856 msgid "B<int ilogbl(long double >I<x>B<);>"
3857 msgstr ""
3858
3859 #. type: Plain text
3860 #: build/C/man3/ilogb.3:50
3861 msgid "B<ilogb>():"
3862 msgstr ""
3863
3864 #. type: Plain text
3865 #: build/C/man3/ilogb.3:62
3866 msgid "B<ilogbf>(), B<ilogbl>():"
3867 msgstr ""
3868
3869 #. type: Plain text
3870 #: build/C/man3/ilogb.3:78
3871 msgid ""
3872 "These functions return the exponent part of their argument as a signed "
3873 "integer.  When no error occurs, these functions are equivalent to the "
3874 "corresponding B<logb>(3)  functions, cast to I<int>."
3875 msgstr ""
3876
3877 #. type: Plain text
3878 #: build/C/man3/ilogb.3:82
3879 msgid ""
3880 "On success, these functions return the exponent of I<x>, as a signed "
3881 "integer."
3882 msgstr ""
3883
3884 #.  the POSIX.1 spec for logb() says logb() gives pole error for this
3885 #.  case, but for ilogb() it says domain error.
3886 #.  glibc: The numeric value is either `INT_MIN' or `-INT_MAX'.
3887 #. type: Plain text
3888 #: build/C/man3/ilogb.3:90
3889 msgid ""
3890 "If I<x> is zero, then a domain error occurs, and the functions return "
3891 "B<FP_ILOGB0>."
3892 msgstr ""
3893
3894 #.  glibc: The numeric value is either `INT_MIN' or `INT_MAX'.
3895 #.  On i386, FP_ILOGB0 and FP_ILOGBNAN have the same value.
3896 #. type: Plain text
3897 #: build/C/man3/ilogb.3:97
3898 msgid ""
3899 "If I<x> is a NaN, then a domain error occurs, and the functions return "
3900 "B<FP_ILOGBNAN>."
3901 msgstr ""
3902
3903 #
3904 #.  POSIX.1-2001 also says:
3905 #.  If the correct value is greater than {INT_MAX}, {INT_MAX}
3906 #.  shall be returned and a domain error shall occur.
3907 #
3908 #.  If the correct value is less than {INT_MIN}, {INT_MIN}
3909 #.  shall be returned and a domain error shall occur.
3910 #. type: Plain text
3911 #: build/C/man3/ilogb.3:110
3912 msgid ""
3913 "If I<x> is negative infinity or positive infinity, then a domain error "
3914 "occurs, and the functions return B<INT_MAX>."
3915 msgstr ""
3916
3917 #. type: TP
3918 #: build/C/man3/ilogb.3:117
3919 #, no-wrap
3920 msgid "Domain error: I<x> is 0 or a NaN"
3921 msgstr ""
3922
3923 #.  FIXME . Is it intentional that these functions do not set errno,
3924 #.  or raise an exception?
3925 #.  log(), log2(), log10() do set errno
3926 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794
3927 #. type: Plain text
3928 #: build/C/man3/ilogb.3:146
3929 msgid "These functions do not set I<errno> or raise an exception for this case."
3930 msgstr ""
3931
3932 #. type: Plain text
3933 #: build/C/man3/ilogb.3:152
3934 msgid "B<log>(3), B<logb>(3), B<significand>(3)"
3935 msgstr ""
3936
3937 #. type: TH
3938 #: build/C/man3/infnan.3:33
3939 #, no-wrap
3940 msgid "INFNAN"
3941 msgstr ""
3942
3943 #. type: TH
3944 #: build/C/man3/infnan.3:33
3945 #, no-wrap
3946 msgid "1993-06-02"
3947 msgstr ""
3948
3949 #. type: Plain text
3950 #: build/C/man3/infnan.3:36
3951 msgid "infnan - deal with infinite or not-a-number (NaN) result"
3952 msgstr ""
3953
3954 #. type: Plain text
3955 #: build/C/man3/infnan.3:41
3956 #, no-wrap
3957 msgid "B<double infnan(int >I<error>B<);>\n"
3958 msgstr ""
3959
3960 #. type: Plain text
3961 #: build/C/man3/infnan.3:56
3962 msgid ""
3963 "The B<infnan>()  function returns a suitable value for infinity and "
3964 "\"not-a-number\" (NaN) results.  The value of I<error> can be B<ERANGE> to "
3965 "represent infinity or anything else to represent NaN.  I<errno> is also set."
3966 msgstr ""
3967
3968 #. type: Plain text
3969 #: build/C/man3/infnan.3:64
3970 msgid "If I<error> is B<ERANGE> (Infinity), B<HUGE_VAL> is returned."
3971 msgstr ""
3972
3973 #. type: Plain text
3974 #: build/C/man3/infnan.3:72
3975 msgid "If I<error> is -B<ERANGE> (-Infinity), -B<HUGE_VAL> is returned."
3976 msgstr ""
3977
3978 #. type: Plain text
3979 #: build/C/man3/infnan.3:76
3980 msgid "If I<error> is anything else, NAN is returned."
3981 msgstr ""
3982
3983 #. type: TP
3984 #: build/C/man3/infnan.3:77
3985 #, no-wrap
3986 msgid "B<EDOM>"
3987 msgstr ""
3988
3989 #. type: Plain text
3990 #: build/C/man3/infnan.3:82
3991 msgid "The value of I<error> is \"not-a-number\" (NaN)."
3992 msgstr ""
3993
3994 #. type: TP
3995 #: build/C/man3/infnan.3:82
3996 #, no-wrap
3997 msgid "B<ERANGE>"
3998 msgstr ""
3999
4000 #. type: Plain text
4001 #: build/C/man3/infnan.3:87
4002 msgid "The value of I<error> is positive infinity or negative infinity."
4003 msgstr ""
4004
4005 #. type: Plain text
4006 #: build/C/man3/infnan.3:89
4007 msgid "4.3BSD."
4008 msgstr ""
4009
4010 #. type: Plain text
4011 #: build/C/man3/infnan.3:92
4012 msgid ""
4013 "This obsolete function was provided in libc4 and libc5, but is not available "
4014 "in glibc2."
4015 msgstr ""
4016
4017 #. type: TH
4018 #: build/C/man3/isgreater.3:10
4019 #, no-wrap
4020 msgid "ISGREATER"
4021 msgstr ""
4022
4023 #. type: TH
4024 #: build/C/man3/isgreater.3:10
4025 #, no-wrap
4026 msgid "2012-05-06"
4027 msgstr ""
4028
4029 #. type: Plain text
4030 #: build/C/man3/isgreater.3:14
4031 msgid ""
4032 "isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered - "
4033 "floating-point relational tests without exception for NaN"
4034 msgstr ""
4035
4036 #. type: Plain text
4037 #: build/C/man3/isgreater.3:19
4038 #, no-wrap
4039 msgid "B<int isgreater(>I<x>B<, >I<y>B<);>\n"
4040 msgstr ""
4041
4042 #. type: Plain text
4043 #: build/C/man3/isgreater.3:21
4044 #, no-wrap
4045 msgid "B<int isgreaterequal(>I<x>B<, >I<y>B<);>\n"
4046 msgstr ""
4047
4048 #. type: Plain text
4049 #: build/C/man3/isgreater.3:23
4050 #, no-wrap
4051 msgid "B<int isless(>I<x>B<, >I<y>B<);>\n"
4052 msgstr ""
4053
4054 #. type: Plain text
4055 #: build/C/man3/isgreater.3:25
4056 #, no-wrap
4057 msgid "B<int islessequal(>I<x>B<, >I<y>B<);>\n"
4058 msgstr ""
4059
4060 #. type: Plain text
4061 #: build/C/man3/isgreater.3:27
4062 #, no-wrap
4063 msgid "B<int islessgreater(>I<x>B<, >I<y>B<);>\n"
4064 msgstr ""
4065
4066 #. type: Plain text
4067 #: build/C/man3/isgreater.3:29
4068 #, no-wrap
4069 msgid "B<int isunordered(>I<x>B<, >I<y>B<);>\n"
4070 msgstr ""
4071
4072 #. type: Plain text
4073 #: build/C/man3/isgreater.3:40
4074 msgid "All functions described here:"
4075 msgstr ""
4076
4077 #. type: Plain text
4078 #: build/C/man3/isgreater.3:55
4079 msgid ""
4080 "The normal relation operations (like B<E<lt>>, \"less than\")  will fail if "
4081 "one of the operands is NaN.  This will cause an exception.  To avoid this, "
4082 "C99 defines the macros listed below."
4083 msgstr ""
4084
4085 #. type: Plain text
4086 #: build/C/man3/isgreater.3:61
4087 msgid ""
4088 "These macros are guaranteed to evaluate their arguments only once.  The "
4089 "arguments must be of real floating-point type (note: do not pass integer "
4090 "values as arguments to these macros, since the arguments will I<not> be "
4091 "promoted to real-floating types)."
4092 msgstr ""
4093
4094 #. type: TP
4095 #: build/C/man3/isgreater.3:61
4096 #, no-wrap
4097 msgid "B<isgreater>()"
4098 msgstr ""
4099
4100 #. type: Plain text
4101 #: build/C/man3/isgreater.3:69
4102 msgid "determines I<(x)\\ E<gt>\\ (y)> without an exception if I<x> or I<y> is NaN."
4103 msgstr ""
4104
4105 #. type: TP
4106 #: build/C/man3/isgreater.3:69
4107 #, no-wrap
4108 msgid "B<isgreaterequal>()"
4109 msgstr ""
4110
4111 #. type: Plain text
4112 #: build/C/man3/isgreater.3:77
4113 msgid ""
4114 "determines I<(x)\\ E<gt>=\\ (y)> without an exception if I<x> or I<y> is "
4115 "NaN."
4116 msgstr ""
4117
4118 #. type: TP
4119 #: build/C/man3/isgreater.3:77
4120 #, no-wrap
4121 msgid "B<isless>()"
4122 msgstr ""
4123
4124 #. type: Plain text
4125 #: build/C/man3/isgreater.3:85
4126 msgid "determines I<(x)\\ E<lt>\\ (y)> without an exception if I<x> or I<y> is NaN."
4127 msgstr ""
4128
4129 #. type: TP
4130 #: build/C/man3/isgreater.3:85
4131 #, no-wrap
4132 msgid "B<islessequal>()"
4133 msgstr ""
4134
4135 #. type: Plain text
4136 #: build/C/man3/isgreater.3:93
4137 msgid ""
4138 "determines I<(x)\\ E<lt>=\\ (y)> without an exception if I<x> or I<y> is "
4139 "NaN."
4140 msgstr ""
4141
4142 #. type: TP
4143 #: build/C/man3/isgreater.3:93
4144 #, no-wrap
4145 msgid "B<islessgreater>()"
4146 msgstr ""
4147
4148 #. type: Plain text
4149 #: build/C/man3/isgreater.3:107
4150 msgid ""
4151 "determines I<(x)\\ E<lt> (y) || (x) E<gt>\\ (y)> without an exception if "
4152 "I<x> or I<y> is NaN.  This macro is not equivalent to I<x\\ !=\\ y> because "
4153 "that expression is true if I<x> or I<y> is NaN."
4154 msgstr ""
4155
4156 #. type: TP
4157 #: build/C/man3/isgreater.3:107
4158 #, no-wrap
4159 msgid "B<isunordered>()"
4160 msgstr ""
4161
4162 #. type: Plain text
4163 #: build/C/man3/isgreater.3:111
4164 msgid ""
4165 "determines whether its arguments are unordered, that is, whether at least "
4166 "one of the arguments is a NaN."
4167 msgstr ""
4168
4169 #. type: Plain text
4170 #: build/C/man3/isgreater.3:116
4171 msgid ""
4172 "The macros other than B<isunordered>()  return the result of the relational "
4173 "comparison; these macros return 0 if either argument is a NaN."
4174 msgstr ""
4175
4176 #. type: Plain text
4177 #: build/C/man3/isgreater.3:123
4178 msgid "B<isunordered>()  returns 1 if I<x> or I<y> is NaN and 0 otherwise."
4179 msgstr ""
4180
4181 #. type: Plain text
4182 #: build/C/man3/isgreater.3:132
4183 msgid ""
4184 "Not all hardware supports these functions, and where hardware support isn't "
4185 "provided, they will be emulated by macros.  This will result in a "
4186 "performance penalty.  Don't use these functions if NaN is of no concern for "
4187 "you."
4188 msgstr ""
4189
4190 #. type: Plain text
4191 #: build/C/man3/isgreater.3:135
4192 msgid "B<fpclassify>(3), B<isnan>(3)"
4193 msgstr ""
4194
4195 #. type: TH
4196 #: build/C/man3/j0.3:36
4197 #, no-wrap
4198 msgid "J0"
4199 msgstr ""
4200
4201 #. type: Plain text
4202 #: build/C/man3/j0.3:40
4203 msgid ""
4204 "j0, j0f, j0l, j1, j1f, j1l, jn, jnf, jnl - Bessel functions of the first "
4205 "kind"
4206 msgstr ""
4207
4208 #. type: Plain text
4209 #: build/C/man3/j0.3:46
4210 msgid "B<double j0(double >I<x>B<);>"
4211 msgstr ""
4212
4213 #. type: Plain text
4214 #: build/C/man3/j0.3:48
4215 msgid "B<double j1(double >I<x>B<);>"
4216 msgstr ""
4217
4218 #. type: Plain text
4219 #: build/C/man3/j0.3:50
4220 msgid "B<double jn(int >I<n>B<, double >I<x>B<);>"
4221 msgstr ""
4222
4223 #. type: Plain text
4224 #: build/C/man3/j0.3:52
4225 msgid "B<float j0f(float >I<x>B<);>"
4226 msgstr ""
4227
4228 #. type: Plain text
4229 #: build/C/man3/j0.3:54
4230 msgid "B<float j1f(float >I<x>B<);>"
4231 msgstr ""
4232
4233 #. type: Plain text
4234 #: build/C/man3/j0.3:56
4235 msgid "B<float jnf(int >I<n>B<, float >I<x>B<);>"
4236 msgstr ""
4237
4238 #. type: Plain text
4239 #: build/C/man3/j0.3:58
4240 msgid "B<long double j0l(long double >I<x>B<);>"
4241 msgstr ""
4242
4243 #. type: Plain text
4244 #: build/C/man3/j0.3:60
4245 msgid "B<long double j1l(long double >I<x>B<);>"
4246 msgstr ""
4247
4248 #. type: Plain text
4249 #: build/C/man3/j0.3:62
4250 msgid "B<long double jnl(int >I<n>B<, long double >I<x>B<);>"
4251 msgstr ""
4252
4253 #. type: Plain text
4254 #: build/C/man3/j0.3:74
4255 msgid "B<j0>(), B<j1>(), B<jn>():"
4256 msgstr ""
4257
4258 #. type: Plain text
4259 #: build/C/man3/j0.3:76 build/C/man3/y0.3:76
4260 msgid "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE"
4261 msgstr ""
4262
4263 #. type: Plain text
4264 #: build/C/man3/j0.3:84
4265 msgid "B<j0f>(), B<j0l>(), B<j1f>(), B<j1l>(), B<jnf>(), B<jnl>():"
4266 msgstr ""
4267
4268 #.  Also seems to work: -std=c99 -D_XOPEN_SOURCE
4269 #. type: Plain text
4270 #: build/C/man3/j0.3:87 build/C/man3/y0.3:87
4271 msgid "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600"
4272 msgstr ""
4273
4274 #. type: Plain text
4275 #: build/C/man3/j0.3:104
4276 msgid ""
4277 "The B<j0>()  and B<j1>()  functions return Bessel functions of I<x> of the "
4278 "first kind of orders 0 and 1, respectively.  The B<jn>()  function returns "
4279 "the Bessel function of I<x> of the first kind of order I<n>."
4280 msgstr ""
4281
4282 #. type: Plain text
4283 #: build/C/man3/j0.3:114
4284 msgid ""
4285 "The B<j0f>()  etc. and B<j0l>()  etc. functions are versions that take and "
4286 "return I<float> and I<long double> values, respectively."
4287 msgstr ""
4288
4289 #. type: Plain text
4290 #: build/C/man3/j0.3:118
4291 msgid ""
4292 "On success, these functions return the appropriate Bessel value of the first "
4293 "kind for I<x>."
4294 msgstr ""
4295
4296 #. type: Plain text
4297 #: build/C/man3/j0.3:129
4298 msgid ""
4299 "If I<x> is too large in magnitude, or the result underflows, a range error "
4300 "occurs, and the return value is 0."
4301 msgstr ""
4302
4303 #. type: TP
4304 #: build/C/man3/j0.3:136
4305 #, no-wrap
4306 msgid "Range error: result underflow, or I<x> is too large in magnitude"
4307 msgstr ""
4308
4309 #.  An underflow floating-point exception
4310 #.  .RB ( FE_UNDERFLOW )
4311 #.  is raised.
4312 #. type: Plain text
4313 #: build/C/man3/j0.3:144
4314 msgid "I<errno> is set to B<ERANGE>."
4315 msgstr ""
4316
4317 #.  FIXME . Is it intentional that these functions do not raise exceptions?
4318 #.  e.g., j0(1.5e16)
4319 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805
4320 #. type: Plain text
4321 #: build/C/man3/j0.3:150
4322 msgid "These functions do not raise exceptions for B<fetestexcept>(3)."
4323 msgstr ""
4324
4325 #. type: Plain text
4326 #: build/C/man3/j0.3:156 build/C/man3/y0.3:229
4327 msgid ""
4328 "The functions returning I<double> conform to SVr4, 4.3BSD, POSIX.1-2001.  "
4329 "The others are nonstandard functions that also exist on the BSDs."
4330 msgstr ""
4331
4332 #. type: Plain text
4333 #: build/C/man3/j0.3:165
4334 msgid ""
4335 "There are errors of up to 2e-16 in the values returned by B<j0>(), B<j1>()  "
4336 "and B<jn>()  for values of I<x> between -8 and 8."
4337 msgstr ""
4338
4339 #. type: Plain text
4340 #: build/C/man3/j0.3:167
4341 msgid "B<y0>(3)"
4342 msgstr ""
4343
4344 #. type: TH
4345 #: build/C/man3/ldexp.3:34
4346 #, no-wrap
4347 msgid "LDEXP"
4348 msgstr ""
4349
4350 #. type: Plain text
4351 #: build/C/man3/ldexp.3:37
4352 msgid ""
4353 "ldexp, ldexpf, ldexpl - multiply floating-point number by integral power of "
4354 "2"
4355 msgstr ""
4356
4357 #. type: Plain text
4358 #: build/C/man3/ldexp.3:42
4359 #, no-wrap
4360 msgid "B<double ldexp(double >I<x>B<, int >I<exp>B<);>\n"
4361 msgstr ""
4362
4363 #. type: Plain text
4364 #: build/C/man3/ldexp.3:44
4365 #, no-wrap
4366 msgid "B<float ldexpf(float >I<x>B<, int >I<exp>B<);>\n"
4367 msgstr ""
4368
4369 #. type: Plain text
4370 #: build/C/man3/ldexp.3:46
4371 #, no-wrap
4372 msgid "B<long double ldexpl(long double >I<x>B<, int >I<exp>B<);>\n"
4373 msgstr ""
4374
4375 #. type: Plain text
4376 #: build/C/man3/ldexp.3:58
4377 msgid "B<ldexpf>(), B<ldexpl>():"
4378 msgstr ""
4379
4380 #. type: Plain text
4381 #: build/C/man3/ldexp.3:73
4382 msgid ""
4383 "The B<ldexp>()  function returns the result of multiplying the "
4384 "floating-point number I<x> by 2 raised to the power I<exp>."
4385 msgstr ""
4386
4387 #. type: Plain text
4388 #: build/C/man3/ldexp.3:76
4389 msgid "On success, these functions return I<x * (2^exp)>."
4390 msgstr ""
4391
4392 #. type: Plain text
4393 #: build/C/man3/ldexp.3:82
4394 msgid "If I<exp> is zero, then I<x> is returned."
4395 msgstr ""
4396
4397 #. type: Plain text
4398 #: build/C/man3/ldexp.3:106 build/C/man3/scalb.3:133 build/C/man3/scalbln.3:125
4399 msgid ""
4400 "If the result overflows, a range error occurs, and the functions return "
4401 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with a sign the "
4402 "same as I<x>."
4403 msgstr ""
4404
4405 #. type: Plain text
4406 #: build/C/man3/ldexp.3:139
4407 msgid "B<frexp>(3), B<modf>(3), B<scalbln>(3)"
4408 msgstr ""
4409
4410 #. type: TH
4411 #: build/C/man3/lgamma.3:11
4412 #, no-wrap
4413 msgid "LGAMMA"
4414 msgstr ""
4415
4416 #. type: Plain text
4417 #: build/C/man3/lgamma.3:15
4418 msgid ""
4419 "lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam - log "
4420 "gamma function"
4421 msgstr ""
4422
4423 #. type: Plain text
4424 #: build/C/man3/lgamma.3:20
4425 #, no-wrap
4426 msgid "B<double lgamma(double >I<x>B<);>\n"
4427 msgstr ""
4428
4429 #. type: Plain text
4430 #: build/C/man3/lgamma.3:22
4431 #, no-wrap
4432 msgid "B<float lgammaf(float >I<x>B<);>\n"
4433 msgstr ""
4434
4435 #. type: Plain text
4436 #: build/C/man3/lgamma.3:24
4437 #, no-wrap
4438 msgid "B<long double lgammal(long double >I<x>B<);>\n"
4439 msgstr ""
4440
4441 #. type: Plain text
4442 #: build/C/man3/lgamma.3:26
4443 #, no-wrap
4444 msgid "B<double lgamma_r(double >I<x>B<, int *>I<signp>B<);>\n"
4445 msgstr ""
4446
4447 #. type: Plain text
4448 #: build/C/man3/lgamma.3:28
4449 #, no-wrap
4450 msgid "B<float lgammaf_r(float >I<x>B<, int *>I<signp>B<);>\n"
4451 msgstr ""
4452
4453 #. type: Plain text
4454 #: build/C/man3/lgamma.3:30
4455 #, no-wrap
4456 msgid "B<long double lgammal_r(long double >I<x>B<, int *>I<signp>B<);>\n"
4457 msgstr ""
4458
4459 #. type: Plain text
4460 #: build/C/man3/lgamma.3:32
4461 #, no-wrap
4462 msgid "B<extern int >I<signgam>B<;>\n"
4463 msgstr ""
4464
4465 #. type: Plain text
4466 #: build/C/man3/lgamma.3:43
4467 msgid "B<lgamma>():"
4468 msgstr ""
4469
4470 #. type: Plain text
4471 #: build/C/man3/lgamma.3:53
4472 msgid "B<lgammaf>(), B<lgammal>():"
4473 msgstr ""
4474
4475 #. type: Plain text
4476 #: build/C/man3/lgamma.3:63
4477 msgid "B<lgamma_r>(), B<lgammaf_r>(), B<lgammal_r>():"
4478 msgstr ""
4479
4480 #. type: Plain text
4481 #: build/C/man3/lgamma.3:67
4482 msgid "I<signgam>:"
4483 msgstr ""
4484
4485 #. type: Plain text
4486 #: build/C/man3/lgamma.3:86
4487 msgid ""
4488 "The B<lgamma>()  function returns the natural logarithm of the absolute "
4489 "value of the Gamma function.  The sign of the Gamma function is returned in "
4490 "the external integer I<signgam> declared in I<E<lt>math.hE<gt>>.  It is 1 "
4491 "when the Gamma function is positive or zero, -1 when it is negative."
4492 msgstr ""
4493
4494 #. type: Plain text
4495 #: build/C/man3/lgamma.3:94
4496 msgid ""
4497 "Since using a constant location I<signgam> is not thread-safe, the functions "
4498 "B<lgamma_r>()  etc. have been introduced; they return the sign via the "
4499 "argument I<signp>."
4500 msgstr ""
4501
4502 #. type: Plain text
4503 #: build/C/man3/lgamma.3:96
4504 msgid "On success, these functions return the natural logarithm of Gamma(x)."
4505 msgstr ""
4506
4507 #. type: Plain text
4508 #: build/C/man3/lgamma.3:104
4509 msgid "If I<x> is 1 or 2, +0 is returned."
4510 msgstr ""
4511
4512 #. type: Plain text
4513 #: build/C/man3/lgamma.3:120
4514 msgid ""
4515 "If I<x> is a nonpositive integer, a pole error occurs, and the functions "
4516 "return +B<HUGE_VAL>, +B<HUGE_VALF>, or +B<HUGE_VALL>, respectively."
4517 msgstr ""
4518
4519 #. type: Plain text
4520 #: build/C/man3/lgamma.3:130 build/C/man3/tgamma.3:92
4521 msgid ""
4522 "If the result overflows, a range error occurs, and the functions return "
4523 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the correct "
4524 "mathematical sign."
4525 msgstr ""
4526
4527 #. type: TP
4528 #: build/C/man3/lgamma.3:137
4529 #, no-wrap
4530 msgid "Pole error: I<x> is a nonpositive integer"
4531 msgstr ""
4532
4533 #. type: Plain text
4534 #: build/C/man3/lgamma.3:165
4535 msgid ""
4536 "The B<lgamma>()  functions are specified in C99 and POSIX.1-2001.  "
4537 "I<signgam> is specified in POSIX.1-2001, but not in C99.  The B<lgamma_r>()  "
4538 "functions are nonstandard, but present on several other systems."
4539 msgstr ""
4540
4541 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777
4542 #. type: Plain text
4543 #: build/C/man3/lgamma.3:175
4544 msgid ""
4545 "In glibc 2.9 and earlier, when a pole error occurs, I<errno> is set to "
4546 "B<EDOM>; instead of the POSIX-mandated B<ERANGE>.  Since version 2.10, glibc "
4547 "does the right thing."
4548 msgstr ""
4549
4550 #. type: Plain text
4551 #: build/C/man3/lgamma.3:177
4552 msgid "B<tgamma>(3)"
4553 msgstr ""
4554
4555 #. type: TH
4556 #: build/C/man3/log.3:36
4557 #, no-wrap
4558 msgid "LOG"
4559 msgstr ""
4560
4561 #. type: Plain text
4562 #: build/C/man3/log.3:39
4563 msgid "log, logf, logl - natural logarithmic function"
4564 msgstr ""
4565
4566 #. type: Plain text
4567 #: build/C/man3/log.3:44
4568 #, no-wrap
4569 msgid "B<double log(double >I<x>B<);>\n"
4570 msgstr ""
4571
4572 #. type: Plain text
4573 #: build/C/man3/log.3:46
4574 #, no-wrap
4575 msgid "B<float logf(float >I<x>B<);>\n"
4576 msgstr ""
4577
4578 #. type: Plain text
4579 #: build/C/man3/log.3:48
4580 #, no-wrap
4581 msgid "B<long double logl(long double >I<x>B<);>\n"
4582 msgstr ""
4583
4584 #. type: Plain text
4585 #: build/C/man3/log.3:60
4586 msgid "B<logf>(), B<logl>():"
4587 msgstr ""
4588
4589 #. type: Plain text
4590 #: build/C/man3/log.3:73
4591 msgid "The B<log>()  function returns the natural logarithm of I<x>."
4592 msgstr ""
4593
4594 #. type: Plain text
4595 #: build/C/man3/log.3:76
4596 msgid "On success, these functions return the natural logarithm of I<x>."
4597 msgstr ""
4598
4599 #. type: Plain text
4600 #: build/C/man3/log.3:85
4601 msgid "If I<x> is 1, the result is +0."
4602 msgstr ""
4603
4604 #. type: Plain text
4605 #: build/C/man3/log.3:100 build/C/man3/logb.3:111
4606 msgid ""
4607 "If I<x> is zero, then a pole error occurs, and the functions return "
4608 "-B<HUGE_VAL>, -B<HUGE_VALF>, or -B<HUGE_VALL>, respectively."
4609 msgstr ""
4610
4611 #. type: Plain text
4612 #: build/C/man3/log.3:105
4613 msgid ""
4614 "If I<x> is negative (including negative infinity), then a domain error "
4615 "occurs, and a NaN (not a number) is returned."
4616 msgstr ""
4617
4618 #. type: TP
4619 #: build/C/man3/log.3:112 build/C/man3/y0.3:171
4620 #, no-wrap
4621 msgid "Domain error: I<x> is negative"
4622 msgstr ""
4623
4624 #. type: TP
4625 #: build/C/man3/log.3:120
4626 #, no-wrap
4627 msgid "Pole error: I<x> is zero"
4628 msgstr ""
4629
4630 #. type: Plain text
4631 #: build/C/man3/log.3:128 build/C/man3/tgamma.3:132
4632 msgid ""
4633 "I<errno> is set to B<ERANGE>.  A divide-by-zero floating-point exception "
4634 "(B<FE_DIVBYZERO>)  is raised."
4635 msgstr ""
4636
4637 #. type: Plain text
4638 #: build/C/man3/log.3:141
4639 msgid ""
4640 "In glibc 2.5 and earlier, taking the B<log>()  of a NaN produces a bogus "
4641 "invalid floating-point (B<FE_INVALID>)  exception."
4642 msgstr ""
4643
4644 #. type: Plain text
4645 #: build/C/man3/log.3:148
4646 msgid "B<cbrt>(3), B<clog>(3), B<log10>(3), B<log1p>(3), B<log2>(3), B<sqrt>(3)"
4647 msgstr ""
4648
4649 #. type: TH
4650 #: build/C/man3/log10.3:36
4651 #, no-wrap
4652 msgid "LOG10"
4653 msgstr ""
4654
4655 #. type: Plain text
4656 #: build/C/man3/log10.3:39
4657 msgid "log10, log10f, log10l - base-10 logarithmic function"
4658 msgstr ""
4659
4660 #. type: Plain text
4661 #: build/C/man3/log10.3:44
4662 #, no-wrap
4663 msgid "B<double log10(double >I<x>B<);>\n"
4664 msgstr ""
4665
4666 #. type: Plain text
4667 #: build/C/man3/log10.3:46
4668 #, no-wrap
4669 msgid "B<float log10f(float >I<x>B<);>\n"
4670 msgstr ""
4671
4672 #. type: Plain text
4673 #: build/C/man3/log10.3:48
4674 #, no-wrap
4675 msgid "B<long double log10l(long double >I<x>B<);>\n"
4676 msgstr ""
4677
4678 #. type: Plain text
4679 #: build/C/man3/log10.3:60
4680 msgid "B<log10f>(), B<log10l>():"
4681 msgstr ""
4682
4683 #. type: Plain text
4684 #: build/C/man3/log10.3:73
4685 msgid "The B<log10>()  function returns the base 10 logarithm of I<x>."
4686 msgstr ""
4687
4688 #. type: Plain text
4689 #: build/C/man3/log10.3:76
4690 msgid "On success, these functions return the base 10 logarithm of I<x>."
4691 msgstr ""
4692
4693 #. type: Plain text
4694 #: build/C/man3/log10.3:81 build/C/man3/log2.3:81
4695 msgid ""
4696 "For special cases, including where I<x> is 0, 1, negative, infinity, or NaN, "
4697 "see B<log>(3)."
4698 msgstr ""
4699
4700 #. type: Plain text
4701 #: build/C/man3/log10.3:89 build/C/man3/log2.3:89
4702 msgid ""
4703 "For a discussion of the errors that can occur for these functions, see "
4704 "B<log>(3)."
4705 msgstr ""
4706
4707 #. type: Plain text
4708 #: build/C/man3/log10.3:102
4709 msgid "B<cbrt>(3), B<clog10>(3), B<exp10>(3), B<log>(3), B<log2>(3), B<sqrt>(3)"
4710 msgstr ""
4711
4712 #. type: TH
4713 #: build/C/man3/log1p.3:29
4714 #, no-wrap
4715 msgid "LOG1P"
4716 msgstr ""
4717
4718 #. type: Plain text
4719 #: build/C/man3/log1p.3:32
4720 msgid "log1p, log1pf, log1pl - logarithm of 1 plus argument"
4721 msgstr ""
4722
4723 #. type: Plain text
4724 #: build/C/man3/log1p.3:37
4725 #, no-wrap
4726 msgid "B<double log1p(double >I<x>B<);>\n"
4727 msgstr ""
4728
4729 #. type: Plain text
4730 #: build/C/man3/log1p.3:39
4731 #, no-wrap
4732 msgid "B<float log1pf(float >I<x>B<);>\n"
4733 msgstr ""
4734
4735 #. type: Plain text
4736 #: build/C/man3/log1p.3:41
4737 #, no-wrap
4738 msgid "B<long double log1pl(long double >I<x>B<);>\n"
4739 msgstr ""
4740
4741 #. type: Plain text
4742 #: build/C/man3/log1p.3:52
4743 msgid "B<log1p>():"
4744 msgstr ""
4745
4746 #. type: Plain text
4747 #: build/C/man3/log1p.3:63
4748 msgid "B<log1pf>(), B<log1pl>():"
4749 msgstr ""
4750
4751 #. type: Plain text
4752 #: build/C/man3/log1p.3:74
4753 msgid "I<log1p(x)> returns a value equivalent to"
4754 msgstr ""
4755
4756 #. type: Plain text
4757 #: build/C/man3/log1p.3:77
4758 #, no-wrap
4759 msgid "    log (1 + I<x>)\n"
4760 msgstr ""
4761
4762 #. type: Plain text
4763 #: build/C/man3/log1p.3:83
4764 msgid ""
4765 "It is computed in a way that is accurate even if the value of I<x> is near "
4766 "zero."
4767 msgstr ""
4768
4769 #. type: Plain text
4770 #: build/C/man3/log1p.3:86
4771 msgid "On success, these functions return the natural logarithm of I<(1\\ +\\ x)>."
4772 msgstr ""
4773
4774 #. type: Plain text
4775 #: build/C/man3/log1p.3:105
4776 msgid ""
4777 "If I<x> is -1, a pole error occurs, and the functions return -B<HUGE_VAL>, "
4778 "-B<HUGE_VALF>, or -B<HUGE_VALL>, respectively."
4779 msgstr ""
4780
4781 #.  POSIX.1 specifies a possible range error if x is subnormal
4782 #.  glibc 2.8 doesn't do this
4783 #. type: Plain text
4784 #: build/C/man3/log1p.3:113
4785 msgid ""
4786 "If I<x> is less than -1 (including negative infinity), a domain error "
4787 "occurs, and a NaN (not a number) is returned."
4788 msgstr ""
4789
4790 #. type: TP
4791 #: build/C/man3/log1p.3:120
4792 #, no-wrap
4793 msgid "Domain error: I<x> is less than -1"
4794 msgstr ""
4795
4796 #. type: TP
4797 #: build/C/man3/log1p.3:128
4798 #, no-wrap
4799 msgid "Pole error: I<x> is -1"
4800 msgstr ""
4801
4802 #.  .I errno
4803 #.  is set to
4804 #.  .BR ERANGE .
4805 #. type: Plain text
4806 #: build/C/man3/log1p.3:136 build/C/man3/logb.3:131
4807 msgid "A divide-by-zero floating-point exception (B<FE_DIVBYZERO>)  is raised."
4808 msgstr ""
4809
4810 #. type: Plain text
4811 #: build/C/man3/log1p.3:149
4812 msgid "B<exp>(3), B<expm1>(3), B<log>(3)"
4813 msgstr ""
4814
4815 #. type: TH
4816 #: build/C/man3/log2.3:36
4817 #, no-wrap
4818 msgid "LOG2"
4819 msgstr ""
4820
4821 #. type: Plain text
4822 #: build/C/man3/log2.3:39
4823 msgid "log2, log2f, log2l - base-2 logarithmic function"
4824 msgstr ""
4825
4826 #. type: Plain text
4827 #: build/C/man3/log2.3:44
4828 #, no-wrap
4829 msgid "B<double log2(double >I<x>B<);>\n"
4830 msgstr ""
4831
4832 #. type: Plain text
4833 #: build/C/man3/log2.3:46
4834 #, no-wrap
4835 msgid "B<float log2f(float >I<x>B<);>\n"
4836 msgstr ""
4837
4838 #. type: Plain text
4839 #: build/C/man3/log2.3:48
4840 #, no-wrap
4841 msgid "B<long double log2l(long double >I<x>B<);>\n"
4842 msgstr ""
4843
4844 #. type: Plain text
4845 #: build/C/man3/log2.3:61
4846 msgid "B<log2>(), B<log2f>(), B<log2l>():"
4847 msgstr ""
4848
4849 #. type: Plain text
4850 #: build/C/man3/log2.3:73
4851 msgid "The B<log2>()  function returns the base 2 logarithm of I<x>."
4852 msgstr ""
4853
4854 #. type: Plain text
4855 #: build/C/man3/log2.3:76
4856 msgid "On success, these functions return the base 2 logarithm of I<x>."
4857 msgstr ""
4858
4859 #. type: Plain text
4860 #: build/C/man3/log2.3:103
4861 msgid "B<cbrt>(3), B<clog2>(3), B<log>(3), B<log10>(3), B<sqrt>(3)"
4862 msgstr ""
4863
4864 #. type: TH
4865 #: build/C/man3/logb.3:29
4866 #, no-wrap
4867 msgid "LOGB"
4868 msgstr ""
4869
4870 #. type: Plain text
4871 #: build/C/man3/logb.3:32
4872 msgid "logb, logbf, logbl - get exponent of a floating-point value"
4873 msgstr ""
4874
4875 #. type: Plain text
4876 #: build/C/man3/logb.3:36
4877 msgid "B<double logb(double >I<x>B<);>"
4878 msgstr ""
4879
4880 #. type: Plain text
4881 #: build/C/man3/logb.3:38
4882 msgid "B<float logbf(float >I<x>B<);>"
4883 msgstr ""
4884
4885 #. type: Plain text
4886 #: build/C/man3/logb.3:40
4887 msgid "B<long double logbl(long double >I<x>B<);>"
4888 msgstr ""
4889
4890 #. type: Plain text
4891 #: build/C/man3/logb.3:50
4892 msgid "B<logb>():"
4893 msgstr ""
4894
4895 #. type: Plain text
4896 #: build/C/man3/logb.3:61
4897 msgid "B<logbf>(), B<logbl>():"
4898 msgstr ""
4899
4900 #. type: Plain text
4901 #: build/C/man3/logb.3:86
4902 msgid ""
4903 "These functions extract the exponent from the internal floating-point "
4904 "representation of I<x> and return it as a floating-point value.  The integer "
4905 "constant B<FLT_RADIX>, defined in I<E<lt>float.hE<gt>>, indicates the radix "
4906 "used for the system's floating-point representation.  If B<FLT_RADIX> is 2, "
4907 "B<logb(>I<x>B<)> is equal to B<floor(log2(>I<x>B<))>, except that it is "
4908 "probably faster."
4909 msgstr ""
4910
4911 #. type: Plain text
4912 #: build/C/man3/logb.3:94
4913 msgid ""
4914 "If I<x> is subnormal, B<logb>()  returns the exponent I<x> would have if it "
4915 "were normalized."
4916 msgstr ""
4917
4918 #. type: Plain text
4919 #: build/C/man3/logb.3:97
4920 msgid "On success, these functions return the exponent of I<x>."
4921 msgstr ""
4922
4923 #. type: Plain text
4924 #: build/C/man3/logb.3:116
4925 msgid ""
4926 "If I<x> is negative infinity or positive infinity, then positive infinity is "
4927 "returned."
4928 msgstr ""
4929
4930 #. type: TP
4931 #: build/C/man3/logb.3:123
4932 #, no-wrap
4933 msgid "Pole error: I<x> is 0"
4934 msgstr ""
4935
4936 #. type: Plain text
4937 #: build/C/man3/logb.3:148
4938 msgid "B<ilogb>(3), B<log>(3)"
4939 msgstr ""
4940
4941 #. type: TH
4942 #: build/C/man3/lrint.3:27
4943 #, no-wrap
4944 msgid "LRINT"
4945 msgstr ""
4946
4947 #. type: Plain text
4948 #: build/C/man3/lrint.3:30
4949 msgid "lrint, lrintf, lrintl, llrint, llrintf, llrintl - round to nearest integer"
4950 msgstr ""
4951
4952 #. type: Plain text
4953 #: build/C/man3/lrint.3:35
4954 #, no-wrap
4955 msgid "B<long int lrint(double >I<x>B<);>\n"
4956 msgstr ""
4957
4958 #. type: Plain text
4959 #: build/C/man3/lrint.3:37
4960 #, no-wrap
4961 msgid "B<long int lrintf(float >I<x>B<);>\n"
4962 msgstr ""
4963
4964 #. type: Plain text
4965 #: build/C/man3/lrint.3:39
4966 #, no-wrap
4967 msgid "B<long int lrintl(long double >I<x>B<);>\n"
4968 msgstr ""
4969
4970 #. type: Plain text
4971 #: build/C/man3/lrint.3:41
4972 #, no-wrap
4973 msgid "B<long long int llrint(double >I<x>B<);>\n"
4974 msgstr ""
4975
4976 #. type: Plain text
4977 #: build/C/man3/lrint.3:43
4978 #, no-wrap
4979 msgid "B<long long int llrintf(float >I<x>B<);>\n"
4980 msgstr ""
4981
4982 #. type: Plain text
4983 #: build/C/man3/lrint.3:45
4984 #, no-wrap
4985 msgid "B<long long int llrintl(long double >I<x>B<);>\n"
4986 msgstr ""
4987
4988 #. type: Plain text
4989 #: build/C/man3/lrint.3:56 build/C/man3/lround.3:57
4990 msgid "All functions shown above:"
4991 msgstr ""
4992
4993 #. type: Plain text
4994 #: build/C/man3/lrint.3:68
4995 msgid ""
4996 "These functions round their argument to the nearest integer value, using the "
4997 "current rounding direction (see B<fesetround>(3))."
4998 msgstr ""
4999
5000 #. type: Plain text
5001 #: build/C/man3/lrint.3:73
5002 msgid ""
5003 "Note that unlike B<rint>(3), etc., the return type of these functions "
5004 "differs from that of their arguments."
5005 msgstr ""
5006
5007 #. type: Plain text
5008 #: build/C/man3/lrint.3:75 build/C/man3/lround.3:78 build/C/man3/rint.3:107 build/C/man3/round.3:77 build/C/man3/trunc.3:65
5009 msgid "These functions return the rounded integer value."
5010 msgstr ""
5011
5012 #.  The return value is -(LONG_MAX - 1) or -(LLONG_MAX -1)
5013 #. type: Plain text
5014 #: build/C/man3/lrint.3:87 build/C/man3/lround.3:90
5015 msgid ""
5016 "If I<x> is a NaN or an infinity, or the rounded value is too large to be "
5017 "stored in a I<long> (I<long long> in the case of the B<ll*> functions)  then "
5018 "a domain error occurs, and the return value is unspecified."
5019 msgstr ""
5020
5021 #. type: TP
5022 #: build/C/man3/lrint.3:94 build/C/man3/lround.3:97
5023 #, no-wrap
5024 msgid "Domain error: I<x> is a NaN or infinite, or the rounded value is too large"
5025 msgstr ""
5026
5027 #. type: Plain text
5028 #: build/C/man3/lrint.3:118
5029 msgid ""
5030 "B<ceil>(3), B<floor>(3), B<lround>(3), B<nearbyint>(3), B<rint>(3), "
5031 "B<round>(3)"
5032 msgstr ""
5033
5034 #. type: TH
5035 #: build/C/man3/lround.3:27
5036 #, no-wrap
5037 msgid "LROUND"
5038 msgstr ""
5039
5040 #. type: Plain text
5041 #: build/C/man3/lround.3:31
5042 msgid ""
5043 "lround, lroundf, lroundl, llround, llroundf, llroundl - round to nearest "
5044 "integer, away from zero"
5045 msgstr ""
5046
5047 #. type: Plain text
5048 #: build/C/man3/lround.3:36
5049 #, no-wrap
5050 msgid "B<long int lround(double >I<x>B<);>\n"
5051 msgstr ""
5052
5053 #. type: Plain text
5054 #: build/C/man3/lround.3:38
5055 #, no-wrap
5056 msgid "B<long int lroundf(float >I<x>B<);>\n"
5057 msgstr ""
5058
5059 #. type: Plain text
5060 #: build/C/man3/lround.3:40
5061 #, no-wrap
5062 msgid "B<long int lroundl(long double >I<x>B<);>\n"
5063 msgstr ""
5064
5065 #. type: Plain text
5066 #: build/C/man3/lround.3:42
5067 #, no-wrap
5068 msgid "B<long long int llround(double >I<x>B<);>\n"
5069 msgstr ""
5070
5071 #. type: Plain text
5072 #: build/C/man3/lround.3:44
5073 #, no-wrap
5074 msgid "B<long long int llroundf(float >I<x>B<);>\n"
5075 msgstr ""
5076
5077 #. type: Plain text
5078 #: build/C/man3/lround.3:46
5079 #, no-wrap
5080 msgid "B<long long int llroundl(long double >I<x>B<);>\n"
5081 msgstr ""
5082
5083 #. type: Plain text
5084 #: build/C/man3/lround.3:70
5085 msgid ""
5086 "These functions round their argument to the nearest integer value, rounding "
5087 "away from zero, regardless of the current rounding direction (see "
5088 "B<fenv>(3))."
5089 msgstr ""
5090
5091 #. type: Plain text
5092 #: build/C/man3/lround.3:76
5093 msgid ""
5094 "Note that unlike B<round>(3), B<ceil>(3), etc., the return type of these "
5095 "functions differs from that of their arguments."
5096 msgstr ""
5097
5098 #. type: Plain text
5099 #: build/C/man3/lround.3:121 build/C/man3/trunc.3:101
5100 msgid ""
5101 "B<ceil>(3), B<floor>(3), B<lrint>(3), B<nearbyint>(3), B<rint>(3), "
5102 "B<round>(3)"
5103 msgstr ""
5104
5105 #. type: TH
5106 #: build/C/man7/math_error.7:26
5107 #, no-wrap
5108 msgid "MATH_ERROR"
5109 msgstr ""
5110
5111 #. type: Plain text
5112 #: build/C/man7/math_error.7:29
5113 msgid "math_error - detecting errors from mathematical functions"
5114 msgstr ""
5115
5116 #. type: Plain text
5117 #: build/C/man7/math_error.7:34
5118 #, no-wrap
5119 msgid ""
5120 "B<#include E<lt>math.hE<gt>>\n"
5121 "B<#include E<lt>errno.hE<gt>>\n"
5122 "B<#include E<lt>fenv.hE<gt>>\n"
5123 msgstr ""
5124
5125 #. type: Plain text
5126 #: build/C/man7/math_error.7:53
5127 msgid ""
5128 "When an error occurs, most library functions indicate this fact by returning "
5129 "a special value (e.g., -1 or NULL).  Because they typically return a "
5130 "floating-point number, the mathematical functions declared in "
5131 "I<E<lt>math.hE<gt>> indicate an error using other mechanisms.  There are two "
5132 "error-reporting mechanisms: the older one sets I<errno>; the newer one uses "
5133 "the floating-point exception mechanism (the use of B<feclearexcept>(3)  and "
5134 "B<fetestexcept>(3), as outlined below)  described in B<fenv>(3)."
5135 msgstr ""
5136
5137 #. type: Plain text
5138 #: build/C/man7/math_error.7:58
5139 msgid ""
5140 "A portable program that needs to check for an error from a mathematical "
5141 "function should set I<errno> to zero, and make the following call"
5142 msgstr ""
5143
5144 #. type: Plain text
5145 #: build/C/man7/math_error.7:62
5146 #, no-wrap
5147 msgid "feclearexcept(FE_ALL_EXCEPT);\n"
5148 msgstr ""
5149
5150 #. type: Plain text
5151 #: build/C/man7/math_error.7:66
5152 msgid "before calling a mathematical function."
5153 msgstr ""
5154
5155 #. type: Plain text
5156 #: build/C/man7/math_error.7:72
5157 msgid ""
5158 "Upon return from the mathematical function, if I<errno> is nonzero, or the "
5159 "following call (see B<fenv>(3))  returns nonzero"
5160 msgstr ""
5161
5162 #. type: Plain text
5163 #: build/C/man7/math_error.7:77
5164 #, no-wrap
5165 msgid ""
5166 "fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |\n"
5167 "             FE_UNDERFLOW);\n"
5168 msgstr ""
5169
5170 #.  enum
5171 #.  {
5172 #.  FE_INVALID = 0x01,
5173 #.  __FE_DENORM = 0x02,
5174 #.  FE_DIVBYZERO = 0x04,
5175 #.  FE_OVERFLOW = 0x08,
5176 #.  FE_UNDERFLOW = 0x10,
5177 #.  FE_INEXACT = 0x20
5178 #.  };
5179 #. type: Plain text
5180 #: build/C/man7/math_error.7:90
5181 msgid "then an error occurred in the mathematical function."
5182 msgstr ""
5183
5184 #. type: Plain text
5185 #: build/C/man7/math_error.7:93
5186 msgid ""
5187 "The error conditions that can occur for mathematical functions are described "
5188 "below."
5189 msgstr ""
5190
5191 #. type: SS
5192 #: build/C/man7/math_error.7:93
5193 #, no-wrap
5194 msgid "Domain error"
5195 msgstr ""
5196
5197 #. type: Plain text
5198 #: build/C/man7/math_error.7:109
5199 msgid ""
5200 "A I<domain error> occurs when a mathematical function is supplied with an "
5201 "argument whose value falls outside the domain for which the function is "
5202 "defined (e.g., giving a negative argument to B<log>(3)).  When a domain "
5203 "error occurs, math functions commonly return a NaN (though some functions "
5204 "return a different value in this case); I<errno> is set to B<EDOM>, and an "
5205 "\"invalid\" (B<FE_INVALID>)  floating-point exception is raised."
5206 msgstr ""
5207
5208 #. type: SS
5209 #: build/C/man7/math_error.7:109
5210 #, no-wrap
5211 msgid "Pole error"
5212 msgstr ""
5213
5214 #. type: Plain text
5215 #: build/C/man7/math_error.7:133
5216 msgid ""
5217 "A I<pole error> occurs when the mathematical result of a function is an "
5218 "exact infinity (e.g., the logarithm of 0 is negative infinity).  When a pole "
5219 "error occurs, the function returns the (signed) value B<HUGE_VAL>, "
5220 "B<HUGE_VALF>, or B<HUGE_VALL>, depending on whether the function result type "
5221 "is I<double>, I<float>, or I<long double>.  The sign of the result is that "
5222 "which is mathematically correct for the function.  I<errno> is set to "
5223 "B<ERANGE>, and a \"divide-by-zero\" (B<FE_DIVBYZERO>)  floating-point "
5224 "exception is raised."
5225 msgstr ""
5226
5227 #. type: SS
5228 #: build/C/man7/math_error.7:133
5229 #, no-wrap
5230 msgid "Range error"
5231 msgstr ""
5232
5233 #. type: Plain text
5234 #: build/C/man7/math_error.7:140
5235 msgid ""
5236 "A I<range error> occurs when the magnitude of the function result means that "
5237 "it cannot be represented in the result type of the function.  The return "
5238 "value of the function depends on whether the range error was an overflow or "
5239 "an underflow."
5240 msgstr ""
5241
5242 #. type: Plain text
5243 #: build/C/man7/math_error.7:162
5244 msgid ""
5245 "A floating result I<overflows> if the result is finite, but is too large to "
5246 "represented in the result type.  When an overflow occurs, the function "
5247 "returns the value B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, depending on "
5248 "whether the function result type is I<double>, I<float>, or I<long double>.  "
5249 "I<errno> is set to B<ERANGE>, and an \"overflow\" (B<FE_OVERFLOW>)  "
5250 "floating-point exception is raised."
5251 msgstr ""
5252
5253 #. type: Plain text
5254 #: build/C/man7/math_error.7:177
5255 msgid ""
5256 "A floating result I<underflows> if the result is too small to be represented "
5257 "in the result type.  If an underflow occurs, a mathematical function "
5258 "typically returns 0.0 (C99 says a function shall return \"an "
5259 "implementation-defined value whose magnitude is no greater than the smallest "
5260 "normalized positive number in the specified type\").  I<errno> may be set to "
5261 "B<ERANGE>, and an \"overflow\" (B<FE_UNDERFLOW>)  floating-point exception "
5262 "may be raised."
5263 msgstr ""
5264
5265 #. type: Plain text
5266 #: build/C/man7/math_error.7:187
5267 msgid ""
5268 "Some functions deliver a range error if the supplied argument value, or the "
5269 "correct function result, would be I<subnormal>.  A subnormal value is one "
5270 "that is nonzero, but with a magnitude that is so small that it can't be "
5271 "presented in normalized form (i.e., with a 1 in the most significant bit of "
5272 "the significand).  The representation of a subnormal number will contain one "
5273 "or more leading zeros in the significand."
5274 msgstr ""
5275
5276 #.  See CONFORMANCE in the glibc 2.8 (and earlier) source.
5277 #. type: Plain text
5278 #: build/C/man7/math_error.7:209
5279 msgid ""
5280 "The I<math_errhandling> identifier specified by C99 and POSIX.1-2001 is not "
5281 "supported by glibc.  This identifier is supposed to indicate which of the "
5282 "two error-notification mechanisms (I<errno>, exceptions retrievable via "
5283 "B<fettestexcept>(3))  is in use.  The standards require that at least one be "
5284 "in use, but permit both to be available.  The current (version 2.8) "
5285 "situation under glibc is messy.  Most (but not all) functions raise "
5286 "exceptions on errors.  Some also set I<errno>.  A few functions set "
5287 "I<errno>, but don't raise an exception.  A very few functions do neither.  "
5288 "See the individual manual pages for details."
5289 msgstr ""
5290
5291 #.  http://www.securecoding.cert.org/confluence/display/seccode/FLP32-C.+Prevent+or+detect+domain+and+range+errors+in+math+functions
5292 #. type: Plain text
5293 #: build/C/man7/math_error.7:222
5294 msgid ""
5295 "To avoid the complexities of using I<errno> and B<fetestexcept>(3)  for "
5296 "error checking, it is often advised that one should instead check for bad "
5297 "argument values before each call.  For example, the following code ensures "
5298 "that B<log>(3)'s argument is not a NaN and is not zero (a pole error) or "
5299 "less than zero (a domain error):"
5300 msgstr ""
5301
5302 #. type: Plain text
5303 #: build/C/man7/math_error.7:226
5304 #, no-wrap
5305 msgid "double x, r;\n"
5306 msgstr ""
5307
5308 #. type: Plain text
5309 #: build/C/man7/math_error.7:230
5310 #, no-wrap
5311 msgid ""
5312 "if (isnan(x) || islessequal(x, 0)) {\n"
5313 "    /* Deal with NaN / pole error / domain error */\n"
5314 "}\n"
5315 msgstr ""
5316
5317 #. type: Plain text
5318 #: build/C/man7/math_error.7:232
5319 #, no-wrap
5320 msgid "r = log(x);\n"
5321 msgstr ""
5322
5323 #. type: Plain text
5324 #: build/C/man7/math_error.7:240
5325 msgid ""
5326 "The discussion on this page does not apply to the complex mathematical "
5327 "functions (i.e., those declared by I<E<lt>complex.hE<gt>>), which in general "
5328 "are not required to return errors by C99 and POSIX.1-2001."
5329 msgstr ""
5330
5331 #. type: Plain text
5332 #: build/C/man7/math_error.7:256
5333 msgid ""
5334 "The B<gcc>(1)  I<-fno-math-errno> option causes the executable to employ "
5335 "implementations of some mathematical functions that are faster than the "
5336 "standard implementations, but do not set I<errno> on error.  (The B<gcc>(1)  "
5337 "I<-ffast-math> option also enables I<-fno-math-errno>.)  An error can still "
5338 "be tested for using B<fetestexcept>(3)."
5339 msgstr ""
5340
5341 #. type: Plain text
5342 #: build/C/man7/math_error.7:265
5343 msgid ""
5344 "B<gcc>(1), B<errno>(3), B<fenv>(3), B<fpclassify>(3), B<INFINITY>(3), "
5345 "B<isgreater>(3), B<matherr>(3), B<nan>(3)"
5346 msgstr ""
5347
5348 #. type: Plain text
5349 #: build/C/man7/math_error.7:267
5350 msgid "I<info libc>"
5351 msgstr ""
5352
5353 #. type: TH
5354 #: build/C/man3/matherr.3:27
5355 #, no-wrap
5356 msgid "MATHERR"
5357 msgstr ""
5358
5359 #. type: TH
5360 #: build/C/man3/matherr.3:27
5361 #, no-wrap
5362 msgid "2010-09-10"
5363 msgstr ""
5364
5365 #. type: Plain text
5366 #: build/C/man3/matherr.3:30
5367 msgid "matherr - SVID math library exception handling"
5368 msgstr ""
5369
5370 #. type: Plain text
5371 #: build/C/man3/matherr.3:34
5372 #, no-wrap
5373 msgid ""
5374 "B<#define _SVID_SOURCE>             /* See feature_test_macros(7) */\n"
5375 "B<#include E<lt>math.hE<gt>>\n"
5376 msgstr ""
5377
5378 #. type: Plain text
5379 #: build/C/man3/matherr.3:36
5380 #, no-wrap
5381 msgid "B<int matherr(struct exception *>I<exc>B<);>\n"
5382 msgstr ""
5383
5384 #. type: Plain text
5385 #: build/C/man3/matherr.3:38
5386 #, no-wrap
5387 msgid "B<extern _LIB_VERSION_TYPE _LIB_VERSION;>\n"
5388 msgstr ""
5389
5390 #. type: Plain text
5391 #: build/C/man3/matherr.3:51
5392 msgid ""
5393 "The System V Interface Definition (SVID) specifies that various math "
5394 "functions should invoke a function called B<matherr>()  if a math exception "
5395 "is detected.  This function is called before the math function returns; "
5396 "after B<matherr>()  returns, the system then returns to the math function, "
5397 "which in turn returns to the caller."
5398 msgstr ""
5399
5400 #. type: Plain text
5401 #: build/C/man3/matherr.3:62
5402 msgid ""
5403 "The B<matherr>()  mechanism is supported by glibc, but is now obsolete: new "
5404 "applications should use the techniques described in B<math_error>(7)  and "
5405 "B<fenv>(3).  This page documents the glibc B<matherr>()  mechanism as an aid "
5406 "for maintaining and porting older applications."
5407 msgstr ""
5408
5409 #. type: Plain text
5410 #: build/C/man3/matherr.3:75
5411 msgid ""
5412 "To employ B<matherr>(), the programmer must define the B<_SVID_SOURCE> "
5413 "feature test macro (before including I<any> header files), and assign the "
5414 "value B<_SVID_> to the external variable B<_LIB_VERSION>."
5415 msgstr ""
5416
5417 #. type: Plain text
5418 #: build/C/man3/matherr.3:87
5419 msgid ""
5420 "The system provides a default version of B<matherr>().  This version does "
5421 "nothing, and returns zero (see below for the significance of this).  The "
5422 "default B<matherr>()  can be overridden by a programmer-defined version, "
5423 "which will be invoked when an exception occurs.  The function is invoked "
5424 "with one argument, a pointer to an I<exception> structure, defined as "
5425 "follows:"
5426 msgstr ""
5427
5428 #. type: Plain text
5429 #: build/C/man3/matherr.3:97
5430 #, no-wrap
5431 msgid ""
5432 "struct exception {\n"
5433 "    int    type;      /* Exception type */\n"
5434 "    char  *name;      /* Name of function causing exception */\n"
5435 "    double arg1;      /* 1st argument to function */\n"
5436 "    double arg2;      /* 2nd argument to function */\n"
5437 "    double retval;    /* Function return value */\n"
5438 "}\n"
5439 msgstr ""
5440
5441 #. type: Plain text
5442 #: build/C/man3/matherr.3:103
5443 msgid "The I<type> field has one of the following values:"
5444 msgstr ""
5445
5446 #. type: TP
5447 #: build/C/man3/matherr.3:103
5448 #, no-wrap
5449 msgid "B<DOMAIN>"
5450 msgstr ""
5451
5452 #. type: Plain text
5453 #: build/C/man3/matherr.3:111
5454 msgid ""
5455 "A domain error occurred (the function argument was outside the range for "
5456 "which the function is defined).  The return value depends on the function; "
5457 "I<errno> is set to B<EDOM>."
5458 msgstr ""
5459
5460 #. type: TP
5461 #: build/C/man3/matherr.3:111
5462 #, no-wrap
5463 msgid "B<SING>"
5464 msgstr ""
5465
5466 #. type: Plain text
5467 #: build/C/man3/matherr.3:122
5468 msgid ""
5469 "A pole error occurred (the function result is an infinity).  The return "
5470 "value in most cases is B<HUGE> (the largest single precision floating-point "
5471 "number), appropriately signed.  In most cases, I<errno> is set to B<EDOM>."
5472 msgstr ""
5473
5474 #. type: TP
5475 #: build/C/man3/matherr.3:122
5476 #, no-wrap
5477 msgid "B<OVERFLOW>"
5478 msgstr ""
5479
5480 #. type: Plain text
5481 #: build/C/man3/matherr.3:131
5482 msgid ""
5483 "An overflow occurred.  In most cases, the value B<HUGE> is returned, and "
5484 "I<errno> is set to B<ERANGE>."
5485 msgstr ""
5486
5487 #. type: TP
5488 #: build/C/man3/matherr.3:131
5489 #, no-wrap
5490 msgid "B<UNDERFLOW>"
5491 msgstr ""
5492
5493 #. type: Plain text
5494 #: build/C/man3/matherr.3:138
5495 msgid "An underflow occurred.  0.0 is returned, and I<errno> is set to B<ERANGE>."
5496 msgstr ""
5497
5498 #. type: TP
5499 #: build/C/man3/matherr.3:138
5500 #, no-wrap
5501 msgid "B<TLOSS>"
5502 msgstr ""
5503
5504 #. type: Plain text
5505 #: build/C/man3/matherr.3:145
5506 msgid ""
5507 "Total loss of significance.  0.0 is returned, and I<errno> is set to "
5508 "B<ERANGE>."
5509 msgstr ""
5510
5511 #. type: TP
5512 #: build/C/man3/matherr.3:145
5513 #, no-wrap
5514 msgid "B<PLOSS>"
5515 msgstr ""
5516
5517 #. type: Plain text
5518 #: build/C/man3/matherr.3:150
5519 msgid ""
5520 "Partial loss of significance.  This value is unused on glibc (and many other "
5521 "systems)."
5522 msgstr ""
5523
5524 #. type: Plain text
5525 #: build/C/man3/matherr.3:158
5526 msgid ""
5527 "The I<arg1> and I<arg2> fields are the arguments supplied to the function "
5528 "(I<arg2> is undefined for functions that take only one argument)."
5529 msgstr ""
5530
5531 #. type: Plain text
5532 #: build/C/man3/matherr.3:166
5533 msgid ""
5534 "The I<retval> field specifies the return value that the math function will "
5535 "return to its caller.  The programmer-defined B<matherr>()  can modify this "
5536 "field to change the return value of the math function."
5537 msgstr ""
5538
5539 #. type: Plain text
5540 #: build/C/man3/matherr.3:173
5541 msgid ""
5542 "If the B<matherr>()  function returns zero, then the system sets I<errno> as "
5543 "described above, and may print an error message on standard error (see "
5544 "below)."
5545 msgstr ""
5546
5547 #. type: Plain text
5548 #: build/C/man3/matherr.3:179
5549 msgid ""
5550 "If the B<matherr>()  function returns a nonzero value, then the system does "
5551 "not set I<errno>, and doesn't print an error message."
5552 msgstr ""
5553
5554 #. type: SS
5555 #: build/C/man3/matherr.3:179
5556 #, no-wrap
5557 msgid "Math functions that employ matherr()"
5558 msgstr ""
5559
5560 #. type: Plain text
5561 #: build/C/man3/matherr.3:189
5562 msgid ""
5563 "The table below lists the functions and circumstances in which B<matherr>()  "
5564 "is called.  The \"Type\" column indicates the value assigned to "
5565 "I<exc-E<gt>type> when calling B<matherr>().  The \"Result\" column is the "
5566 "default return value assigned to I<exc-E<gt>retval>."
5567 msgstr ""
5568
5569 #. type: Plain text
5570 #: build/C/man3/matherr.3:195
5571 msgid ""
5572 "The \"Msg?\" and \"errno\" columns describe the default behavior if "
5573 "B<matherr>()  returns zero.  If the \"Msg?\" columns contains \"y\", then "
5574 "the system prints an error message on standard error."
5575 msgstr ""
5576
5577 #. type: Plain text
5578 #: build/C/man3/matherr.3:197
5579 msgid "The table uses the following notations and abbreviations:"
5580 msgstr ""
5581
5582 #. type: Plain text
5583 #: build/C/man3/matherr.3:209
5584 #, no-wrap
5585 msgid ""
5586 "x        first argument to function\n"
5587 "y        second argument to function\n"
5588 "fin      finite value for argument\n"
5589 "neg      negative value for argument\n"
5590 "int      integral value for argument\n"
5591 "o/f      result overflowed\n"
5592 "u/f      result underflowed\n"
5593 "|x|      absolute value of x\n"
5594 "X_TLOSS  is a constant defined in I<E<lt>math.hE<gt>>\n"
5595 msgstr ""
5596
5597 #. type: tbl table
5598 #: build/C/man3/matherr.3:216
5599 #, no-wrap
5600 msgid "Function\tType\tResult\tMsg?\terrno\n"
5601 msgstr ""
5602
5603 #. type: tbl table
5604 #: build/C/man3/matherr.3:217
5605 #, no-wrap
5606 msgid "acos(|x|E<gt>1)\tDOMAIN\tHUGE\ty\tEDOM\n"
5607 msgstr ""
5608
5609 #. type: tbl table
5610 #: build/C/man3/matherr.3:218
5611 #, no-wrap
5612 msgid "asin(|x|E<gt>1)\tDOMAIN\tHUGE\ty\tEDOM\n"
5613 msgstr ""
5614
5615 #. type: tbl table
5616 #: build/C/man3/matherr.3:219
5617 #, no-wrap
5618 msgid "atan2(0,0)\tDOMAIN\tHUGE\ty\tEDOM\n"
5619 msgstr ""
5620
5621 #.  retval is 0.0/0.0
5622 #. type: tbl table
5623 #: build/C/man3/matherr.3:220
5624 #, no-wrap
5625 msgid "acosh(xE<lt>1)\tDOMAIN\tNAN\ty\tEDOM\t\n"
5626 msgstr ""
5627
5628 #.  retval is 0.0/0.0
5629 #. type: tbl table
5630 #: build/C/man3/matherr.3:221
5631 #, no-wrap
5632 msgid "atanh(|x|E<gt>1)\tDOMAIN\tNAN\ty\tEDOM\t\n"
5633 msgstr ""
5634
5635 #.  retval is x/0.0
5636 #. type: tbl table
5637 #: build/C/man3/matherr.3:222
5638 #, no-wrap
5639 msgid "atanh(|x|==1)\tSING\t(xE<gt>0.0)?\ty\tEDOM\t\n"
5640 msgstr ""
5641
5642 #. type: tbl table
5643 #: build/C/man3/matherr.3:223 build/C/man3/matherr.3:268
5644 #, no-wrap
5645 msgid "\\ \t\\ \tHUGE_VAL :\n"
5646 msgstr ""
5647
5648 #. type: tbl table
5649 #: build/C/man3/matherr.3:224 build/C/man3/matherr.3:269
5650 #, no-wrap
5651 msgid "\\ \t\\ \t-HUGE_VAL\n"
5652 msgstr ""
5653
5654 #. type: tbl table
5655 #: build/C/man3/matherr.3:225
5656 #, no-wrap
5657 msgid "cosh(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5658 msgstr ""
5659
5660 #. type: tbl table
5661 #: build/C/man3/matherr.3:226
5662 #, no-wrap
5663 msgid "sinh(fin) o/f\tOVERFLOW\t(xE<gt>0.0) ?\tn\tERANGE\n"
5664 msgstr ""
5665
5666 #. type: tbl table
5667 #: build/C/man3/matherr.3:227
5668 #, no-wrap
5669 msgid "\\ \t\\ \tHUGE : -HUGE\n"
5670 msgstr ""
5671
5672 #. type: tbl table
5673 #: build/C/man3/matherr.3:228
5674 #, no-wrap
5675 msgid "sqrt(xE<lt>0)\tDOMAIN\t0.0\ty\tEDOM\n"
5676 msgstr ""
5677
5678 #. type: tbl table
5679 #: build/C/man3/matherr.3:229
5680 #, no-wrap
5681 msgid "hypot(fin,fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5682 msgstr ""
5683
5684 #. type: tbl table
5685 #: build/C/man3/matherr.3:230
5686 #, no-wrap
5687 msgid "exp(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5688 msgstr ""
5689
5690 #. type: tbl table
5691 #: build/C/man3/matherr.3:231
5692 #, no-wrap
5693 msgid "exp(fin) u/f\tUNDERFLOW\t0.0\tn\tERANGE\n"
5694 msgstr ""
5695
5696 #. type: tbl table
5697 #: build/C/man3/matherr.3:232
5698 #, no-wrap
5699 msgid "exp2(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5700 msgstr ""
5701
5702 #. type: tbl table
5703 #: build/C/man3/matherr.3:233
5704 #, no-wrap
5705 msgid "exp2(fin) u/f\tUNDERFLOW\t0.0\tn\tERANGE\n"
5706 msgstr ""
5707
5708 #. type: tbl table
5709 #: build/C/man3/matherr.3:234
5710 #, no-wrap
5711 msgid "exp10(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5712 msgstr ""
5713
5714 #. type: tbl table
5715 #: build/C/man3/matherr.3:235
5716 #, no-wrap
5717 msgid "exp10(fin) u/f\tUNDERFLOW\t0.0\tn\tERANGE\n"
5718 msgstr ""
5719
5720 #. type: tbl table
5721 #: build/C/man3/matherr.3:236
5722 #, no-wrap
5723 msgid "j0(|x|E<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5724 msgstr ""
5725
5726 #. type: tbl table
5727 #: build/C/man3/matherr.3:237
5728 #, no-wrap
5729 msgid "j1(|x|E<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5730 msgstr ""
5731
5732 #. type: tbl table
5733 #: build/C/man3/matherr.3:238
5734 #, no-wrap
5735 msgid "jn(|x|E<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5736 msgstr ""
5737
5738 #. type: tbl table
5739 #: build/C/man3/matherr.3:239
5740 #, no-wrap
5741 msgid "y0(xE<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5742 msgstr ""
5743
5744 #. type: tbl table
5745 #: build/C/man3/matherr.3:240
5746 #, no-wrap
5747 msgid "y1(xE<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5748 msgstr ""
5749
5750 #. type: tbl table
5751 #: build/C/man3/matherr.3:241
5752 #, no-wrap
5753 msgid "yn(xE<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5754 msgstr ""
5755
5756 #. type: tbl table
5757 #: build/C/man3/matherr.3:242
5758 #, no-wrap
5759 msgid "y0(0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5760 msgstr ""
5761
5762 #. type: tbl table
5763 #: build/C/man3/matherr.3:243
5764 #, no-wrap
5765 msgid "y0(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5766 msgstr ""
5767
5768 #. type: tbl table
5769 #: build/C/man3/matherr.3:244
5770 #, no-wrap
5771 msgid "y1(0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5772 msgstr ""
5773
5774 #. type: tbl table
5775 #: build/C/man3/matherr.3:245
5776 #, no-wrap
5777 msgid "y1(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5778 msgstr ""
5779
5780 #. type: tbl table
5781 #: build/C/man3/matherr.3:246
5782 #, no-wrap
5783 msgid "yn(n,0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5784 msgstr ""
5785
5786 #. type: tbl table
5787 #: build/C/man3/matherr.3:247
5788 #, no-wrap
5789 msgid "yn(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5790 msgstr ""
5791
5792 #. type: tbl table
5793 #: build/C/man3/matherr.3:248
5794 #, no-wrap
5795 msgid "lgamma(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5796 msgstr ""
5797
5798 #. type: tbl table
5799 #: build/C/man3/matherr.3:249
5800 #, no-wrap
5801 msgid "lgamma(-int) or\tSING\tHUGE\ty\tEDOM\n"
5802 msgstr ""
5803
5804 #. type: tbl table
5805 #: build/C/man3/matherr.3:250
5806 #, no-wrap
5807 msgid "\\ \\ lgamma(0)\n"
5808 msgstr ""
5809
5810 #. type: tbl table
5811 #: build/C/man3/matherr.3:251
5812 #, no-wrap
5813 msgid "tgamma(fin) o/f\tOVERFLOW\tHUGE_VAL\tn\tERANGE\n"
5814 msgstr ""
5815
5816 #. type: tbl table
5817 #: build/C/man3/matherr.3:252
5818 #, no-wrap
5819 msgid "tgamma(-int)\tSING\tNAN\ty\tEDOM\n"
5820 msgstr ""
5821
5822 #. type: tbl table
5823 #: build/C/man3/matherr.3:253
5824 #, no-wrap
5825 msgid "tgamma(0)\tSING\tcopysign(\ty\tERANGE\n"
5826 msgstr ""
5827
5828 #. type: tbl table
5829 #: build/C/man3/matherr.3:254
5830 #, no-wrap
5831 msgid "\\ \t\\ \tHUGE_VAL,x)\n"
5832 msgstr ""
5833
5834 #. type: tbl table
5835 #: build/C/man3/matherr.3:255
5836 #, no-wrap
5837 msgid "log(0)\tSING\t-HUGE\ty\tEDOM\n"
5838 msgstr ""
5839
5840 #. type: tbl table
5841 #: build/C/man3/matherr.3:256
5842 #, no-wrap
5843 msgid "log(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5844 msgstr ""
5845
5846 #.  different from log()
5847 #. type: tbl table
5848 #: build/C/man3/matherr.3:257
5849 #, no-wrap
5850 msgid "log2(0)\tSING\t-HUGE\tn\tEDOM\t\n"
5851 msgstr ""
5852
5853 #.  different from log()
5854 #. type: tbl table
5855 #: build/C/man3/matherr.3:258
5856 #, no-wrap
5857 msgid "log2(xE<lt>0)\tDOMAIN\t-HUGE\tn\tEDOM\t\n"
5858 msgstr ""
5859
5860 #. type: tbl table
5861 #: build/C/man3/matherr.3:259
5862 #, no-wrap
5863 msgid "log10(0)\tSING\t-HUGE\ty\tEDOM\n"
5864 msgstr ""
5865
5866 #. type: tbl table
5867 #: build/C/man3/matherr.3:260
5868 #, no-wrap
5869 msgid "log10(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5870 msgstr ""
5871
5872 #. type: tbl table
5873 #: build/C/man3/matherr.3:261
5874 #, no-wrap
5875 msgid "pow(0.0,0.0)\tDOMAIN\t0.0\ty\tEDOM\n"
5876 msgstr ""
5877
5878 #. type: tbl table
5879 #: build/C/man3/matherr.3:262
5880 #, no-wrap
5881 msgid "pow(x,y) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5882 msgstr ""
5883
5884 #. type: tbl table
5885 #: build/C/man3/matherr.3:263
5886 #, no-wrap
5887 msgid "pow(x,y) u/f\tUNDERFLOW\t0.0\tn\tERANGE\n"
5888 msgstr ""
5889
5890 #. type: tbl table
5891 #: build/C/man3/matherr.3:264
5892 #, no-wrap
5893 msgid "pow(NaN,0.0)\tDOMAIN\tx\tn\tEDOM\n"
5894 msgstr ""
5895
5896 #.  +0 and -0
5897 #. type: tbl table
5898 #: build/C/man3/matherr.3:265
5899 #, no-wrap
5900 msgid "0**neg\tDOMAIN\t0.0\ty\tEDOM\t\n"
5901 msgstr ""
5902
5903 #. type: tbl table
5904 #: build/C/man3/matherr.3:266
5905 #, no-wrap
5906 msgid "neg**non-int\tDOMAIN\t0.0\ty\tEDOM\n"
5907 msgstr ""
5908
5909 #. type: tbl table
5910 #: build/C/man3/matherr.3:267
5911 #, no-wrap
5912 msgid "scalb() o/f\tOVERFLOW\t(xE<gt>0.0) ?\tn\tERANGE\n"
5913 msgstr ""
5914
5915 #. type: tbl table
5916 #: build/C/man3/matherr.3:270
5917 #, no-wrap
5918 msgid "scalb() u/f\tUNDERFLOW\tcopysign(\tn\tERANGE\n"
5919 msgstr ""
5920
5921 #. type: tbl table
5922 #: build/C/man3/matherr.3:271
5923 #, no-wrap
5924 msgid "\\ \t\\ \t\\ \\ 0.0,x)\n"
5925 msgstr ""
5926
5927 #. type: tbl table
5928 #: build/C/man3/matherr.3:272
5929 #, no-wrap
5930 msgid "fmod(x,0)\tDOMAIN\tx\ty\tEDOM\n"
5931 msgstr ""
5932
5933 #.  retval is 0.0/0.0
5934 #. type: tbl table
5935 #: build/C/man3/matherr.3:273
5936 #, no-wrap
5937 msgid "remainder(x,0)\tDOMAIN\tNAN\ty\tEDOM\t\n"
5938 msgstr ""
5939
5940 #. type: Plain text
5941 #: build/C/man3/matherr.3:296
5942 msgid ""
5943 "The example program demonstrates the use of B<matherr>()  when calling "
5944 "B<log>(3).  The program takes up to three command-line arguments.  The first "
5945 "argument is the floating-point number to be given to B<log>(3).  If the "
5946 "optional second argument is provided, then B<_LIB_VERSION> is set to "
5947 "B<_SVID_> so that B<matherr>()  is called, and the integer supplied in the "
5948 "command-line argument is used as the return value from B<matherr>().  If the "
5949 "optional third command-line argument is supplied, then it specifies an "
5950 "alternative return value that B<matherr>()  should assign as the return "
5951 "value of the math function."
5952 msgstr ""
5953
5954 #. type: Plain text
5955 #: build/C/man3/matherr.3:301
5956 msgid ""
5957 "The following example run, where B<log>(3)  is given an argument of 0.0, "
5958 "does not use B<matherr>():"
5959 msgstr ""
5960
5961 #. type: Plain text
5962 #: build/C/man3/matherr.3:307
5963 #, no-wrap
5964 msgid ""
5965 "$B< ./a.out 0.0>\n"
5966 "errno: Numerical result out of range\n"
5967 "x=-inf\n"
5968 msgstr ""
5969
5970 #. type: Plain text
5971 #: build/C/man3/matherr.3:313
5972 msgid "In the following run, B<matherr>()  is called, and returns 0:"
5973 msgstr ""
5974
5975 #. type: Plain text
5976 #: build/C/man3/matherr.3:323
5977 #, no-wrap
5978 msgid ""
5979 "$B< ./a.out 0.0 0>\n"
5980 "matherr SING exception in log() function\n"
5981 "        args:   0.000000, 0.000000\n"
5982 "        retval: -340282346638528859811704183484516925440.000000\n"
5983 "log: SING error\n"
5984 "errno: Numerical argument out of domain\n"
5985 "x=-340282346638528859811704183484516925440.000000\n"
5986 msgstr ""
5987
5988 #. type: Plain text
5989 #: build/C/man3/matherr.3:327
5990 msgid "The message \"log: SING error\" was printed by the C library."
5991 msgstr ""
5992
5993 #. type: Plain text
5994 #: build/C/man3/matherr.3:331
5995 msgid "In the following run, B<matherr>()  is called, and returns a nonzero value:"
5996 msgstr ""
5997
5998 #. type: Plain text
5999 #: build/C/man3/matherr.3:339
6000 #, no-wrap
6001 msgid ""
6002 "$B< ./a.out 0.0 1>\n"
6003 "matherr SING exception in log() function\n"
6004 "        args:   0.000000, 0.000000\n"
6005 "        retval: -340282346638528859811704183484516925440.000000\n"
6006 "x=-340282346638528859811704183484516925440.000000\n"
6007 msgstr ""
6008
6009 #. type: Plain text
6010 #: build/C/man3/matherr.3:345
6011 msgid ""
6012 "In this case, the C library did not print a message, and I<errno> was not "
6013 "set."
6014 msgstr ""
6015
6016 #. type: Plain text
6017 #: build/C/man3/matherr.3:350
6018 msgid ""
6019 "In the following run, B<matherr>()  is called, changes the return value of "
6020 "the math function, and returns a nonzero value:"
6021 msgstr ""
6022
6023 #. type: Plain text
6024 #: build/C/man3/matherr.3:358
6025 #, no-wrap
6026 msgid ""
6027 "$B< ./a.out 0.0 1 12345.0>\n"
6028 "matherr SING exception in log() function\n"
6029 "        args:   0.000000, 0.000000\n"
6030 "        retval: -340282346638528859811704183484516925440.000000\n"
6031 "x=12345.000000\n"
6032 msgstr ""
6033
6034 #. type: Plain text
6035 #: build/C/man3/matherr.3:368
6036 #, no-wrap
6037 msgid ""
6038 "#define _SVID_SOURCE\n"
6039 "#include E<lt>errno.hE<gt>\n"
6040 "#include E<lt>math.hE<gt>\n"
6041 "#include E<lt>stdio.hE<gt>\n"
6042 "#include E<lt>stdlib.hE<gt>\n"
6043 msgstr ""
6044
6045 #. type: Plain text
6046 #: build/C/man3/matherr.3:374
6047 #, no-wrap
6048 msgid ""
6049 "static int matherr_ret = 0;     /* Value that matherr()\n"
6050 "                                   should return */\n"
6051 "static int change_retval = 0;   /* Should matherr() change\n"
6052 "                                   function\\(aqs return value? */\n"
6053 "static double new_retval;       /* New function return value */\n"
6054 msgstr ""
6055
6056 #. type: Plain text
6057 #: build/C/man3/matherr.3:389
6058 #, no-wrap
6059 msgid ""
6060 "int\n"
6061 "matherr(struct exception *exc)\n"
6062 "{\n"
6063 "    fprintf(stderr, \"matherr %s exception in %s() function\\en\",\n"
6064 "           (exc-E<gt>type == DOMAIN) ?    \"DOMAIN\" :\n"
6065 "           (exc-E<gt>type == OVERFLOW) ?  \"OVERFLOW\" :\n"
6066 "           (exc-E<gt>type == UNDERFLOW) ? \"UNDERFLOW\" :\n"
6067 "           (exc-E<gt>type == SING) ?      \"SING\" :\n"
6068 "           (exc-E<gt>type == TLOSS) ?     \"TLOSS\" :\n"
6069 "           (exc-E<gt>type == PLOSS) ?     \"PLOSS\" : \"???\",\n"
6070 "            exc-E<gt>name);\n"
6071 "    fprintf(stderr, \"        args:   %f, %f\\en\",\n"
6072 "            exc-E<gt>arg1, exc-E<gt>arg2);\n"
6073 "    fprintf(stderr, \"        retval: %f\\en\", exc-E<gt>retval);\n"
6074 msgstr ""
6075
6076 #. type: Plain text
6077 #: build/C/man3/matherr.3:392
6078 #, no-wrap
6079 msgid ""
6080 "    if (change_retval)\n"
6081 "        exc-E<gt>retval = new_retval;\n"
6082 msgstr ""
6083
6084 #. type: Plain text
6085 #: build/C/man3/matherr.3:395
6086 #, no-wrap
6087 msgid ""
6088 "    return matherr_ret;\n"
6089 "}\n"
6090 msgstr ""
6091
6092 #. type: Plain text
6093 #: build/C/man3/matherr.3:400
6094 #, no-wrap
6095 msgid ""
6096 "int\n"
6097 "main(int argc, char *argv[])\n"
6098 "{\n"
6099 "    double x;\n"
6100 msgstr ""
6101
6102 #. type: Plain text
6103 #: build/C/man3/matherr.3:406
6104 #, no-wrap
6105 msgid ""
6106 "    if (argc E<lt> 2) {\n"
6107 "        fprintf(stderr, \"Usage: %s E<lt>argvalE<gt>\"\n"
6108 "                \" [E<lt>matherr-retE<gt> "
6109 "[E<lt>new-func-retvalE<gt>]]\\en\", argv[0]);\n"
6110 "        exit(EXIT_FAILURE);\n"
6111 "    }\n"
6112 msgstr ""
6113
6114 #. type: Plain text
6115 #: build/C/man3/matherr.3:411
6116 #, no-wrap
6117 msgid ""
6118 "    if (argc E<gt> 2) {\n"
6119 "        _LIB_VERSION = _SVID_;\n"
6120 "        matherr_ret = atoi(argv[2]);\n"
6121 "    }\n"
6122 msgstr ""
6123
6124 #. type: Plain text
6125 #: build/C/man3/matherr.3:416
6126 #, no-wrap
6127 msgid ""
6128 "    if (argc E<gt> 3) {\n"
6129 "        change_retval = 1;\n"
6130 "        new_retval = atof(argv[3]);\n"
6131 "    }\n"
6132 msgstr ""
6133
6134 #. type: Plain text
6135 #: build/C/man3/matherr.3:420
6136 #, no-wrap
6137 msgid ""
6138 "    x = log(atof(argv[1]));\n"
6139 "    if (errno != 0)\n"
6140 "        perror(\"errno\");\n"
6141 msgstr ""
6142
6143 #. type: Plain text
6144 #: build/C/man3/matherr.3:424
6145 #, no-wrap
6146 msgid ""
6147 "    printf(\"x=%f\\en\", x);\n"
6148 "    exit(EXIT_SUCCESS);\n"
6149 "}\n"
6150 msgstr ""
6151
6152 #. type: Plain text
6153 #: build/C/man3/matherr.3:429
6154 msgid "B<fenv>(3), B<math_error>(7), B<standards>(7)"
6155 msgstr ""
6156
6157 #. type: TH
6158 #: build/C/man3/modf.3:33
6159 #, no-wrap
6160 msgid "MODF"
6161 msgstr ""
6162
6163 #. type: Plain text
6164 #: build/C/man3/modf.3:37
6165 msgid ""
6166 "modf, modff, modfl - extract signed integral and fractional values from "
6167 "floating-point number"
6168 msgstr ""
6169
6170 #. type: Plain text
6171 #: build/C/man3/modf.3:42
6172 #, no-wrap
6173 msgid "B<double modf(double >I<x>B<, double *>I<iptr>B<);>\n"
6174 msgstr ""
6175
6176 #. type: Plain text
6177 #: build/C/man3/modf.3:44
6178 #, no-wrap
6179 msgid "B<float modff(float >I<x>B<, float *>I<iptr>B<);>\n"
6180 msgstr ""
6181
6182 #. type: Plain text
6183 #: build/C/man3/modf.3:46
6184 #, no-wrap
6185 msgid "B<long double modfl(long double >I<x>B<, long double *>I<iptr>B<);>\n"
6186 msgstr ""
6187
6188 #. type: Plain text
6189 #: build/C/man3/modf.3:58
6190 msgid "B<modf>(), B<modfl>():"
6191 msgstr ""
6192
6193 #. type: Plain text
6194 #: build/C/man3/modf.3:76
6195 msgid ""
6196 "The B<modf>()  function breaks the argument I<x> into an integral part and a "
6197 "fractional part, each of which has the same sign as I<x>.  The integral part "
6198 "is stored in the location pointed to by I<iptr>."
6199 msgstr ""
6200
6201 #. type: Plain text
6202 #: build/C/man3/modf.3:81
6203 msgid "The B<modf>()  function returns the fractional part of I<x>."
6204 msgstr ""
6205
6206 #. type: Plain text
6207 #: build/C/man3/modf.3:87
6208 msgid "If I<x> is a NaN, a NaN is returned, and I<*iptr> is set to a NaN."
6209 msgstr ""
6210
6211 #. type: Plain text
6212 #: build/C/man3/modf.3:93
6213 msgid ""
6214 "If I<x> is positive infinity (negative infinity), +0 (-0) is returned, and "
6215 "I<*iptr> is set to positive infinity (negative infinity)."
6216 msgstr ""
6217
6218 #. type: Plain text
6219 #: build/C/man3/modf.3:103
6220 msgid "The B<modf>(), B<modff>(), and B<modfl>()  functions are thread-safe."
6221 msgstr ""
6222
6223 #. type: Plain text
6224 #: build/C/man3/modf.3:112
6225 msgid "B<frexp>(3), B<ldexp>(3)"
6226 msgstr ""
6227
6228 #. type: TH
6229 #: build/C/man3/nan.3:11
6230 #, no-wrap
6231 msgid "NAN"
6232 msgstr ""
6233
6234 #. type: Plain text
6235 #: build/C/man3/nan.3:14
6236 msgid "nan, nanf, nanl - return 'Not a Number'"
6237 msgstr ""
6238
6239 #. type: Plain text
6240 #: build/C/man3/nan.3:18
6241 msgid "B<double nan(const char *>I<tagp>B<);>"
6242 msgstr ""
6243
6244 #. type: Plain text
6245 #: build/C/man3/nan.3:20
6246 msgid "B<float nanf(const char *>I<tagp>B<);>"
6247 msgstr ""
6248
6249 #. type: Plain text
6250 #: build/C/man3/nan.3:22
6251 msgid "B<long double nanl(const char *>I<tagp>B<);>"
6252 msgstr ""
6253
6254 #. type: Plain text
6255 #: build/C/man3/nan.3:34
6256 msgid "B<nan>(), B<nanf>(), B<nanl>():"
6257 msgstr ""
6258
6259 #. type: Plain text
6260 #: build/C/man3/nan.3:48
6261 msgid ""
6262 "These functions return a representation (determined by I<tagp>)  of a quiet "
6263 "NaN.  If the implementation does not support quiet NaNs, these functions "
6264 "return zero."
6265 msgstr ""
6266
6267 #. type: Plain text
6268 #: build/C/man3/nan.3:52
6269 msgid "The call I<nan(\"char-sequence\")> is equivalent to:"
6270 msgstr ""
6271
6272 #. type: Plain text
6273 #: build/C/man3/nan.3:55
6274 #, no-wrap
6275 msgid "    strtod(\"NAN(char-sequence)\", NULL);\n"
6276 msgstr ""
6277
6278 #. type: Plain text
6279 #: build/C/man3/nan.3:65
6280 msgid ""
6281 "Similarly, calls to B<nanf>()  and B<nanl>()  are equivalent to analogous "
6282 "calls to B<strtof>(3)  and B<strtold>(3)."
6283 msgstr ""
6284
6285 #. type: Plain text
6286 #: build/C/man3/nan.3:73
6287 msgid ""
6288 "The argument I<tagp> is used in an unspecified manner.  On IEEE 754 systems, "
6289 "there are many representations of NaN, and I<tagp> selects one.  On other "
6290 "systems it may do nothing."
6291 msgstr ""
6292
6293 #. type: Plain text
6294 #: build/C/man3/nan.3:79
6295 msgid ""
6296 "C99, POSIX.1-2001.  See also IEC 559 and the appendix with recommended "
6297 "functions in IEEE 754/IEEE 854."
6298 msgstr ""
6299
6300 #. type: Plain text
6301 #: build/C/man3/nan.3:83
6302 msgid "B<isnan>(3), B<strtod>(3), B<math_error>(7)"
6303 msgstr ""
6304
6305 #. type: TH
6306 #: build/C/man3/nextafter.3:11
6307 #, no-wrap
6308 msgid "NEXTAFTER"
6309 msgstr ""
6310
6311 #. type: Plain text
6312 #: build/C/man3/nextafter.3:15
6313 msgid ""
6314 "nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl - "
6315 "floating-point number manipulation"
6316 msgstr ""
6317
6318 #. type: Plain text
6319 #: build/C/man3/nextafter.3:19
6320 msgid "B<double nextafter(double >I<x>B<, double >I<y>B<);>"
6321 msgstr ""
6322
6323 #. type: Plain text
6324 #: build/C/man3/nextafter.3:21
6325 msgid "B<float nextafterf(float >I<x>B<, float >I<y>B<);>"
6326 msgstr ""
6327
6328 #. type: Plain text
6329 #: build/C/man3/nextafter.3:23
6330 msgid "B<long double nextafterl(long double >I<x>B<, long double >I<y>B<);>"
6331 msgstr ""
6332
6333 #. type: Plain text
6334 #: build/C/man3/nextafter.3:25
6335 msgid "B<double nexttoward(double >I<x>B<, long double >I<y>B<);>"
6336 msgstr ""
6337
6338 #. type: Plain text
6339 #: build/C/man3/nextafter.3:27
6340 msgid "B<float nexttowardf(float >I<x>B<, long double >I<y>B<);>"
6341 msgstr ""
6342
6343 #. type: Plain text
6344 #: build/C/man3/nextafter.3:29
6345 msgid "B<long double nexttowardl(long double >I<x>B<, long double >I<y>B<);>"
6346 msgstr ""
6347
6348 #. type: Plain text
6349 #: build/C/man3/nextafter.3:39
6350 msgid "B<nextafter>():"
6351 msgstr ""
6352
6353 #. type: Plain text
6354 #: build/C/man3/nextafter.3:51
6355 msgid "B<nextafterf>(), B<nextafterl>():"
6356 msgstr ""
6357
6358 #. type: Plain text
6359 #: build/C/man3/nextafter.3:62
6360 msgid "B<nexttoward>(), B<nexttowardf>(), B<nexttowardl>():"
6361 msgstr ""
6362
6363 #. type: Plain text
6364 #: build/C/man3/nextafter.3:83
6365 msgid ""
6366 "The B<nextafter>()  functions return the next representable floating-point "
6367 "value following I<x> in the direction of I<y>.  If I<y> is less than I<x>, "
6368 "these functions will return the largest representable number less than I<x>."
6369 msgstr ""
6370
6371 #. type: Plain text
6372 #: build/C/man3/nextafter.3:90
6373 msgid "If I<x> equals I<y>, the functions return I<y>."
6374 msgstr ""
6375
6376 #. type: Plain text
6377 #: build/C/man3/nextafter.3:98
6378 msgid ""
6379 "The B<nexttoward>()  functions do the same as the B<nextafter>()  functions, "
6380 "except that they have a I<long double> second argument."
6381 msgstr ""
6382
6383 #. type: Plain text
6384 #: build/C/man3/nextafter.3:104
6385 msgid ""
6386 "On success, these functions return the next representable floating-point "
6387 "value after I<x> in the direction of I<y>."
6388 msgstr ""
6389
6390 #. type: Plain text
6391 #: build/C/man3/nextafter.3:114
6392 msgid "If I<x> equals I<y>, then I<y> (cast to the same type as I<x>)  is returned."
6393 msgstr ""
6394
6395 #.  e.g., DBL_MAX
6396 #. type: Plain text
6397 #: build/C/man3/nextafter.3:134
6398 msgid ""
6399 "If I<x> is finite, and the result would overflow, a range error occurs, and "
6400 "the functions return B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, "
6401 "respectively, with the correct mathematical sign."
6402 msgstr ""
6403
6404 #. type: Plain text
6405 #: build/C/man3/nextafter.3:143
6406 msgid ""
6407 "If I<x> is not equal to I<y>, and the correct function result would be "
6408 "subnormal, zero, or underflow, a range error occurs, and either the correct "
6409 "value (if it can be represented), or 0.0, is returned."
6410 msgstr ""
6411
6412 #. type: TP
6413 #: build/C/man3/nextafter.3:159
6414 #, no-wrap
6415 msgid "Range error: result is subnormal or underflows"
6416 msgstr ""
6417
6418 #. type: Plain text
6419 #: build/C/man3/nextafter.3:182
6420 msgid ""
6421 "In glibc version 2.5 and earlier, these functions do not raise an underflow "
6422 "floating-point (B<FE_UNDERFLOW>)  exception when an underflow occurs."
6423 msgstr ""
6424
6425 #. type: Plain text
6426 #: build/C/man3/nextafter.3:184
6427 msgid "B<nearbyint>(3)"
6428 msgstr ""
6429
6430 #. type: TH
6431 #: build/C/man3/pow.3:35
6432 #, no-wrap
6433 msgid "POW"
6434 msgstr ""
6435
6436 #. type: Plain text
6437 #: build/C/man3/pow.3:38
6438 msgid "pow, powf, powl - power functions"
6439 msgstr ""
6440
6441 #. type: Plain text
6442 #: build/C/man3/pow.3:43
6443 #, no-wrap
6444 msgid "B<double pow(double >I<x>B<, double >I<y>B<);>\n"
6445 msgstr ""
6446
6447 #. type: Plain text
6448 #: build/C/man3/pow.3:45
6449 #, no-wrap
6450 msgid "B<float powf(float >I<x>B<, float >I<y>B<);>\n"
6451 msgstr ""
6452
6453 #. type: Plain text
6454 #: build/C/man3/pow.3:47
6455 #, no-wrap
6456 msgid "B<long double powl(long double >I<x>B<, long double >I<y>B<);>\n"
6457 msgstr ""
6458
6459 #. type: Plain text
6460 #: build/C/man3/pow.3:59
6461 msgid "B<powf>(), B<powl>():"
6462 msgstr ""
6463
6464 #. type: Plain text
6465 #: build/C/man3/pow.3:75
6466 msgid ""
6467 "The B<pow>()  function returns the value of I<x> raised to the power of "
6468 "I<y>."
6469 msgstr ""
6470
6471 #. type: Plain text
6472 #: build/C/man3/pow.3:80
6473 msgid "On success, these functions return the value of I<x> to the power of I<y>."
6474 msgstr ""
6475
6476 #.  The domain error is generated at least as far back as glibc 2.4
6477 #. type: Plain text
6478 #: build/C/man3/pow.3:88
6479 msgid ""
6480 "If I<x> is a finite value less than 0, and I<y> is a finite noninteger, a "
6481 "domain error occurs, and a NaN is returned."
6482 msgstr ""
6483
6484 #.  The range error is generated at least as far back as glibc 2.4
6485 #. type: Plain text
6486 #: build/C/man3/pow.3:98
6487 msgid ""
6488 "If the result overflows, a range error occurs, and the functions return "
6489 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the "
6490 "mathematically correct sign."
6491 msgstr ""
6492
6493 #.  POSIX.1 does not specify the sign of the zero,
6494 #.  but http://sources.redhat.com/bugzilla/show_bug.cgi?id=2678
6495 #.  points out that the zero has the wrong sign in some cases.
6496 #. type: Plain text
6497 #: build/C/man3/pow.3:105
6498 msgid ""
6499 "If result underflows, and is not representable, a range error occurs, and "
6500 "0.0 is returned."
6501 msgstr ""
6502
6503 #. type: Plain text
6504 #: build/C/man3/pow.3:111
6505 msgid "Except as specified below, if I<x> or I<y> is a NaN, the result is a NaN."
6506 msgstr ""
6507
6508 #. type: Plain text
6509 #: build/C/man3/pow.3:117
6510 msgid "If I<x> is +1, the result is 1.0 (even if I<y> is a NaN)."
6511 msgstr ""
6512
6513 #. type: Plain text
6514 #: build/C/man3/pow.3:123
6515 msgid "If I<y> is 0, the result is 1.0 (even if I<x> is a NaN)."
6516 msgstr ""
6517
6518 #. type: Plain text
6519 #: build/C/man3/pow.3:131
6520 msgid ""
6521 "If I<x> is +0 (-0), and I<y> is an odd integer greater than 0, the result is "
6522 "+0 (-0)."
6523 msgstr ""
6524
6525 #. type: Plain text
6526 #: build/C/man3/pow.3:139
6527 msgid ""
6528 "If I<x> is 0, and I<y> greater than 0 and not an odd integer, the result is "
6529 "+0."
6530 msgstr ""
6531
6532 #. type: Plain text
6533 #: build/C/man3/pow.3:147
6534 msgid ""
6535 "If I<x> is -1, and I<y> is positive infinity or negative infinity, the "
6536 "result is 1.0."
6537 msgstr ""
6538
6539 #. type: Plain text
6540 #: build/C/man3/pow.3:155
6541 msgid ""
6542 "If the absolute value of I<x> is less than 1, and I<y> is negative infinity, "
6543 "the result is positive infinity."
6544 msgstr ""
6545
6546 #. type: Plain text
6547 #: build/C/man3/pow.3:163
6548 msgid ""
6549 "If the absolute value of I<x> is greater than 1, and I<y> is negative "
6550 "infinity, the result is +0."
6551 msgstr ""
6552
6553 #. type: Plain text
6554 #: build/C/man3/pow.3:171
6555 msgid ""
6556 "If the absolute value of I<x> is less than 1, and I<y> is positive infinity, "
6557 "the result is +0."
6558 msgstr ""
6559
6560 #. type: Plain text
6561 #: build/C/man3/pow.3:179
6562 msgid ""
6563 "If the absolute value of I<x> is greater than 1, and I<y> is positive "
6564 "infinity, the result is positive infinity."
6565 msgstr ""
6566
6567 #. type: Plain text
6568 #: build/C/man3/pow.3:187
6569 msgid ""
6570 "If I<x> is negative infinity, and I<y> is an odd integer less than 0, the "
6571 "result is -0."
6572 msgstr ""
6573
6574 #. type: Plain text
6575 #: build/C/man3/pow.3:195
6576 msgid ""
6577 "If I<x> is negative infinity, and I<y> less than 0 and not an odd integer, "
6578 "the result is +0."
6579 msgstr ""
6580
6581 #. type: Plain text
6582 #: build/C/man3/pow.3:203
6583 msgid ""
6584 "If I<x> is negative infinity, and I<y> is an odd integer greater than 0, the "
6585 "result is negative infinity."
6586 msgstr ""
6587
6588 #. type: Plain text
6589 #: build/C/man3/pow.3:211
6590 msgid ""
6591 "If I<x> is negative infinity, and I<y> greater than 0 and not an odd "
6592 "integer, the result is positive infinity."
6593 msgstr ""
6594
6595 #. type: Plain text
6596 #: build/C/man3/pow.3:219
6597 msgid "If I<x> is positive infinity, and I<y> less than 0, the result is +0."
6598 msgstr ""
6599
6600 #. type: Plain text
6601 #: build/C/man3/pow.3:227
6602 msgid ""
6603 "If I<x> is positive infinity, and I<y> greater than 0, the result is "
6604 "positive infinity."
6605 msgstr ""
6606
6607 #. type: Plain text
6608 #: build/C/man3/pow.3:242
6609 msgid ""
6610 "If I<x> is +0 or -0, and I<y> is an odd integer less than 0, a pole error "
6611 "occurs and B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, is returned, with the "
6612 "same sign as I<x>."
6613 msgstr ""
6614
6615 #.  The pole error is generated at least as far back as glibc 2.4
6616 #. type: Plain text
6617 #: build/C/man3/pow.3:256
6618 msgid ""
6619 "If I<x> is +0 or -0, and I<y> is less than 0 and not an odd integer, a pole "
6620 "error occurs and +B<HUGE_VAL>, +B<HUGE_VALF>, or +B<HUGE_VALL>, is returned."
6621 msgstr ""
6622
6623 #. type: TP
6624 #: build/C/man3/pow.3:283
6625 #, no-wrap
6626 msgid "Domain error: I<x> is negative, and I<y> is a finite noninteger"
6627 msgstr ""
6628
6629 #. type: TP
6630 #: build/C/man3/pow.3:291
6631 #, no-wrap
6632 msgid "Pole error: I<x> is zero, and I<y> is negative"
6633 msgstr ""
6634
6635 #. type: TP
6636 #: build/C/man3/pow.3:300
6637 #, no-wrap
6638 msgid "Range error: the result overflows"
6639 msgstr ""
6640
6641 #. type: TP
6642 #: build/C/man3/pow.3:308
6643 #, no-wrap
6644 msgid "Range error: the result underflows"
6645 msgstr ""
6646
6647 #
6648 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776
6649 #.  or possibly 2.9, I haven't found the source code change
6650 #.  and I don't have a 2.9 system to test
6651 #. type: Plain text
6652 #: build/C/man3/pow.3:336
6653 msgid ""
6654 "In glibc 2.9 and earlier, when a pole error occurs, I<errno> is set to "
6655 "B<EDOM> instead of the POSIX-mandated B<ERANGE>.  Since version 2.10, glibc "
6656 "does the right thing."
6657 msgstr ""
6658
6659 #.  see bug http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866
6660 #.  and http://sources.redhat.com/bugzilla/show_bug.cgi?id=369
6661 #. type: Plain text
6662 #: build/C/man3/pow.3:356
6663 msgid ""
6664 "If I<x> is negative, then large negative or positive I<y> values yield a NaN "
6665 "as the function result, with I<errno> set to B<EDOM>, and an invalid "
6666 "(B<FE_INVALID>)  floating-point exception.  For example, with B<pow>(), one "
6667 "sees this behavior when the absolute value of I<y> is greater than about "
6668 "9.223373e18."
6669 msgstr ""
6670
6671 #.  FIXME . Actually, 2.3.2 is the earliest test result I have; so yet
6672 #.  to confirm if this error occurs only in 2.3.2.
6673 #. type: Plain text
6674 #: build/C/man3/pow.3:365
6675 msgid ""
6676 "In version 2.3.2 and earlier, when an overflow or underflow error occurs, "
6677 "glibc's B<pow>()  generates a bogus invalid floating-point exception "
6678 "(B<FE_INVALID>)  in addition to the overflow or underflow exception."
6679 msgstr ""
6680
6681 #. type: Plain text
6682 #: build/C/man3/pow.3:369
6683 msgid "B<cbrt>(3), B<cpow>(3), B<sqrt>(3)"
6684 msgstr ""
6685
6686 #. type: TH
6687 #: build/C/man3/pow10.3:25
6688 #, no-wrap
6689 msgid "POW10"
6690 msgstr ""
6691
6692 #. type: Plain text
6693 #: build/C/man3/pow10.3:28
6694 msgid "pow10, pow10f, pow10l - base-10 power functions"
6695 msgstr ""
6696
6697 #. type: Plain text
6698 #: build/C/man3/pow10.3:32 build/C/man3/sincos.3:16
6699 #, no-wrap
6700 msgid ""
6701 "B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
6702 "B<#include E<lt>math.hE<gt>>\n"
6703 msgstr ""
6704
6705 #. type: Plain text
6706 #: build/C/man3/pow10.3:34
6707 #, no-wrap
6708 msgid "B<double pow10(double >I<x>B<);>\n"
6709 msgstr ""
6710
6711 #. type: Plain text
6712 #: build/C/man3/pow10.3:36
6713 #, no-wrap
6714 msgid "B<float pow10f(float >I<x>B<);>\n"
6715 msgstr ""
6716
6717 #. type: Plain text
6718 #: build/C/man3/pow10.3:38
6719 #, no-wrap
6720 msgid "B<long double pow10l(long double >I<x>B<);>\n"
6721 msgstr ""
6722
6723 #. type: Plain text
6724 #: build/C/man3/pow10.3:47
6725 msgid "The B<pow10>()  function returns the value of 10 raised to the power I<x>."
6726 msgstr ""
6727
6728 #. type: Plain text
6729 #: build/C/man3/pow10.3:51
6730 msgid "This is a GNU extension."
6731 msgstr ""
6732
6733 #. type: Plain text
6734 #: build/C/man3/pow10.3:54
6735 msgid "These functions are identical to the functions listed under B<exp10>(3)."
6736 msgstr ""
6737
6738 #. type: Plain text
6739 #: build/C/man3/pow10.3:57
6740 msgid "B<exp10>(3), B<pow>(3)"
6741 msgstr ""
6742
6743 #. type: TH
6744 #: build/C/man3/remainder.3:37
6745 #, no-wrap
6746 msgid "REMAINDER"
6747 msgstr ""
6748
6749 #. type: Plain text
6750 #: build/C/man3/remainder.3:41
6751 msgid ""
6752 "drem, dremf, dreml, remainder, remainderf, remainderl - floating-point "
6753 "remainder function"
6754 msgstr ""
6755
6756 #. type: Plain text
6757 #: build/C/man3/remainder.3:49
6758 #, no-wrap
6759 msgid ""
6760 "/* The C99 versions */\n"
6761 "B<double remainder(double >I<x>B<, double >I<y>B<);>\n"
6762 "B<float remainderf(float >I<x>B<, float >I<y>B<);>\n"
6763 "B<long double remainderl(long double >I<x>B<, long double >I<y>B<);>\n"
6764 msgstr ""
6765
6766 #. type: Plain text
6767 #: build/C/man3/remainder.3:54
6768 #, no-wrap
6769 msgid ""
6770 "/* Obsolete synonyms */\n"
6771 "B<double drem(double >I<x>B<, double >I<y>B<);>\n"
6772 "B<float dremf(float >I<x>B<, float >I<y>B<);>\n"
6773 "B<long double dreml(long double >I<x>B<, long double >I<y>B<);>\n"
6774 msgstr ""
6775
6776 #. type: Plain text
6777 #: build/C/man3/remainder.3:65
6778 msgid "B<remainder>():"
6779 msgstr ""
6780
6781 #. type: Plain text
6782 #: build/C/man3/remainder.3:70
6783 msgid ""
6784 "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
6785 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || "
6786 "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
6787 msgstr ""
6788
6789 #. type: Plain text
6790 #: build/C/man3/remainder.3:77
6791 msgid "B<remainderf>(), B<remainderl>():"
6792 msgstr ""
6793
6794 #. type: Plain text
6795 #: build/C/man3/remainder.3:88
6796 msgid "B<drem>(), B<dremf>(), B<dreml>():"
6797 msgstr ""
6798
6799 #. type: Plain text
6800 #: build/C/man3/remainder.3:90 build/C/man3/significand.3:35
6801 msgid "_SVID_SOURCE || _BSD_SOURCE"
6802 msgstr ""
6803
6804 #. type: Plain text
6805 #: build/C/man3/remainder.3:111
6806 msgid ""
6807 "The B<remainder>()  function computes the remainder of dividing I<x> by "
6808 "I<y>.  The return value is I<x>-I<n>*I<y>, where I<n> is the value I<x\\ /\\ "
6809 "y>, rounded to the nearest integer.  If the absolute value of I<x>-I<n>*I<y> "
6810 "is 0.5, I<n> is chosen to be even."
6811 msgstr ""
6812
6813 #. type: Plain text
6814 #: build/C/man3/remainder.3:114
6815 msgid ""
6816 "These functions are unaffected by the current rounding mode (see "
6817 "B<fenv>(3))."
6818 msgstr ""
6819
6820 #. type: Plain text
6821 #: build/C/man3/remainder.3:118
6822 msgid "The B<drem>()  function does precisely the same thing."
6823 msgstr ""
6824
6825 #. type: Plain text
6826 #: build/C/man3/remainder.3:124
6827 msgid ""
6828 "On success, these functions return the floating-point remainder, "
6829 "I<x>-I<n>*I<y>.  If the return value is 0, it has the sign of I<x>."
6830 msgstr ""
6831
6832 #. type: Plain text
6833 #: build/C/man3/remainder.3:139 build/C/man3/remquo.3:92
6834 msgid ""
6835 "If I<x> is an infinity, and I<y> is not a NaN, a domain error occurs, and a "
6836 "NaN is returned."
6837 msgstr ""
6838
6839 #. type: Plain text
6840 #: build/C/man3/remainder.3:150 build/C/man3/remquo.3:101
6841 msgid ""
6842 "If I<y> is zero, and I<x> is not a NaN, a domain error occurs, and a NaN is "
6843 "returned."
6844 msgstr ""
6845
6846 #. type: TP
6847 #: build/C/man3/remainder.3:157
6848 #, no-wrap
6849 msgid "Domain error: I<x> is an infinity and I<y> is not a NaN"
6850 msgstr ""
6851
6852 #.  IEC 60559.
6853 #. type: Plain text
6854 #: build/C/man3/remainder.3:188
6855 msgid ""
6856 "The functions B<remainder>(), B<remainderf>(), and B<remainderl>()  are "
6857 "specified in C99 and POSIX.1-2001."
6858 msgstr ""
6859
6860 #. type: Plain text
6861 #: build/C/man3/remainder.3:204
6862 msgid ""
6863 "The function B<drem>()  is from 4.3BSD.  The I<float> and I<long double> "
6864 "variants B<dremf>()  and B<dreml>()  exist on some systems, such as Tru64 "
6865 "and glibc2.  Avoid the use of these functions in favor of B<remainder>()  "
6866 "etc."
6867 msgstr ""
6868
6869 #. type: Plain text
6870 #: build/C/man3/remainder.3:206
6871 msgid "The call"
6872 msgstr ""
6873
6874 #. type: Plain text
6875 #: build/C/man3/remainder.3:208
6876 #, no-wrap
6877 msgid "    remainder(nan(\"\"), 0);\n"
6878 msgstr ""
6879
6880 #.  FIXME . this bug occurs as at glibc 2.8.
6881 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6779
6882 #. type: Plain text
6883 #: build/C/man3/remainder.3:213
6884 msgid ""
6885 "returns a NaN, as expected, but wrongly causes a domain error; it should "
6886 "yield a silent NaN."
6887 msgstr ""
6888
6889 #. type: Plain text
6890 #: build/C/man3/remainder.3:215
6891 msgid "The call \"remainder(29.0, 3.0)\" returns -1."
6892 msgstr ""
6893
6894 #. type: Plain text
6895 #: build/C/man3/remainder.3:219
6896 msgid "B<div>(3), B<fmod>(3), B<remquo>(3)"
6897 msgstr ""
6898
6899 #. type: TH
6900 #: build/C/man3/remquo.3:12
6901 #, no-wrap
6902 msgid "REMQUO"
6903 msgstr ""
6904
6905 #. type: Plain text
6906 #: build/C/man3/remquo.3:15
6907 msgid "remquo, remquof, remquol - remainder and part of quotient"
6908 msgstr ""
6909
6910 #. type: Plain text
6911 #: build/C/man3/remquo.3:20
6912 #, no-wrap
6913 msgid "B<double remquo(double >I<x>B<, double >I<y>B<, int *>I<quo>B<);>\n"
6914 msgstr ""
6915
6916 #. type: Plain text
6917 #: build/C/man3/remquo.3:22
6918 #, no-wrap
6919 msgid "B<float remquof(float >I<x>B<, float >I<y>B<, int *>I<quo>B<);>\n"
6920 msgstr ""
6921
6922 #. type: Plain text
6923 #: build/C/man3/remquo.3:24
6924 #, no-wrap
6925 msgid ""
6926 "B<long double remquol(long double >I<x>B<, long double >I<y>B<, int "
6927 "*>I<quo>B<);>\n"
6928 msgstr ""
6929
6930 #. type: Plain text
6931 #: build/C/man3/remquo.3:37
6932 msgid "B<remquo>(), B<remquof>(), B<remquol>():"
6933 msgstr ""
6934
6935 #. type: Plain text
6936 #: build/C/man3/remquo.3:55
6937 msgid ""
6938 "These functions compute the remainder and part of the quotient upon division "
6939 "of I<x> by I<y>.  A few bits of the quotient are stored via the I<quo> "
6940 "pointer.  The remainder is returned as the function result."
6941 msgstr ""
6942
6943 #. type: Plain text
6944 #: build/C/man3/remquo.3:59
6945 msgid ""
6946 "The value of the remainder is the same as that computed by the "
6947 "B<remainder>(3)  function."
6948 msgstr ""
6949
6950 #. type: Plain text
6951 #: build/C/man3/remquo.3:65
6952 msgid ""
6953 "The value stored via the I<quo> pointer has the sign of I<x\\ /\\ y> and "
6954 "agrees with the quotient in at least the low order 3 bits."
6955 msgstr ""
6956
6957 #.  A possible application of this function might be the computation
6958 #.  of sin(x). Compute remquo(x, pi/2, &quo) or so.
6959 #
6960 #.  glibc, UnixWare: return 3 bits
6961 #.  MacOS 10: return 7 bits
6962 #. type: Plain text
6963 #: build/C/man3/remquo.3:73
6964 msgid ""
6965 "For example, I<remquo(29.0,\\ 3.0)> returns -1.0 and might store 2.  Note "
6966 "that the actual quotient might not fit in an integer."
6967 msgstr ""
6968
6969 #. type: Plain text
6970 #: build/C/man3/remquo.3:77
6971 msgid ""
6972 "On success, these functions return the same value as the analogous functions "
6973 "described in B<remainder>(3)."
6974 msgstr ""
6975
6976 #. type: TP
6977 #: build/C/man3/remquo.3:108
6978 #, no-wrap
6979 msgid ""
6980 "Domain error: I<x> is an infinity or I<y> is 0, and the other argument is "
6981 "not a NaN"
6982 msgstr ""
6983
6984 #. type: Plain text
6985 #: build/C/man3/remquo.3:130
6986 msgid "B<fmod>(3), B<logb>(3), B<remainder>(3)"
6987 msgstr ""
6988
6989 #. type: TH
6990 #: build/C/man3/rint.3:27
6991 #, no-wrap
6992 msgid "RINT"
6993 msgstr ""
6994
6995 #. type: Plain text
6996 #: build/C/man3/rint.3:31
6997 msgid ""
6998 "nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - round to nearest "
6999 "integer"
7000 msgstr ""
7001
7002 #. type: Plain text
7003 #: build/C/man3/rint.3:36
7004 #, no-wrap
7005 msgid "B<double nearbyint(double >I<x>B<);>\n"
7006 msgstr ""
7007
7008 #. type: Plain text
7009 #: build/C/man3/rint.3:38
7010 #, no-wrap
7011 msgid "B<float nearbyintf(float >I<x>B<);>\n"
7012 msgstr ""
7013
7014 #. type: Plain text
7015 #: build/C/man3/rint.3:40
7016 #, no-wrap
7017 msgid "B<long double nearbyintl(long double >I<x>B<);>\n"
7018 msgstr ""
7019
7020 #. type: Plain text
7021 #: build/C/man3/rint.3:42
7022 #, no-wrap
7023 msgid "B<double rint(double >I<x>B<);>\n"
7024 msgstr ""
7025
7026 #. type: Plain text
7027 #: build/C/man3/rint.3:44
7028 #, no-wrap
7029 msgid "B<float rintf(float >I<x>B<);>\n"
7030 msgstr ""
7031
7032 #. type: Plain text
7033 #: build/C/man3/rint.3:46
7034 #, no-wrap
7035 msgid "B<long double rintl(long double >I<x>B<);>\n"
7036 msgstr ""
7037
7038 #. type: Plain text
7039 #: build/C/man3/rint.3:59
7040 msgid "B<nearbyint>(), B<nearbyintf>(), B<nearbyintl>():"
7041 msgstr ""
7042
7043 #. type: Plain text
7044 #: build/C/man3/rint.3:61
7045 msgid ""
7046 "_XOPEN_SOURCE\\ E<gt>=\\ 600 || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L || "
7047 "_ISOC99_SOURCE;"
7048 msgstr ""
7049
7050 #. type: Plain text
7051 #: build/C/man3/rint.3:67
7052 msgid "B<rint>():"
7053 msgstr ""
7054
7055 #. type: Plain text
7056 #: build/C/man3/rint.3:78
7057 msgid "B<rintf>(), B<rintl>():"
7058 msgstr ""
7059
7060 #. type: Plain text
7061 #: build/C/man3/rint.3:95
7062 msgid ""
7063 "The B<nearbyint>()  functions round their argument to an integer value in "
7064 "floating-point format, using the current rounding direction (see "
7065 "B<fesetround>(3))  and without raising the I<inexact> exception."
7066 msgstr ""
7067
7068 #. type: Plain text
7069 #: build/C/man3/rint.3:105
7070 msgid ""
7071 "The B<rint>()  functions do the same, but will raise the I<inexact> "
7072 "exception (B<FE_INEXACT>, checkable via B<fetestexcept>(3))  when the result "
7073 "differs in value from the argument."
7074 msgstr ""
7075
7076 #. type: Plain text
7077 #: build/C/man3/rint.3:138
7078 msgid ""
7079 "If you want to store the rounded value in an integer type, you probably want "
7080 "to use one of the functions described in B<lrint>(3)  instead."
7081 msgstr ""
7082
7083 #. type: Plain text
7084 #: build/C/man3/rint.3:144
7085 msgid "B<ceil>(3), B<floor>(3), B<lrint>(3), B<round>(3), B<trunc>(3)"
7086 msgstr ""
7087
7088 #. type: TH
7089 #: build/C/man3/round.3:27
7090 #, no-wrap
7091 msgid "ROUND"
7092 msgstr ""
7093
7094 #. type: Plain text
7095 #: build/C/man3/round.3:30
7096 msgid "round, roundf, roundl - round to nearest integer, away from zero"
7097 msgstr ""
7098
7099 #. type: Plain text
7100 #: build/C/man3/round.3:35
7101 #, no-wrap
7102 msgid "B<double round(double >I<x>B<);>\n"
7103 msgstr ""
7104
7105 #. type: Plain text
7106 #: build/C/man3/round.3:37
7107 #, no-wrap
7108 msgid "B<float roundf(float >I<x>B<);>\n"
7109 msgstr ""
7110
7111 #. type: Plain text
7112 #: build/C/man3/round.3:39
7113 #, no-wrap
7114 msgid "B<long double roundl(long double >I<x>B<);>\n"
7115 msgstr ""
7116
7117 #. type: Plain text
7118 #: build/C/man3/round.3:52
7119 msgid "B<round>(), B<roundf>(), B<roundl>():"
7120 msgstr ""
7121
7122 #. type: Plain text
7123 #: build/C/man3/round.3:69
7124 msgid ""
7125 "These functions round I<x> to the nearest integer, but round halfway cases "
7126 "away from zero (regardless of the current rounding direction, see "
7127 "B<fenv>(3)), instead of to the nearest even integer like B<rint>(3)."
7128 msgstr ""
7129
7130 #. type: Plain text
7131 #: build/C/man3/round.3:75
7132 msgid "For example, I<round(0.5)> is 1.0, and I<round(-0.5)> is -1.0."
7133 msgstr ""
7134
7135 #. type: Plain text
7136 #: build/C/man3/round.3:96
7137 msgid "The B<round>(), B<roundf>(), and B<roundl>()  functions are thread-safe."
7138 msgstr ""
7139
7140 #.  The POSIX.1-2001 APPLICATION USAGE SECTION discusses this point.
7141 #. type: Plain text
7142 #: build/C/man3/round.3:114
7143 msgid ""
7144 "POSIX.1-2001 contains text about overflow (which might set I<errno> to "
7145 "B<ERANGE>, or raise an B<FE_OVERFLOW> exception).  In practice, the result "
7146 "cannot overflow on any current machine, so this error-handling stuff is just "
7147 "nonsense.  (More precisely, overflow can happen only when the maximum value "
7148 "of the exponent is smaller than the number of mantissa bits.  For the "
7149 "IEEE-754 standard 32-bit and 64-bit floating-point numbers the maximum value "
7150 "of the exponent is 128 (respectively, 1024), and the number of mantissa bits "
7151 "is 24 (respectively, 53).)"
7152 msgstr ""
7153
7154 #. type: Plain text
7155 #: build/C/man3/round.3:119
7156 msgid ""
7157 "If you want to store the rounded value in an integer type, you probably want "
7158 "to use one of the functions described in B<lround>(3)  instead."
7159 msgstr ""
7160
7161 #. type: Plain text
7162 #: build/C/man3/round.3:126
7163 msgid ""
7164 "B<ceil>(3), B<floor>(3), B<lround>(3), B<nearbyint>(3), B<rint>(3), "
7165 "B<trunc>(3)"
7166 msgstr ""
7167
7168 #. type: TH
7169 #: build/C/man3/scalb.3:27
7170 #, no-wrap
7171 msgid "SCALB"
7172 msgstr ""
7173
7174 #. type: TH
7175 #: build/C/man3/scalb.3:27
7176 #, no-wrap
7177 msgid "2013-03-23"
7178 msgstr ""
7179
7180 #. type: Plain text
7181 #: build/C/man3/scalb.3:31
7182 msgid ""
7183 "scalb, scalbf, scalbl - multiply floating-point number by integral power of "
7184 "radix (OBSOLETE)"
7185 msgstr ""
7186
7187 #. type: Plain text
7188 #: build/C/man3/scalb.3:35
7189 msgid "B<double scalb(double >I<x>B<, double >I<exp>B<);>"
7190 msgstr ""
7191
7192 #. type: Plain text
7193 #: build/C/man3/scalb.3:37
7194 msgid "B<float scalbf(float >I<x>B<, float >I<exp>B<);>"
7195 msgstr ""
7196
7197 #. type: Plain text
7198 #: build/C/man3/scalb.3:39
7199 msgid "B<long double scalbl(long double >I<x>B<, long double >I<exp>B<);>"
7200 msgstr ""
7201
7202 #. type: Plain text
7203 #: build/C/man3/scalb.3:49
7204 msgid "B<scalb>():"
7205 msgstr ""
7206
7207 #. type: Plain text
7208 #: build/C/man3/scalb.3:52
7209 msgid ""
7210 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7211 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
7212 msgstr ""
7213
7214 #. type: Plain text
7215 #: build/C/man3/scalb.3:56
7216 msgid "B<scalbf>(), B<scalbl>():"
7217 msgstr ""
7218
7219 #. type: Plain text
7220 #: build/C/man3/scalb.3:69 build/C/man3/scalbln.3:85
7221 msgid ""
7222 "These functions multiply their first argument I<x> by B<FLT_RADIX> (probably "
7223 "2)  to the power of I<exp>, that is:"
7224 msgstr ""
7225
7226 #. type: Plain text
7227 #: build/C/man3/scalb.3:72 build/C/man3/scalbln.3:88
7228 #, no-wrap
7229 msgid "    x * FLT_RADIX ** exp\n"
7230 msgstr ""
7231
7232 #.  not in /usr/include but in a gcc lib
7233 #. type: Plain text
7234 #: build/C/man3/scalb.3:79 build/C/man3/scalbln.3:95
7235 msgid ""
7236 "The definition of B<FLT_RADIX> can be obtained by including "
7237 "I<E<lt>float.hE<gt>>."
7238 msgstr ""
7239
7240 #. type: Plain text
7241 #: build/C/man3/scalb.3:86 build/C/man3/scalbln.3:102
7242 msgid "On success, these functions return I<x> * B<FLT_RADIX> ** I<exp>."
7243 msgstr ""
7244
7245 #. type: Plain text
7246 #: build/C/man3/scalb.3:92
7247 msgid "If I<x> or I<exp> is a NaN, a NaN is returned."
7248 msgstr ""
7249
7250 #. type: Plain text
7251 #: build/C/man3/scalb.3:100
7252 msgid ""
7253 "If I<x> is positive infinity (negative infinity), and I<exp> is not negative "
7254 "infinity, positive infinity (negative infinity) is returned."
7255 msgstr ""
7256
7257 #. type: Plain text
7258 #: build/C/man3/scalb.3:106
7259 msgid ""
7260 "If I<x> is +0 (-0), and I<exp> is not positive infinity, +0 (-0) is "
7261 "returned."
7262 msgstr ""
7263
7264 #. type: Plain text
7265 #: build/C/man3/scalb.3:114
7266 msgid ""
7267 "If I<x> is zero, and I<exp> is positive infinity, a domain error occurs, and "
7268 "a NaN is returned."
7269 msgstr ""
7270
7271 #. type: Plain text
7272 #: build/C/man3/scalb.3:123
7273 msgid ""
7274 "If I<x> is an infinity, and I<exp> is negative infinity, a domain error "
7275 "occurs, and a NaN is returned."
7276 msgstr ""
7277
7278 #. type: Plain text
7279 #: build/C/man3/scalb.3:138 build/C/man3/scalbln.3:130
7280 msgid ""
7281 "If the result underflows, a range error occurs, and the functions return "
7282 "zero, with a sign the same as I<x>."
7283 msgstr ""
7284
7285 #. type: TP
7286 #: build/C/man3/scalb.3:145
7287 #, no-wrap
7288 msgid ""
7289 "Domain error: I<x> is 0, and I<exp> is positive infinity, or I<x> is "
7290 "positive infinity and I<exp> is negative infinity and the other argument is "
7291 "not a NaN"
7292 msgstr ""
7293
7294 #. type: Plain text
7295 #: build/C/man3/scalb.3:191
7296 msgid ""
7297 "B<scalb>()  is specified in POSIX.1-2001, but marked obsolescent.  "
7298 "POSIX.1-2008 removes the specification of B<scalb>(), recommending the use "
7299 "of B<scalbln>(3), B<scalblnf>(3), or B<scalblnl>(3)  instead.  The "
7300 "B<scalb>()  function is from 4.3BSD."
7301 msgstr ""
7302
7303 #.  Looking at header files: scalbf() is present on the
7304 #.  BSDs, Tru64, HP-UX 11, Irix 6.5; scalbl() is on HP-UX 11 and Tru64.
7305 #. type: Plain text
7306 #: build/C/man3/scalb.3:200
7307 msgid ""
7308 "B<scalbf>()  and B<scalbl>()  are unstandardized; B<scalbf>()  is "
7309 "nevertheless present on several other systems"
7310 msgstr ""
7311
7312 #. type: Plain text
7313 #: build/C/man3/scalb.3:203
7314 msgid "B<ldexp>(3), B<scalbln>(3)"
7315 msgstr ""
7316
7317 #. type: TH
7318 #: build/C/man3/scalbln.3:27
7319 #, no-wrap
7320 msgid "SCALBLN"
7321 msgstr ""
7322
7323 #. type: Plain text
7324 #: build/C/man3/scalbln.3:31
7325 msgid ""
7326 "scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl - multiply "
7327 "floating-point number by integral power of radix"
7328 msgstr ""
7329
7330 #. type: Plain text
7331 #: build/C/man3/scalbln.3:35
7332 msgid "B<double scalbln(double >I<x>B<, long int >I<exp>B<);>"
7333 msgstr ""
7334
7335 #. type: Plain text
7336 #: build/C/man3/scalbln.3:37
7337 msgid "B<float scalblnf(float >I<x>B<, long int >I<exp>B<);>"
7338 msgstr ""
7339
7340 #. type: Plain text
7341 #: build/C/man3/scalbln.3:39
7342 msgid "B<long double scalblnl(long double >I<x>B<, long int >I<exp>B<);>"
7343 msgstr ""
7344
7345 #. type: Plain text
7346 #: build/C/man3/scalbln.3:41
7347 msgid "B<double scalbn(double >I<x>B<, int >I<exp>B<);>"
7348 msgstr ""
7349
7350 #. type: Plain text
7351 #: build/C/man3/scalbln.3:43
7352 msgid "B<float scalbnf(float >I<x>B<, int >I<exp>B<);>"
7353 msgstr ""
7354
7355 #. type: Plain text
7356 #: build/C/man3/scalbln.3:45
7357 msgid "B<long double scalbnl(long double >I<x>B<, int >I<exp>B<);>"
7358 msgstr ""
7359
7360 #. type: Plain text
7361 #: build/C/man3/scalbln.3:57
7362 msgid "B<scalbln>(), B<scalblnf>(), B<scalblnl>():"
7363 msgstr ""
7364
7365 #. type: Plain text
7366 #: build/C/man3/scalbln.3:68
7367 msgid "B<scalbn>(), B<scalbnf>(), B<scalbnl>():"
7368 msgstr ""
7369
7370 #. type: Plain text
7371 #: build/C/man3/scalbln.3:171
7372 msgid ""
7373 "The B<scalbn>(), B<scalbnf>(), B<scalbnl>(), B<scalbln>(), B<scalblnf>(), "
7374 "and B<scalblnl>()  functions are thread-safe."
7375 msgstr ""
7376
7377 #. type: Plain text
7378 #: build/C/man3/scalbln.3:182
7379 msgid ""
7380 "These functions differ from the obsolete functions described in B<scalb>(3)  "
7381 "in the type of their second argument.  The functions described on this page "
7382 "have a second argument of an integral type, while those in B<scalb>(3)  have "
7383 "a second argument of type I<double>."
7384 msgstr ""
7385
7386 #. type: Plain text
7387 #: build/C/man3/scalbln.3:189
7388 msgid ""
7389 "If B<FLT_RADIX> equals 2 (which is usual), then B<scalbn>()  is equivalent "
7390 "to B<ldexp>(3)."
7391 msgstr ""
7392
7393 #. type: Plain text
7394 #: build/C/man3/scalbln.3:192
7395 msgid "B<ldexp>(3), B<scalb>(3)"
7396 msgstr ""
7397
7398 #. type: TH
7399 #: build/C/man3/signbit.3:11
7400 #, no-wrap
7401 msgid "SIGNBIT"
7402 msgstr ""
7403
7404 #. type: TH
7405 #: build/C/man3/signbit.3:11
7406 #, no-wrap
7407 msgid "2013-07-04"
7408 msgstr ""
7409
7410 #. type: Plain text
7411 #: build/C/man3/signbit.3:14
7412 msgid "signbit - test sign of a real floating-point number"
7413 msgstr ""
7414
7415 #. type: Plain text
7416 #: build/C/man3/signbit.3:18
7417 msgid "B<int signbit(>I<x>B<);>"
7418 msgstr ""
7419
7420 #. type: Plain text
7421 #: build/C/man3/signbit.3:28
7422 msgid "B<signbit>():"
7423 msgstr ""
7424
7425 #. type: Plain text
7426 #: build/C/man3/signbit.3:42
7427 msgid ""
7428 "B<signbit>()  is a generic macro which can work on all real floating-point "
7429 "types.  It returns a nonzero value if the value of I<x> has its sign bit "
7430 "set."
7431 msgstr ""
7432
7433 #. type: Plain text
7434 #: build/C/man3/signbit.3:51
7435 msgid ""
7436 "This is not the same as I<x E<lt> 0.0>, because IEEE 754 floating point "
7437 "allows zero to be signed.  The comparison I<-0.0 E<lt> 0.0> is false, but "
7438 "I<signbit(-0.0)> will return a nonzero value."
7439 msgstr ""
7440
7441 #. type: Plain text
7442 #: build/C/man3/signbit.3:53
7443 msgid "NaNs and infinities have a sign bit."
7444 msgstr ""
7445
7446 #. type: Plain text
7447 #: build/C/man3/signbit.3:59
7448 msgid ""
7449 "The B<signbit>()  macro returns nonzero if the sign of I<x> is negative; "
7450 "otherwise it returns zero."
7451 msgstr ""
7452
7453 #. type: Plain text
7454 #: build/C/man3/signbit.3:66
7455 msgid "The B<signbit>()  macro is thread-safe."
7456 msgstr ""
7457
7458 #. type: Plain text
7459 #: build/C/man3/signbit.3:72
7460 msgid "B<copysign>(3)"
7461 msgstr ""
7462
7463 #. type: TH
7464 #: build/C/man3/significand.3:9
7465 #, no-wrap
7466 msgid "SIGNIFICAND"
7467 msgstr ""
7468
7469 #. type: TH
7470 #: build/C/man3/significand.3:9
7471 #, no-wrap
7472 msgid "2009-02-04"
7473 msgstr ""
7474
7475 #. type: Plain text
7476 #: build/C/man3/significand.3:13
7477 msgid ""
7478 "significand, significandf, significandl - get mantissa of floating-point "
7479 "number"
7480 msgstr ""
7481
7482 #. type: Plain text
7483 #: build/C/man3/significand.3:17
7484 msgid "B<double significand(double >I<x>B<);>"
7485 msgstr ""
7486
7487 #. type: Plain text
7488 #: build/C/man3/significand.3:19
7489 msgid "B<float significandf(float >I<x>B<);>"
7490 msgstr ""
7491
7492 #. type: Plain text
7493 #: build/C/man3/significand.3:21
7494 msgid "B<long double significandl(long double >I<x>B<);>"
7495 msgstr ""
7496
7497 #. type: Plain text
7498 #: build/C/man3/significand.3:33
7499 msgid "B<significand>(), B<significandf>(), B<significandl>():"
7500 msgstr ""
7501
7502 #. type: Plain text
7503 #: build/C/man3/significand.3:44
7504 msgid ""
7505 "The B<significand>()  function returns the mantissa of I<x> scaled to the "
7506 "range [1,2).  It is equivalent to"
7507 msgstr ""
7508
7509 #. type: Plain text
7510 #: build/C/man3/significand.3:47
7511 msgid "scalb(x, (double) -ilogb(x))"
7512 msgstr ""
7513
7514 #. type: Plain text
7515 #: build/C/man3/significand.3:51
7516 msgid ""
7517 "This function exists mainly for use in certain standardized tests for IEEE "
7518 "754 conformance."
7519 msgstr ""
7520
7521 #.  .SH HISTORY
7522 #.  This function came from BSD.
7523 #. type: Plain text
7524 #: build/C/man3/significand.3:57
7525 msgid ""
7526 "These functions are nonstandard; the I<double> version is available on a "
7527 "number of other systems."
7528 msgstr ""
7529
7530 #. type: Plain text
7531 #: build/C/man3/significand.3:60
7532 msgid "B<ilogb>(3), B<scalb>(3)"
7533 msgstr ""
7534
7535 #. type: TH
7536 #: build/C/man3/sin.3:35
7537 #, no-wrap
7538 msgid "SIN"
7539 msgstr ""
7540
7541 #. type: Plain text
7542 #: build/C/man3/sin.3:38
7543 msgid "sin, sinf, sinl - sine function"
7544 msgstr ""
7545
7546 #. type: Plain text
7547 #: build/C/man3/sin.3:43
7548 #, no-wrap
7549 msgid "B<double sin(double >I<x>B<);>\n"
7550 msgstr ""
7551
7552 #. type: Plain text
7553 #: build/C/man3/sin.3:45
7554 #, no-wrap
7555 msgid "B<float sinf(float >I<x>B<);>\n"
7556 msgstr ""
7557
7558 #. type: Plain text
7559 #: build/C/man3/sin.3:47
7560 #, no-wrap
7561 msgid "B<long double sinl(long double >I<x>B<);>\n"
7562 msgstr ""
7563
7564 #. type: Plain text
7565 #: build/C/man3/sin.3:59
7566 msgid "B<sinf>(), B<sinl>():"
7567 msgstr ""
7568
7569 #. type: Plain text
7570 #: build/C/man3/sin.3:76
7571 msgid ""
7572 "The B<sin>()  function returns the sine of I<x>, where I<x> is given in "
7573 "radians."
7574 msgstr ""
7575
7576 #. type: Plain text
7577 #: build/C/man3/sin.3:79
7578 msgid "On success, these functions return the sine of I<x>."
7579 msgstr ""
7580
7581 #. type: Plain text
7582 #: build/C/man3/sin.3:130
7583 msgid ""
7584 "B<acos>(3), B<asin>(3), B<atan>(3), B<atan2>(3), B<cos>(3), B<csin>(3), "
7585 "B<sincos>(3), B<tan>(3)"
7586 msgstr ""
7587
7588 #. type: TH
7589 #: build/C/man3/sincos.3:9
7590 #, no-wrap
7591 msgid "SINCOS"
7592 msgstr ""
7593
7594 #. type: Plain text
7595 #: build/C/man3/sincos.3:12
7596 msgid "sincos, sincosf, sincosl - calculate sin and cos simultaneously"
7597 msgstr ""
7598
7599 #. type: Plain text
7600 #: build/C/man3/sincos.3:18
7601 #, no-wrap
7602 msgid "B<void sincos(double >I<x>B<, double *>I<sin>B<, double *>I<cos>B<);>\n"
7603 msgstr ""
7604
7605 #. type: Plain text
7606 #: build/C/man3/sincos.3:20
7607 #, no-wrap
7608 msgid "B<void sincosf(float >I<x>B<, float *>I<sin>B<, float *>I<cos>B<);>\n"
7609 msgstr ""
7610
7611 #. type: Plain text
7612 #: build/C/man3/sincos.3:22
7613 #, no-wrap
7614 msgid ""
7615 "B<void sincosl(long double >I<x>B<, long double *>I<sin>B<, long double "
7616 "*>I<cos>B<);>\n"
7617 msgstr ""
7618
7619 #. type: Plain text
7620 #: build/C/man3/sincos.3:32
7621 msgid ""
7622 "Several applications need sine and cosine of the same angle I<x>.  This "
7623 "function computes both at the same time, and stores the results in I<*sin> "
7624 "and I<*cos>."
7625 msgstr ""
7626
7627 #. type: Plain text
7628 #: build/C/man3/sincos.3:40
7629 msgid "If I<x> is a NaN, a NaN is returned in I<*sin> and I<*cos>."
7630 msgstr ""
7631
7632 #. type: Plain text
7633 #: build/C/man3/sincos.3:49
7634 msgid ""
7635 "If I<x> is positive infinity or negative infinity, a domain error occurs, "
7636 "and a NaN is returned in I<*sin> and I<*cos>."
7637 msgstr ""
7638
7639 #. type: Plain text
7640 #: build/C/man3/sincos.3:52
7641 msgid "These functions return I<void>."
7642 msgstr ""
7643
7644 #. type: Plain text
7645 #: build/C/man3/sincos.3:77
7646 msgid "This function is a GNU extension."
7647 msgstr ""
7648
7649 #. type: Plain text
7650 #: build/C/man3/sincos.3:81
7651 msgid "B<cos>(3), B<sin>(3), B<tan>(3)"
7652 msgstr ""
7653
7654 #. type: TH
7655 #: build/C/man3/sinh.3:36
7656 #, no-wrap
7657 msgid "SINH"
7658 msgstr ""
7659
7660 #. type: Plain text
7661 #: build/C/man3/sinh.3:39
7662 msgid "sinh, sinhf, sinhl - hyperbolic sine function"
7663 msgstr ""
7664
7665 #. type: Plain text
7666 #: build/C/man3/sinh.3:44
7667 #, no-wrap
7668 msgid "B<double sinh(double >I<x>B<);>\n"
7669 msgstr ""
7670
7671 #. type: Plain text
7672 #: build/C/man3/sinh.3:46
7673 #, no-wrap
7674 msgid "B<float sinhf(float >I<x>B<);>\n"
7675 msgstr ""
7676
7677 #. type: Plain text
7678 #: build/C/man3/sinh.3:48
7679 #, no-wrap
7680 msgid "B<long double sinhl(long double >I<x>B<);>\n"
7681 msgstr ""
7682
7683 #. type: Plain text
7684 #: build/C/man3/sinh.3:60
7685 msgid "B<sinhf>(), B<sinhl>():"
7686 msgstr ""
7687
7688 #. type: Plain text
7689 #: build/C/man3/sinh.3:75
7690 msgid ""
7691 "The B<sinh>()  function returns the hyperbolic sine of I<x>, which is "
7692 "defined mathematically as:"
7693 msgstr ""
7694
7695 #. type: Plain text
7696 #: build/C/man3/sinh.3:78
7697 #, no-wrap
7698 msgid "    sinh(x) = (exp(x) - exp(-x)) / 2\n"
7699 msgstr ""
7700
7701 #. type: Plain text
7702 #: build/C/man3/sinh.3:82
7703 msgid "On success, these functions return the hyperbolic sine of I<x>."
7704 msgstr ""
7705
7706 #
7707 #.  POSIX.1-2001 documents an optional range error (underflow)
7708 #.  for subnormal x;
7709 #.  glibc 2.8 does not do this.
7710 #. type: Plain text
7711 #: build/C/man3/sinh.3:109
7712 msgid ""
7713 "If the result overflows, a range error occurs, and the functions return "
7714 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the same sign "
7715 "as I<x>."
7716 msgstr ""
7717
7718 #. type: Plain text
7719 #: build/C/man3/sinh.3:137
7720 msgid "B<acosh>(3), B<asinh>(3), B<atanh>(3), B<cosh>(3), B<csinh>(3), B<tanh>(3)"
7721 msgstr ""
7722
7723 #. type: TH
7724 #: build/C/man3/sqrt.3:34
7725 #, no-wrap
7726 msgid "SQRT"
7727 msgstr ""
7728
7729 #. type: Plain text
7730 #: build/C/man3/sqrt.3:37
7731 msgid "sqrt, sqrtf, sqrtl - square root function"
7732 msgstr ""
7733
7734 #. type: Plain text
7735 #: build/C/man3/sqrt.3:42
7736 #, no-wrap
7737 msgid "B<double sqrt(double >I<x>B<);>\n"
7738 msgstr ""
7739
7740 #. type: Plain text
7741 #: build/C/man3/sqrt.3:44
7742 #, no-wrap
7743 msgid "B<float sqrtf(float >I<x>B<);>\n"
7744 msgstr ""
7745
7746 #. type: Plain text
7747 #: build/C/man3/sqrt.3:46
7748 #, no-wrap
7749 msgid "B<long double sqrtl(long double >I<x>B<);>\n"
7750 msgstr ""
7751
7752 #. type: Plain text
7753 #: build/C/man3/sqrt.3:58
7754 msgid "B<sqrtf>(), B<sqrtl>():"
7755 msgstr ""
7756
7757 #. type: Plain text
7758 #: build/C/man3/sqrt.3:71
7759 msgid "The B<sqrt>()  function returns the nonnegative square root of I<x>."
7760 msgstr ""
7761
7762 #. type: Plain text
7763 #: build/C/man3/sqrt.3:74
7764 msgid "On success, these functions return the square root of I<x>."
7765 msgstr ""
7766
7767 #. type: Plain text
7768 #: build/C/man3/sqrt.3:92
7769 msgid "If I<x> is less than -0, a domain error occurs, and a NaN is returned."
7770 msgstr ""
7771
7772 #. type: TP
7773 #: build/C/man3/sqrt.3:99
7774 #, no-wrap
7775 msgid "Domain error: I<x> less than -0"
7776 msgstr ""
7777
7778 #. type: Plain text
7779 #: build/C/man3/sqrt.3:117
7780 msgid "B<cbrt>(3), B<csqrt>(3), B<hypot>(3)"
7781 msgstr ""
7782
7783 #. type: TH
7784 #: build/C/man3/tan.3:35
7785 #, no-wrap
7786 msgid "TAN"
7787 msgstr ""
7788
7789 #. type: Plain text
7790 #: build/C/man3/tan.3:38
7791 msgid "tan, tanf, tanl - tangent function"
7792 msgstr ""
7793
7794 #. type: Plain text
7795 #: build/C/man3/tan.3:43
7796 #, no-wrap
7797 msgid "B<double tan(double >I<x>B<);>\n"
7798 msgstr ""
7799
7800 #. type: Plain text
7801 #: build/C/man3/tan.3:45
7802 #, no-wrap
7803 msgid "B<float tanf(float >I<x>B<);>\n"
7804 msgstr ""
7805
7806 #. type: Plain text
7807 #: build/C/man3/tan.3:47
7808 #, no-wrap
7809 msgid "B<long double tanl(long double >I<x>B<);>\n"
7810 msgstr ""
7811
7812 #. type: Plain text
7813 #: build/C/man3/tan.3:59
7814 msgid "B<tanf>(), B<tanl>():"
7815 msgstr ""
7816
7817 #. type: Plain text
7818 #: build/C/man3/tan.3:76
7819 msgid ""
7820 "The B<tan>()  function returns the tangent of I<x>, where I<x> is given in "
7821 "radians."
7822 msgstr ""
7823
7824 #. type: Plain text
7825 #: build/C/man3/tan.3:79
7826 msgid "On success, these functions return the tangent of I<x>."
7827 msgstr ""
7828
7829 #.  I think overflow can't occur, because the closest floating-point
7830 #.  representation of pi/2 is still not close enough to pi/2 to
7831 #.  produce a large enough value to overflow.
7832 #.  Testing certainly seems to bear this out.  -- mtk, Jul 08
7833 #
7834 #.  POSIX.1 allows an optional underflow error;
7835 #.  glibc 2.8 doesn't do this
7836 #.  POSIX.1 an optional range error for subnormal x;
7837 #.  glibc 2.8 doesn't do this
7838 #. type: Plain text
7839 #: build/C/man3/tan.3:107
7840 msgid ""
7841 "If the correct result would overflow, a range error occurs, and the "
7842 "functions return B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, "
7843 "with the mathematically correct sign."
7844 msgstr ""
7845
7846 #. type: Plain text
7847 #: build/C/man3/tan.3:154
7848 msgid ""
7849 "B<acos>(3), B<asin>(3), B<atan>(3), B<atan2>(3), B<cos>(3), B<ctan>(3), "
7850 "B<sin>(3)"
7851 msgstr ""
7852
7853 #. type: TH
7854 #: build/C/man3/tanh.3:35
7855 #, no-wrap
7856 msgid "TANH"
7857 msgstr ""
7858
7859 #. type: Plain text
7860 #: build/C/man3/tanh.3:38
7861 msgid "tanh, tanhf, tanhl - hyperbolic tangent function"
7862 msgstr ""
7863
7864 #. type: Plain text
7865 #: build/C/man3/tanh.3:43
7866 #, no-wrap
7867 msgid "B<double tanh(double >I<x>B<);>\n"
7868 msgstr ""
7869
7870 #. type: Plain text
7871 #: build/C/man3/tanh.3:45
7872 #, no-wrap
7873 msgid "B<float tanhf(float >I<x>B<);>\n"
7874 msgstr ""
7875
7876 #. type: Plain text
7877 #: build/C/man3/tanh.3:47
7878 #, no-wrap
7879 msgid "B<long double tanhl(long double >I<x>B<);>\n"
7880 msgstr ""
7881
7882 #. type: Plain text
7883 #: build/C/man3/tanh.3:59
7884 msgid "B<tanhf>(), B<tanhl>():"
7885 msgstr ""
7886
7887 #. type: Plain text
7888 #: build/C/man3/tanh.3:74
7889 msgid ""
7890 "The B<tanh>()  function returns the hyperbolic tangent of I<x>, which is "
7891 "defined mathematically as:"
7892 msgstr ""
7893
7894 #. type: Plain text
7895 #: build/C/man3/tanh.3:77
7896 #, no-wrap
7897 msgid "    tanh(x) = sinh(x) / cosh(x)\n"
7898 msgstr ""
7899
7900 #. type: Plain text
7901 #: build/C/man3/tanh.3:81
7902 msgid "On success, these functions return the hyperbolic tangent of I<x>."
7903 msgstr ""
7904
7905 #. type: Plain text
7906 #: build/C/man3/tanh.3:113
7907 msgid "B<acosh>(3), B<asinh>(3), B<atanh>(3), B<cosh>(3), B<ctanh>(3), B<sinh>(3)"
7908 msgstr ""
7909
7910 #. type: TH
7911 #: build/C/man3/tgamma.3:13
7912 #, no-wrap
7913 msgid "TGAMMA"
7914 msgstr ""
7915
7916 #. type: Plain text
7917 #: build/C/man3/tgamma.3:16
7918 msgid "tgamma, tgammaf, tgammal - true gamma function"
7919 msgstr ""
7920
7921 #. type: Plain text
7922 #: build/C/man3/tgamma.3:20
7923 msgid "B<double tgamma(double >I<x>B<);>"
7924 msgstr ""
7925
7926 #. type: Plain text
7927 #: build/C/man3/tgamma.3:22
7928 msgid "B<float tgammaf(float >I<x>B<);>"
7929 msgstr ""
7930
7931 #. type: Plain text
7932 #: build/C/man3/tgamma.3:24
7933 msgid "B<long double tgammal(long double >I<x>B<);>"
7934 msgstr ""
7935
7936 #. type: Plain text
7937 #: build/C/man3/tgamma.3:36
7938 msgid "B<tgamma>(), B<tgammaf>(), B<tgammal>():"
7939 msgstr ""
7940
7941 #. type: Plain text
7942 #: build/C/man3/tgamma.3:46
7943 msgid "The Gamma function is defined by"
7944 msgstr ""
7945
7946 #. type: Plain text
7947 #: build/C/man3/tgamma.3:48
7948 #, no-wrap
7949 msgid "    Gamma(x) = integral from 0 to infinity of t^(x-1) e^-t dt\n"
7950 msgstr ""
7951
7952 #. type: Plain text
7953 #: build/C/man3/tgamma.3:53
7954 msgid ""
7955 "It is defined for every real number except for nonpositive integers.  For "
7956 "nonnegative integral I<m> one has"
7957 msgstr ""
7958
7959 #. type: Plain text
7960 #: build/C/man3/tgamma.3:55
7961 #, no-wrap
7962 msgid "    Gamma(m+1) = m!\n"
7963 msgstr ""
7964
7965 #. type: Plain text
7966 #: build/C/man3/tgamma.3:58
7967 msgid "and, more generally, for all I<x>:"
7968 msgstr ""
7969
7970 #. type: Plain text
7971 #: build/C/man3/tgamma.3:60
7972 #, no-wrap
7973 msgid "    Gamma(x+1) = x * Gamma(x)\n"
7974 msgstr ""
7975
7976 #. type: Plain text
7977 #: build/C/man3/tgamma.3:64
7978 msgid ""
7979 "Furthermore, the following is valid for all values of I<x> outside the "
7980 "poles:"
7981 msgstr ""
7982
7983 #. type: Plain text
7984 #: build/C/man3/tgamma.3:66
7985 #, no-wrap
7986 msgid "    Gamma(x) * Gamma(1 - x) = PI / sin(PI * x)\n"
7987 msgstr ""
7988
7989 #. type: Plain text
7990 #: build/C/man3/tgamma.3:69
7991 msgid "On success, these functions return Gamma(x)."
7992 msgstr ""
7993
7994 #. type: Plain text
7995 #: build/C/man3/tgamma.3:83
7996 msgid ""
7997 "If I<x> is a negative integer, or is negative infinity, a domain error "
7998 "occurs, and a NaN is returned."
7999 msgstr ""
8000
8001 #. type: Plain text
8002 #: build/C/man3/tgamma.3:96
8003 msgid ""
8004 "If the result underflows, a range error occurs, and the functions return 0, "
8005 "with the correct mathematical sign."
8006 msgstr ""
8007
8008 #. type: Plain text
8009 #: build/C/man3/tgamma.3:107
8010 msgid ""
8011 "If I<x> is -0 or +0, a pole error occurs, and the functions return "
8012 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the same sign "
8013 "as the 0."
8014 msgstr ""
8015
8016 #. type: TP
8017 #: build/C/man3/tgamma.3:114
8018 #, no-wrap
8019 msgid "Domain error: I<x> is a negative integer, or negative infinity"
8020 msgstr ""
8021
8022 #.  FIXME . errno is not set to EDOM for x == -inf
8023 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
8024 #. type: Plain text
8025 #: build/C/man3/tgamma.3:124
8026 msgid ""
8027 "I<errno> is set to B<EDOM>.  An invalid floating-point exception "
8028 "(B<FE_INVALID>)  is raised (but see BUGS)."
8029 msgstr ""
8030
8031 #. type: TP
8032 #: build/C/man3/tgamma.3:124
8033 #, no-wrap
8034 msgid "Pole error: I<x> is +0 or -0"
8035 msgstr ""
8036
8037 #. type: Plain text
8038 #: build/C/man3/tgamma.3:143
8039 msgid ""
8040 "glibc also gives the following error which is not specified in C99 or "
8041 "POSIX.1-2001."
8042 msgstr ""
8043
8044 #.  FIXME . Is it intentional that errno is not set:
8045 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810
8046 #
8047 #.  glibc (as at 2.8) also supports and an inexact
8048 #.  exception for various cases.
8049 #. type: Plain text
8050 #: build/C/man3/tgamma.3:160
8051 msgid "I<errno> is not set for this case."
8052 msgstr ""
8053
8054 #. type: Plain text
8055 #: build/C/man3/tgamma.3:171
8056 msgid ""
8057 "This function had to be called \"true gamma function\" since there is "
8058 "already a function B<gamma>(3)  that returns something else (see B<gamma>(3)  "
8059 "for details)."
8060 msgstr ""
8061
8062 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
8063 #. type: Plain text
8064 #: build/C/man3/tgamma.3:179
8065 msgid ""
8066 "If I<x> is negative infinity, I<errno> is not set (it should be set to "
8067 "B<EDOM>)."
8068 msgstr ""
8069
8070 #. type: Plain text
8071 #: build/C/man3/tgamma.3:188
8072 msgid ""
8073 "In glibc versions 2.3.3 and earlier, an argument of +0 or -0 incorrectly "
8074 "produced a domain error (I<errno> set to B<EDOM> and an B<FE_INVALID> "
8075 "exception raised), rather than a pole error."
8076 msgstr ""
8077
8078 #. type: Plain text
8079 #: build/C/man3/tgamma.3:191
8080 msgid "B<gamma>(3), B<lgamma>(3)"
8081 msgstr ""
8082
8083 #. type: TH
8084 #: build/C/man3/trunc.3:25
8085 #, no-wrap
8086 msgid "TRUNC"
8087 msgstr ""
8088
8089 #. type: Plain text
8090 #: build/C/man3/trunc.3:28
8091 msgid "trunc, truncf, truncl - round to integer, toward zero"
8092 msgstr ""
8093
8094 #. type: Plain text
8095 #: build/C/man3/trunc.3:33
8096 #, no-wrap
8097 msgid "B<double trunc(double >I<x>B<);>\n"
8098 msgstr ""
8099
8100 #. type: Plain text
8101 #: build/C/man3/trunc.3:35
8102 #, no-wrap
8103 msgid "B<float truncf(float >I<x>B<);>\n"
8104 msgstr ""
8105
8106 #. type: Plain text
8107 #: build/C/man3/trunc.3:37
8108 #, no-wrap
8109 msgid "B<long double truncl(long double >I<x>B<);>\n"
8110 msgstr ""
8111
8112 #. type: Plain text
8113 #: build/C/man3/trunc.3:50
8114 msgid "B<trunc>(), B<truncf>(), B<truncl>():"
8115 msgstr ""
8116
8117 #. type: Plain text
8118 #: build/C/man3/trunc.3:63
8119 msgid ""
8120 "These functions round I<x> to the nearest integer not larger in absolute "
8121 "value."
8122 msgstr ""
8123
8124 #. type: Plain text
8125 #: build/C/man3/trunc.3:71
8126 msgid "If I<x> is integral, infinite, or NaN, I<x> itself is returned."
8127 msgstr ""
8128
8129 #. type: Plain text
8130 #: build/C/man3/trunc.3:83
8131 msgid "The B<trunc>(), B<truncf>(), and B<truncl>()  functions are thread-safe."
8132 msgstr ""
8133
8134 #. type: TH
8135 #: build/C/man3/y0.3:36
8136 #, no-wrap
8137 msgid "Y0"
8138 msgstr ""
8139
8140 #. type: TH
8141 #: build/C/man3/y0.3:36
8142 #, no-wrap
8143 msgid "2008-08-10"
8144 msgstr ""
8145
8146 #. type: Plain text
8147 #: build/C/man3/y0.3:40
8148 msgid ""
8149 "y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl - Bessel functions of the second "
8150 "kind"
8151 msgstr ""
8152
8153 #. type: Plain text
8154 #: build/C/man3/y0.3:45
8155 #, no-wrap
8156 msgid "B<double y0(double >I<x>B<);>\n"
8157 msgstr ""
8158
8159 #. type: Plain text
8160 #: build/C/man3/y0.3:47
8161 #, no-wrap
8162 msgid "B<double y1(double >I<x>B<);>\n"
8163 msgstr ""
8164
8165 #. type: Plain text
8166 #: build/C/man3/y0.3:49
8167 #, no-wrap
8168 msgid "B<double yn(int >I<n>B<, double >I<x>B<);>\n"
8169 msgstr ""
8170
8171 #. type: Plain text
8172 #: build/C/man3/y0.3:51
8173 #, no-wrap
8174 msgid "B<float y0f(float >I<x>B<);>\n"
8175 msgstr ""
8176
8177 #. type: Plain text
8178 #: build/C/man3/y0.3:53
8179 #, no-wrap
8180 msgid "B<float y1f(float >I<x>B<);>\n"
8181 msgstr ""
8182
8183 #. type: Plain text
8184 #: build/C/man3/y0.3:55
8185 #, no-wrap
8186 msgid "B<float ynf(int >I<n>B<, float >I<x>B<);>\n"
8187 msgstr ""
8188
8189 #. type: Plain text
8190 #: build/C/man3/y0.3:57
8191 #, no-wrap
8192 msgid "B<long double y0l(long double >I<x>B<);>\n"
8193 msgstr ""
8194
8195 #. type: Plain text
8196 #: build/C/man3/y0.3:59
8197 #, no-wrap
8198 msgid "B<long double y1l(long double >I<x>B<);>\n"
8199 msgstr ""
8200
8201 #. type: Plain text
8202 #: build/C/man3/y0.3:61
8203 #, no-wrap
8204 msgid "B<long double ynl(int >I<n>B<, long double >I<x>B<);>\n"
8205 msgstr ""
8206
8207 #. type: Plain text
8208 #: build/C/man3/y0.3:74
8209 msgid "B<y0>(), B<y1>(), B<yn>():"
8210 msgstr ""
8211
8212 #. type: Plain text
8213 #: build/C/man3/y0.3:84
8214 msgid "B<y0f>(), B<y0l>(), B<y1f>(), B<y1l>(), B<ynf>(), B<ynl>():"
8215 msgstr ""
8216
8217 #. type: Plain text
8218 #: build/C/man3/y0.3:105
8219 msgid ""
8220 "The B<y0>()  and B<y1>()  functions return Bessel functions of I<x> of the "
8221 "second kind of orders 0 and 1, respectively.  The B<yn>()  function returns "
8222 "the Bessel function of I<x> of the second kind of order I<n>."
8223 msgstr ""
8224
8225 #. type: Plain text
8226 #: build/C/man3/y0.3:109
8227 msgid "The value of I<x> must be positive."
8228 msgstr ""
8229
8230 #. type: Plain text
8231 #: build/C/man3/y0.3:119
8232 msgid ""
8233 "The B<y0f>()  etc. and B<y0l>()  etc. functions are versions that take and "
8234 "return I<float> and I<long double> values, respectively."
8235 msgstr ""
8236
8237 #. type: Plain text
8238 #: build/C/man3/y0.3:123
8239 msgid ""
8240 "On success, these functions return the appropriate Bessel value of the "
8241 "second kind for I<x>."
8242 msgstr ""
8243
8244 #. type: Plain text
8245 #: build/C/man3/y0.3:139
8246 msgid ""
8247 "If I<x> is negative, a domain error occurs, and the functions return "
8248 "-B<HUGE_VAL>, -B<HUGE_VALF>, or -B<HUGE_VALL>, respectively.  (POSIX.1-2001 "
8249 "also allows a NaN return for this case.)"
8250 msgstr ""
8251
8252 #. type: Plain text
8253 #: build/C/man3/y0.3:150
8254 msgid ""
8255 "If I<x> is 0.0, a pole error occurs, and the functions return -B<HUGE_VAL>, "
8256 "-B<HUGE_VALF>, or -B<HUGE_VALL>, respectively."
8257 msgstr ""
8258
8259 #. type: Plain text
8260 #: build/C/man3/y0.3:154
8261 msgid "If the result underflows, a range error occurs, and the functions return 0.0"
8262 msgstr ""
8263
8264 #. type: Plain text
8265 #: build/C/man3/y0.3:164
8266 msgid ""
8267 "If the result overflows, a range error occurs, and the functions return "
8268 "-B<HUGE_VAL>, -B<HUGE_VALF>, or -B<HUGE_VALL>, respectively.  (POSIX.1-2001 "
8269 "also allows a 0.0 return for this case.)"
8270 msgstr ""
8271
8272 #. type: TP
8273 #: build/C/man3/y0.3:179
8274 #, no-wrap
8275 msgid "Pole error: I<x> is 0.0"
8276 msgstr ""
8277
8278 #.  Before POSIX.1-2001 TC2, this was (inconsistently) specified
8279 #.  as a range error.
8280 #.  FIXME . y0(0.0) gives EDOM
8281 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808
8282 #. type: Plain text
8283 #: build/C/man3/y0.3:194
8284 msgid ""
8285 "I<errno> is set to B<ERANGE> (but see BUGS).  No B<FE_DIVBYZERO> exception "
8286 "is returned by B<fetestexcept>(3)  for this case."
8287 msgstr ""
8288
8289 #.  e.g., y0(1e33) on glibc 2.8/x86-32
8290 #.  An underflow floating-point exception
8291 #.  .RB ( FE_UNDERFLOW )
8292 #.  is raised.
8293 #.  FIXME . Is it intentional that these functions do not use FE_*?
8294 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806
8295 #. type: Plain text
8296 #: build/C/man3/y0.3:210
8297 msgid ""
8298 "I<errno> is set to B<ERANGE>.  No B<FE_UNDERFLOW> exception is returned by "
8299 "B<fetestexcept>(3)  for this case."
8300 msgstr ""
8301
8302 #.  e.g., yn(10, 1e-40) on glibc 2.8/x86-32
8303 #.  .I errno
8304 #.  is set to
8305 #.  .BR ERANGE .
8306 #.  FIXME . Is it intentional that errno is not set?
8307 #.  Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808
8308 #. type: Plain text
8309 #: build/C/man3/y0.3:223
8310 msgid ""
8311 "I<errno> is not set for this case.  An overflow floating-point exception "
8312 "(B<FE_OVERFLOW>)  is raised."
8313 msgstr ""
8314
8315 #.  FIXME .
8316 #.  Bug raised: http://sourceware.org/bugzilla/show_bug.cgi?id=6807
8317 #. type: Plain text
8318 #: build/C/man3/y0.3:239
8319 msgid ""
8320 "On a pole error, these functions set I<errno> to B<EDOM>, instead of "
8321 "B<ERANGE> as POSIX.1-2004 requires."
8322 msgstr ""
8323
8324 #.  FIXME . Actually, 2.3.2 is the earliest test result I have; so yet
8325 #.  to confirm if this error occurs only in 2.3.2.
8326 #. type: Plain text
8327 #: build/C/man3/y0.3:246
8328 msgid ""
8329 "In glibc version 2.3.2 and earlier, these functions do not raise an invalid "
8330 "floating-point exception (B<FE_INVALID>)  when a domain error occurs."
8331 msgstr ""
8332
8333 #. type: Plain text
8334 #: build/C/man3/y0.3:248
8335 msgid "B<j0>(3)"
8336 msgstr ""