OSDN Git Service

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