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.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2015-01-04 23:49+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"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: build/C/man3/INFINITY.3:25
26 #: build/C/man3/INFINITY.3:25
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
34 msgid "Linux Programmer's Manual"
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
44 #: build/C/man3/INFINITY.3:28
45 msgid "INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL - floating-point constants"
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
55 #: build/C/man3/INFINITY.3:31
57 msgid "B<#define _ISOC99_SOURCE> /* See feature_test_macros(7) */\n"
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
63 msgid "B<#include E<lt>math.hE<gt>>\n"
67 #: build/C/man3/INFINITY.3:35
73 #: build/C/man3/INFINITY.3:37
79 #: build/C/man3/INFINITY.3:39
85 #: build/C/man3/INFINITY.3:41
87 msgid "B<HUGE_VALF>\n"
91 #: build/C/man3/INFINITY.3:43
93 msgid "B<HUGE_VALL>\n"
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
103 #: build/C/man3/INFINITY.3:50
105 "The macro B<INFINITY> expands to a I<float> constant representing positive "
110 #: build/C/man3/INFINITY.3:65
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."
119 #: build/C/man3/INFINITY.3:77
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 positive infinity."
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:113 build/C/man3/atan.3:104 build/C/man3/atan2.3:166 build/C/man3/atanh.3:139 build/C/man3/cbrt.3:98 build/C/man3/ceil.3:89 build/C/man3/copysign.3:103 build/C/man3/cos.3:112 build/C/man3/cosh.3:119 build/C/man3/div.3:100 build/C/man3/erf.3:134 build/C/man3/erfc.3:130 build/C/man3/exp.3:128 build/C/man3/exp10.3:75 build/C/man3/exp2.3:91 build/C/man3/expm1.3:144 build/C/man3/fabs.3:93 build/C/man3/fdim.3:89 build/C/man3/fenv.3:284 build/C/man3/floor.3:88 build/C/man3/fma.3:164 build/C/man3/fmax.3:66 build/C/man3/fmin.3:66 build/C/man3/fmod.3:146 build/C/man3/fpclassify.3:128 build/C/man3/frexp.3:116 build/C/man3/gamma.3:65 build/C/man3/hypot.3:158 build/C/man3/ilogb.3:144 build/C/man3/infnan.3:87 build/C/man3/isgreater.3:136 build/C/man3/j0.3:157 build/C/man3/ldexp.3:137 build/C/man3/lgamma.3:158 build/C/man3/log.3:128 build/C/man3/log10.3:89 build/C/man3/log1p.3:150 build/C/man3/log2.3:91 build/C/man3/logb.3:151 build/C/man3/lrint.3:121 build/C/man3/lround.3:124 build/C/man3/modf.3:103 build/C/man3/nan.3:75 build/C/man3/nextafter.3:190 build/C/man3/pow.3:316 build/C/man3/pow10.3:49 build/C/man3/remainder.3:180 build/C/man3/remquo.3:132 build/C/man3/rint.3:133 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:116 build/C/man3/sincos.3:84 build/C/man3/sinh.3:124 build/C/man3/sqrt.3:107 build/C/man3/tan.3:141 build/C/man3/tanh.3:108 build/C/man3/tgamma.3:160 build/C/man3/trunc.3:83 build/C/man3/y0.3:230
129 msgid "CONFORMING TO"
133 #: build/C/man3/INFINITY.3:79
138 #: build/C/man3/INFINITY.3:79
144 #: build/C/man3/INFINITY.3:101
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."
154 #: build/C/man3/INFINITY.3:101 build/C/man3/abs.3:133 build/C/man3/acos.3:119 build/C/man3/acosh.3:126 build/C/man3/asin.3:117 build/C/man3/asinh.3:119 build/C/man3/atan.3:110 build/C/man3/atan2.3:172 build/C/man3/atanh.3:156 build/C/man3/cbrt.3:102 build/C/man3/ceil.3:120 build/C/man3/copysign.3:112 build/C/man3/cos.3:125 build/C/man3/cosh.3:130 build/C/man3/div.3:115 build/C/man3/erf.3:140 build/C/man3/erfc.3:146 build/C/man3/exp.3:134 build/C/man3/exp10.3:84 build/C/man3/exp2.3:97 build/C/man3/expm1.3:178 build/C/man3/fabs.3:99 build/C/man3/fdim.3:91 build/C/man3/fenv.3:342 build/C/man3/finite.3:155 build/C/man3/floor.3:110 build/C/man3/fma.3:166 build/C/man3/fmax.3:68 build/C/man3/fmin.3:68 build/C/man3/fmod.3:160 build/C/man3/fpclassify.3:142 build/C/man3/frexp.3:155 build/C/man3/gamma.3:97 build/C/man3/hypot.3:164 build/C/man3/ilogb.3:162 build/C/man3/isgreater.3:143 build/C/man3/j0.3:172 build/C/man3/ldexp.3:143 build/C/man3/lgamma.3:177 build/C/man3/log.3:141 build/C/man3/log10.3:95 build/C/man3/log1p.3:153 build/C/man3/log2.3:97 build/C/man3/logb.3:153 build/C/man3/lrint.3:123 build/C/man3/lround.3:126 build/C/man7/math_error.7:256 build/C/man3/matherr.3:430 build/C/man3/modf.3:109 build/C/man3/nan.3:79 build/C/man3/nextafter.3:199 build/C/man3/pow.3:378 build/C/man3/pow10.3:54 build/C/man3/remainder.3:215 build/C/man3/remquo.3:134 build/C/man3/rint.3:155 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:129 build/C/man3/sincos.3:86 build/C/man3/sinh.3:130 build/C/man3/sqrt.3:113 build/C/man3/tan.3:154 build/C/man3/tanh.3:114 build/C/man3/tgamma.3:187 build/C/man3/trunc.3:94 build/C/man3/y0.3:253
160 #: build/C/man3/INFINITY.3:104
161 msgid "B<fpclassify>(3), B<math_error>(7)"
165 #: build/C/man3/INFINITY.3:104 build/C/man3/abs.3:139 build/C/man3/acos.3:127 build/C/man3/acosh.3:133 build/C/man3/asin.3:125 build/C/man3/asinh.3:126 build/C/man3/atan.3:119 build/C/man3/atan2.3:180 build/C/man3/atanh.3:163 build/C/man3/cbrt.3:105 build/C/man3/ceil.3:127 build/C/man3/copysign.3:114 build/C/man3/cos.3:134 build/C/man3/cosh.3:137 build/C/man3/div.3:118 build/C/man3/erf.3:144 build/C/man3/erfc.3:150 build/C/man3/exp.3:140 build/C/man3/exp10.3:90 build/C/man3/exp2.3:103 build/C/man3/expm1.3:182 build/C/man3/fabs.3:106 build/C/man3/fdim.3:93 build/C/man3/fenv.3:344 build/C/man3/finite.3:157 build/C/man3/floor.3:117 build/C/man3/fma.3:169 build/C/man3/fmax.3:70 build/C/man3/fmin.3:70 build/C/man3/fmod.3:162 build/C/man3/fpclassify.3:147 build/C/man3/frexp.3:158 build/C/man3/gamma.3:101 build/C/man3/hypot.3:167 build/C/man3/ilogb.3:166 build/C/man3/infnan.3:92 build/C/man3/isgreater.3:146 build/C/man3/j0.3:174 build/C/man3/ldexp.3:147 build/C/man3/lgamma.3:179 build/C/man3/log.3:148 build/C/man3/log10.3:102 build/C/man3/log1p.3:157 build/C/man3/log2.3:103 build/C/man3/logb.3:156 build/C/man3/lrint.3:130 build/C/man3/lround.3:133 build/C/man7/math_error.7:267 build/C/man3/matherr.3:434 build/C/man3/modf.3:112 build/C/man3/nan.3:83 build/C/man3/nextafter.3:201 build/C/man3/pow.3:382 build/C/man3/pow10.3:57 build/C/man3/remainder.3:219 build/C/man3/remquo.3:138 build/C/man3/rint.3:161 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:138 build/C/man3/sincos.3:90 build/C/man3/sinh.3:137 build/C/man3/sqrt.3:117 build/C/man3/tan.3:162 build/C/man3/tanh.3:121 build/C/man3/tgamma.3:190 build/C/man3/trunc.3:101 build/C/man3/y0.3:255
171 #: build/C/man3/INFINITY.3:112 build/C/man3/abs.3:147 build/C/man3/acos.3:135 build/C/man3/acosh.3:141 build/C/man3/asin.3:133 build/C/man3/asinh.3:134 build/C/man3/atan.3:127 build/C/man3/atan2.3:188 build/C/man3/atanh.3:171 build/C/man3/cbrt.3:113 build/C/man3/ceil.3:135 build/C/man3/copysign.3:122 build/C/man3/cos.3:142 build/C/man3/cosh.3:145 build/C/man3/div.3:126 build/C/man3/erf.3:152 build/C/man3/erfc.3:158 build/C/man3/exp.3:148 build/C/man3/exp10.3:98 build/C/man3/exp2.3:111 build/C/man3/expm1.3:190 build/C/man3/fabs.3:114 build/C/man3/fdim.3:101 build/C/man3/fenv.3:352 build/C/man3/finite.3:165 build/C/man3/floor.3:125 build/C/man3/fma.3:177 build/C/man3/fmax.3:78 build/C/man3/fmin.3:78 build/C/man3/fmod.3:170 build/C/man3/fpclassify.3:155 build/C/man3/frexp.3:166 build/C/man3/gamma.3:109 build/C/man3/hypot.3:175 build/C/man3/ilogb.3:174 build/C/man3/infnan.3:100 build/C/man3/isgreater.3:154 build/C/man3/j0.3:182 build/C/man3/ldexp.3:155 build/C/man3/lgamma.3:187 build/C/man3/log.3:156 build/C/man3/log10.3:110 build/C/man3/log1p.3:165 build/C/man3/log2.3:111 build/C/man3/logb.3:164 build/C/man3/lrint.3:138 build/C/man3/lround.3:141 build/C/man7/math_error.7:275 build/C/man3/matherr.3:442 build/C/man3/modf.3:120 build/C/man3/nan.3:91 build/C/man3/nextafter.3:209 build/C/man3/pow.3:390 build/C/man3/pow10.3:65 build/C/man3/remainder.3:227 build/C/man3/remquo.3:146 build/C/man3/rint.3:169 build/C/man3/round.3:134 build/C/man3/scalb.3:211 build/C/man3/scalbln.3:200 build/C/man3/signbit.3:80 build/C/man3/significand.3:68 build/C/man3/sin.3:146 build/C/man3/sincos.3:98 build/C/man3/sinh.3:145 build/C/man3/sqrt.3:125 build/C/man3/tan.3:170 build/C/man3/tanh.3:129 build/C/man3/tgamma.3:198 build/C/man3/trunc.3:109 build/C/man3/y0.3:263
173 "This page is part of release 3.76 of the Linux I<man-pages> project. A "
174 "description of the project, information about reporting bugs, and the latest "
175 "version of this page, can be found at "
176 "\\%http://www.kernel.org/doc/man-pages/."
180 #: build/C/man3/abs.3:34
186 #: build/C/man3/abs.3:34
192 #: 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
198 #: build/C/man3/abs.3:37
199 msgid "abs, labs, llabs, imaxabs - compute the absolute value of an integer"
203 #: build/C/man3/abs.3:40 build/C/man3/div.3:41
205 msgid "B<#include E<lt>stdlib.hE<gt>>\n"
209 #: build/C/man3/abs.3:42
211 msgid "B<int abs(int >I<j>B<);>\n"
215 #: build/C/man3/abs.3:44
217 msgid "B<long int labs(long int >I<j>B<);>\n"
221 #: build/C/man3/abs.3:46
223 msgid "B<long long int llabs(long long int >I<j>B<);>\n"
227 #: build/C/man3/abs.3:48 build/C/man3/div.3:49
229 msgid "B<#include E<lt>inttypes.hE<gt>>\n"
233 #: build/C/man3/abs.3:50
235 msgid "B<intmax_t imaxabs(intmax_t >I<j>B<);>\n"
239 #: 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
240 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
244 #: build/C/man3/abs.3:59
249 #: 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
251 "_XOPEN_SOURCE\\ E<gt>=\\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ "
256 #: 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
257 msgid "or I<cc\\ -std=c99>"
261 #: build/C/man3/abs.3:79
263 "The B<abs>() function computes the absolute value of the integer argument "
264 "I<j>. The B<labs>(), B<llabs>() and B<imaxabs>() functions compute the "
265 "absolute value of the argument I<j> of the appropriate integer type for the "
270 #: 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:81 build/C/man3/cos.3:75 build/C/man3/cosh.3:79 build/C/man3/div.3:89 build/C/man3/erf.3:83 build/C/man3/erfc.3:71 build/C/man3/exp.3:74 build/C/man3/exp10.3:58 build/C/man3/exp2.3:74 build/C/man3/expm1.3:88 build/C/man3/fabs.3:68 build/C/man3/fdim.3:42 build/C/man3/fenv.3:258 build/C/man3/floor.3:68 build/C/man3/fma.3:53 build/C/man3/fmax.3:45 build/C/man3/fmin.3:45 build/C/man3/fmod.3:87 build/C/man3/frexp.3:74 build/C/man3/gamma.3:59 build/C/man3/hypot.3:92 build/C/man3/ilogb.3:78 build/C/man3/infnan.3:56 build/C/man3/isgreater.3:111 build/C/man3/j0.3:121 build/C/man3/ldexp.3:73 build/C/man3/lgamma.3:96 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:74 build/C/man3/lround.3:77 build/C/man3/modf.3:76 build/C/man3/nextafter.3:104 build/C/man3/pow.3:75 build/C/man3/remainder.3:118 build/C/man3/remquo.3:73 build/C/man3/rint.3:111 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:126
276 #: build/C/man3/abs.3:82
278 "Returns the absolute value of the integer argument, of the appropriate "
279 "integer type for the function."
283 #: build/C/man3/abs.3:82 build/C/man3/asinh.3:105 build/C/man3/atan.3:96 build/C/man3/cbrt.3:90 build/C/man3/ceil.3:81 build/C/man3/copysign.3:95 build/C/man3/cos.3:104 build/C/man3/div.3:91 build/C/man3/erf.3:126 build/C/man3/erfc.3:122 build/C/man3/expm1.3:136 build/C/man3/fabs.3:85 build/C/man3/fdim.3:81 build/C/man3/fenv.3:265 build/C/man3/finite.3:121 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/fpclassify.3:118 build/C/man3/frexp.3:108 build/C/man3/ilogb.3:136 build/C/man3/isgreater.3:125 build/C/man3/ldexp.3:129 build/C/man3/log1p.3:142 build/C/man3/logb.3:143 build/C/man3/lrint.3:110 build/C/man3/lround.3:113 build/C/man3/matherr.3:275 build/C/man3/modf.3:95 build/C/man3/nextafter.3:179 build/C/man3/remquo.3:124 build/C/man3/rint.3:122 build/C/man3/round.3:88 build/C/man3/scalbln.3:160 build/C/man3/signbit.3:61 build/C/man3/sin.3:108 build/C/man3/sincos.3:76 build/C/man3/tan.3:133 build/C/man3/tanh.3:100 build/C/man3/trunc.3:75
289 #: build/C/man3/abs.3:83 build/C/man3/asinh.3:106 build/C/man3/atan.3:97 build/C/man3/cbrt.3:91 build/C/man3/ceil.3:82 build/C/man3/copysign.3:96 build/C/man3/cos.3:105 build/C/man3/div.3:92 build/C/man3/erf.3:127 build/C/man3/erfc.3:123 build/C/man3/expm1.3:137 build/C/man3/fabs.3:86 build/C/man3/fdim.3:82 build/C/man3/fenv.3:266 build/C/man3/finite.3:122 build/C/man3/floor.3:81 build/C/man3/fma.3:157 build/C/man3/fmax.3:59 build/C/man3/fmin.3:59 build/C/man3/fpclassify.3:119 build/C/man3/frexp.3:109 build/C/man3/ilogb.3:137 build/C/man3/isgreater.3:126 build/C/man3/ldexp.3:130 build/C/man3/log1p.3:143 build/C/man3/logb.3:144 build/C/man3/lrint.3:111 build/C/man3/lround.3:114 build/C/man3/matherr.3:276 build/C/man3/modf.3:96 build/C/man3/nextafter.3:180 build/C/man3/remquo.3:125 build/C/man3/rint.3:123 build/C/man3/round.3:89 build/C/man3/scalbln.3:161 build/C/man3/signbit.3:62 build/C/man3/sin.3:109 build/C/man3/sincos.3:77 build/C/man3/tan.3:134 build/C/man3/tanh.3:101 build/C/man3/trunc.3:76
291 msgid "Multithreading (see pthreads(7))"
295 #: build/C/man3/abs.3:91
297 "The B<abs>(), B<labs>(), B<llabs>(), and B<imaxabs>() functions are "
301 #. POSIX.1 (1996 edition) requires only the
305 #: build/C/man3/abs.3:106
307 "SVr4, POSIX.1-2001, 4.3BSD, C99. C89 only includes the B<abs>() and "
308 "B<labs>() functions; the functions B<llabs>() and B<imaxabs>() were added "
313 #: build/C/man3/abs.3:106 build/C/man3/ceil.3:95 build/C/man3/copysign.3:108 build/C/man3/erfc.3:136 build/C/man3/fenv.3:286 build/C/man3/finite.3:135 build/C/man3/floor.3:94 build/C/man3/fpclassify.3:135 build/C/man3/gamma.3:68 build/C/man3/infnan.3:89 build/C/man3/isgreater.3:138 build/C/man7/math_error.7:187 build/C/man3/pow10.3:51 build/C/man3/rint.3:135 build/C/man3/round.3:98 build/C/man3/scalbln.3:173 build/C/man3/tgamma.3:162 build/C/man3/trunc.3:85
319 #: build/C/man3/abs.3:109
321 "Trying to take the absolute value of the most negative integer is not "
326 #: build/C/man3/abs.3:117
328 "The B<llabs>() function is included in glibc since version 2.0. The "
329 "B<imaxabs>() function is included in glibc since version 2.1.1."
333 #: build/C/man3/abs.3:123
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."
341 #: build/C/man3/abs.3:133
343 "By default, GCC handles B<abs>(), B<labs>(), and (since GCC 3.0) B<llabs>() "
344 "and B<imaxabs>() as built-in functions."
348 #: build/C/man3/abs.3:139
349 msgid "B<cabs>(3), B<ceil>(3), B<fabs>(3), B<floor>(3), B<rint>(3)"
353 #: build/C/man3/acos.3:35
359 #: build/C/man3/acos.3:35 build/C/man3/acosh.3:35 build/C/man3/asin.3:35 build/C/man3/atan2.3:35 build/C/man3/cosh.3:36 build/C/man3/exp.3:36 build/C/man3/exp2.3:36 build/C/man3/hypot.3:33 build/C/man3/log.3:36 build/C/man3/log10.3:36 build/C/man3/nan.3:11 build/C/man3/remainder.3:37 build/C/man3/sinh.3:36 build/C/man3/sqrt.3:34
365 #: build/C/man3/acos.3:38
366 msgid "acos, acosf, acosl - arc cosine function"
370 #: build/C/man3/acos.3:45
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"
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>."
384 #: build/C/man3/acos.3:57
385 msgid "B<acosf>(), B<acosl>():"
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
391 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
392 "_ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
396 #: build/C/man3/acos.3:73
398 "The B<acos>() function calculates the arc cosine of I<x>; that is the value "
399 "whose cosine is I<x>."
403 #: build/C/man3/acos.3:77
405 "On success, these functions return the arc cosine of I<x> in radians; the "
406 "return value is in the range [0,\\ pi]."
410 #: build/C/man3/acos.3:81 build/C/man3/acosh.3:91 build/C/man3/asin.3:82 build/C/man3/asinh.3:91 build/C/man3/atan.3:82 build/C/man3/atanh.3:91 build/C/man3/cos.3:82 build/C/man3/cosh.3:86 build/C/man3/erf.3:91 build/C/man3/erfc.3:79 build/C/man3/exp.3:82 build/C/man3/expm1.3:96 build/C/man3/fabs.3:75 build/C/man3/j0.3:129 build/C/man3/ldexp.3:87 build/C/man3/lgamma.3:102 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:134
411 msgid "If I<x> is a NaN, a NaN is returned."
415 #: build/C/man3/acos.3:86 build/C/man3/acosh.3:95
416 msgid "If I<x> is +1, +0 is returned."
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
422 "If I<x> is positive infinity or negative infinity, a domain error occurs, "
423 "and a NaN is returned."
427 #. POSIX.1-2001 documents an optional range error for subnormal x;
428 #. glibc 2.8 does not do this.
430 #: build/C/man3/acos.3:98 build/C/man3/asin.3:96
432 "If I<x> is outside the range [-1,\\ 1], a domain error occurs, and a NaN is "
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:93 build/C/man3/cos.3:88 build/C/man3/cosh.3:104 build/C/man3/erf.3:106 build/C/man3/erfc.3:102 build/C/man3/exp.3:105 build/C/man3/exp10.3:65 build/C/man3/exp2.3:81 build/C/man3/expm1.3:117 build/C/man3/fabs.3:83 build/C/man3/fdim.3:59 build/C/man3/floor.3:77 build/C/man3/fma.3:117 build/C/man3/fmax.3:54 build/C/man3/fmin.3:54 build/C/man3/fmod.3:120 build/C/man3/frexp.3:106 build/C/man3/gamma.3:62 build/C/man3/hypot.3:128 build/C/man3/ilogb.3:110 build/C/man3/infnan.3:76 build/C/man3/isgreater.3:123 build/C/man3/j0.3:136 build/C/man3/ldexp.3:106 build/C/man3/lgamma.3:132 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:88 build/C/man3/lround.3:91 build/C/man3/modf.3:93 build/C/man3/nextafter.3:149 build/C/man3/pow.3:256 build/C/man3/remainder.3:150 build/C/man3/remquo.3:101 build/C/man3/rint.3:119 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:171
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:141 build/C/man3/ldexp.3:111 build/C/man3/lgamma.3:137 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:93 build/C/man3/lround.3:96 build/C/man3/nextafter.3:154 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:176
445 "See B<math_error>(7) for information on how to determine whether an error "
446 "has occurred when calling these functions."
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:143 build/C/man3/ldexp.3:113 build/C/man3/lgamma.3:139 build/C/man3/log.3:112 build/C/man3/log1p.3:120 build/C/man3/logb.3:123 build/C/man3/lrint.3:95 build/C/man3/lround.3:98 build/C/man3/nextafter.3:156 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:178
451 msgid "The following errors can occur:"
455 #: build/C/man3/acos.3:105 build/C/man3/asin.3:103
457 msgid "Domain error: I<x> is outside the range [-1,\\ 1]"
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:186
463 "I<errno> is set to B<EDOM>. An invalid floating-point exception "
464 "(B<FE_INVALID>) is raised."
468 #: build/C/man3/acos.3:119 build/C/man3/acosh.3:126 build/C/man3/asin.3:117 build/C/man3/asinh.3:119 build/C/man3/atan.3:110 build/C/man3/atan2.3:172 build/C/man3/atanh.3:145 build/C/man3/ceil.3:95 build/C/man3/exp.3:134 build/C/man3/exp2.3:97 build/C/man3/fabs.3:99 build/C/man3/floor.3:94 build/C/man3/fmod.3:152 build/C/man3/frexp.3:122 build/C/man3/ldexp.3:143 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:122 build/C/man3/sinh.3:130 build/C/man3/sqrt.3:113 build/C/man3/tan.3:147 build/C/man3/tanh.3:114
470 "C99, POSIX.1-2001. The variant returning I<double> also conforms to SVr4, "
475 #: build/C/man3/acos.3:127
477 "B<asin>(3), B<atan>(3), B<atan2>(3), B<cacos>(3), B<cos>(3), B<sin>(3), "
482 #: build/C/man3/acosh.3:35
488 #: build/C/man3/acosh.3:38
489 msgid "acosh, acoshf, acoshl - inverse hyperbolic cosine function"
493 #: build/C/man3/acosh.3:43
495 msgid "B<double acosh(double >I<x>B<);>\n"
499 #: build/C/man3/acosh.3:45
501 msgid "B<float acoshf(float >I<x>B<);>\n"
505 #: build/C/man3/acosh.3:47
507 msgid "B<long double acoshl(long double >I<x>B<);>\n"
511 #: build/C/man3/acosh.3:58
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
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;"
524 #: build/C/man3/acosh.3:69
525 msgid "B<acoshf>(), B<acoshl>():"
529 #: build/C/man3/acosh.3:84
531 "The B<acosh>() function calculates the inverse hyperbolic cosine of I<x>; "
532 "that is the value whose hyperbolic cosine is I<x>."
536 #: build/C/man3/acosh.3:87
537 msgid "On success, these functions return the inverse hyperbolic cosine of I<x>."
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."
546 #: build/C/man3/acosh.3:105
548 "If I<x> is less than 1, a domain error occurs, and the functions return a "
553 #: build/C/man3/acosh.3:112
555 msgid "Domain error: I<x> is less than 1"
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)"
564 #: build/C/man3/asin.3:35
570 #: build/C/man3/asin.3:38
571 msgid "asin, asinf, asinl - arc sine function"
575 #: build/C/man3/asin.3:43
577 msgid "B<double asin(double >I<x>B<);>\n"
581 #: build/C/man3/asin.3:45
583 msgid "B<float asinf(float >I<x>B<);>\n"
587 #: build/C/man3/asin.3:47
589 msgid "B<long double asinl(long double >I<x>B<);>\n"
593 #: build/C/man3/asin.3:59
594 msgid "B<asinf>(), B<asinl>():"
598 #: build/C/man3/asin.3:74
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>."
605 #: build/C/man3/asin.3:78
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]."
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."
617 #: build/C/man3/asin.3:125
619 "B<acos>(3), B<atan>(3), B<atan2>(3), B<casin>(3), B<cos>(3), B<sin>(3), "
624 #: build/C/man3/asinh.3:35
630 #: build/C/man3/asinh.3:35 build/C/man3/copysign.3:31 build/C/man3/cos.3:34 build/C/man3/expm1.3:30
636 #: build/C/man3/asinh.3:38
637 msgid "asinh, asinhf, asinhl - inverse hyperbolic sine function"
641 #: build/C/man3/asinh.3:43
643 msgid "B<double asinh(double >I<x>B<);>\n"
647 #: build/C/man3/asinh.3:45
649 msgid "B<float asinhf(float >I<x>B<);>\n"
653 #: build/C/man3/asinh.3:47
655 msgid "B<long double asinhl(long double >I<x>B<);>\n"
659 #: build/C/man3/asinh.3:58
664 #: build/C/man3/asinh.3:69
665 msgid "B<asinhf>(), B<asinhl>():"
669 #: build/C/man3/asinh.3:84
671 "The B<asinh>() function calculates the inverse hyperbolic sine of I<x>; "
672 "that is the value whose hyperbolic sine is I<x>."
676 #: build/C/man3/asinh.3:87
677 msgid "On success, these functions return the inverse hyperbolic sine of I<x>."
681 #: build/C/man3/asinh.3:103 build/C/man3/ldexp.3:92 build/C/man3/scalbln.3:111 build/C/man3/sinh.3:95
683 "If I<x> is positive infinity (negative infinity), positive infinity "
684 "(negative infinity) is returned."
688 #: 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:95 build/C/man3/fabs.3:85 build/C/man3/fmax.3:56 build/C/man3/fmin.3:56 build/C/man3/frexp.3:108 build/C/man3/isgreater.3:125 build/C/man3/modf.3:95 build/C/man3/signbit.3:61 build/C/man3/tanh.3:100 build/C/man3/trunc.3:73
689 msgid "No errors occur."
693 #: build/C/man3/asinh.3:113
694 msgid "The B<asinh>(), B<asinhf>(), and B<asinhl>() functions are thread-safe."
698 #: build/C/man3/asinh.3:126
699 msgid "B<acosh>(3), B<atanh>(3), B<casinh>(3), B<cosh>(3), B<sinh>(3), B<tanh>(3)"
703 #: build/C/man3/atan.3:35
709 #: build/C/man3/atan.3:35
715 #: build/C/man3/atan.3:38
716 msgid "atan, atanf, atanl - arc tangent function"
720 #: build/C/man3/atan.3:43
722 msgid "B<double atan(double >I<x>B<);>\n"
726 #: build/C/man3/atan.3:45
728 msgid "B<float atanf(float >I<x>B<);>\n"
732 #: build/C/man3/atan.3:47
734 msgid "B<long double atanl( long double >I<x>B<);>\n"
738 #: build/C/man3/atan.3:59
739 msgid "B<atanf>(), B<atanl>():"
743 #: build/C/man3/atan.3:74
745 "The B<atan>() function calculates the principal value of the arc tangent of "
746 "I<x>; that is the value whose tangent is I<x>."
750 #: build/C/man3/atan.3:78
752 "On success, these functions return the principal value of the arc tangent of "
753 "I<x> in radians; the return value is in the range [-pi/2,\\ pi/2]."
757 #. POSIX.1-2001 documents an optional range error for subnormal x;
758 #. glibc 2.8 does not do this.
760 #: build/C/man3/atan.3:94
761 msgid "If I<x> is positive infinity (negative infinity), +pi/2 (-pi/2) is returned."
765 #: build/C/man3/atan.3:104
766 msgid "The B<atan>(), B<atanf>(), and B<atanl>() functions are thread-safe."
770 #: build/C/man3/atan.3:119
772 "B<acos>(3), B<asin>(3), B<atan2>(3), B<carg>(3), B<catan>(3), B<cos>(3), "
773 "B<sin>(3), B<tan>(3)"
777 #: build/C/man3/atan2.3:35
783 #: build/C/man3/atan2.3:38
784 msgid "atan2, atan2f, atan2l - arc tangent function of two variables"
788 #: build/C/man3/atan2.3:45
791 "B<double atan2(double >I<y>B<, double >I<x>B<);>\n"
792 "B<float atan2f(float >I<y>B<, float >I<x>B<);>\n"
793 "B<long double atan2l(long double >I<y>B<, long double >I<x>B<);>\n"
797 #: build/C/man3/atan2.3:57
798 msgid "B<atan2f>(), B<atan2l>():"
802 #: build/C/man3/atan2.3:72
804 "The B<atan2>() function calculates the principal value of the arc tangent "
805 "of I<y/x>, using the signs of the two arguments to determine the quadrant of "
810 #: build/C/man3/atan2.3:76
812 "On success, these functions return the principal value of the arc tangent of "
813 "I<y/x> in radians; the return value is in the range [-pi,\\ pi]."
817 #: build/C/man3/atan2.3:82
818 msgid "If I<y> is +0 (-0) and I<x> is less than 0, +pi (-pi) is returned."
822 #: build/C/man3/atan2.3:88
823 msgid "If I<y> is +0 (-0) and I<x> is greater than 0, +0 (-0) is returned."
827 #: build/C/man3/atan2.3:94
828 msgid "If I<y> is less than 0 and I<x> is +0 or -0, -pi/2 is returned."
832 #: build/C/man3/atan2.3:100
833 msgid "If I<y> is greater than 0 and I<x> is +0 or -0, pi/2 is returned."
839 #. is 0, a pole error shall not occur.
841 #: build/C/man3/atan2.3:111
842 msgid "If either I<x> or I<y> is NaN, a NaN is returned."
846 #. If the result underflows, a range error may occur and
848 #. should be returned.
850 #: build/C/man3/atan2.3:122
851 msgid "If I<y> is +0 (-0) and I<x> is -0, +pi (-pi) is returned."
855 #: build/C/man3/atan2.3:128
856 msgid "If I<y> is +0 (-0) and I<x> is +0, +0 (-0) is returned."
860 #: build/C/man3/atan2.3:134
862 "If I<y> is a finite value greater (less) than 0, and I<x> is negative "
863 "infinity, +pi (-pi) is returned."
867 #: build/C/man3/atan2.3:140
869 "If I<y> is a finite value greater (less) than 0, and I<x> is positive "
870 "infinity, +0 (-0) is returned."
874 #: build/C/man3/atan2.3:147
876 "If I<y> is positive infinity (negative infinity), and I<x> is finite, pi/2 "
877 "(-pi/2) is returned."
881 #: build/C/man3/atan2.3:153
883 "If I<y> is positive infinity (negative infinity) and I<x> is negative "
884 "infinity, +3*pi/4 (-3*pi/4) is returned."
889 #. If both arguments are 0, a domain error shall not occur.
891 #: build/C/man3/atan2.3:162
893 "If I<y> is positive infinity (negative infinity) and I<x> is positive "
894 "infinity, +pi/4 (-pi/4) is returned."
898 #: build/C/man3/atan2.3:180
900 "B<acos>(3), B<asin>(3), B<atan>(3), B<carg>(3), B<cos>(3), B<sin>(3), "
905 #: build/C/man3/atanh.3:35
911 #: build/C/man3/atanh.3:35
917 #: build/C/man3/atanh.3:38
918 msgid "atanh, atanhf, atanhl - inverse hyperbolic tangent function"
922 #: build/C/man3/atanh.3:43
924 msgid "B<double atanh(double >I<x>B<);>\n"
928 #: build/C/man3/atanh.3:45
930 msgid "B<float atanhf(float >I<x>B<);>\n"
934 #: build/C/man3/atanh.3:47
936 msgid "B<long double atanhl(long double >I<x>B<);>\n"
940 #: build/C/man3/atanh.3:58
945 #: build/C/man3/atanh.3:69
946 msgid "B<atanhf>(), B<atanhl>():"
950 #: build/C/man3/atanh.3:84
952 "The B<atanh>() function calculates the inverse hyperbolic tangent of I<x>; "
953 "that is the value whose hyperbolic tangent is I<x>."
957 #: build/C/man3/atanh.3:87
958 msgid "On success, these functions return the inverse hyperbolic tangent of I<x>."
962 #: build/C/man3/atanh.3:106
964 "If I<x> is +1 or -1, a pole error occurs, and the functions return "
965 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the "
966 "mathematically correct sign."
970 #. POSIX.1-2001 documents an optional range error for subnormal x;
971 #. glibc 2.8 does not do this.
973 #: build/C/man3/atanh.3:115
975 "If the absolute value of I<x> is greater than 1, a domain error occurs, and "
980 #: build/C/man3/atanh.3:122
982 msgid "Domain error: I<x> less than -1 or greater than +1"
986 #: build/C/man3/atanh.3:130
988 msgid "Pole error: I<x> is +1 or -1"
992 #: build/C/man3/atanh.3:139 build/C/man3/lgamma.3:148 build/C/man3/pow.3:300
994 "I<errno> is set to B<ERANGE> (but see BUGS). A divide-by-zero "
995 "floating-point exception (B<FE_DIVBYZERO>) is raised."
999 #: build/C/man3/atanh.3:145 build/C/man3/cos.3:118 build/C/man3/cosh.3:125 build/C/man3/exp10.3:77 build/C/man3/expm1.3:147 build/C/man3/fenv.3:331 build/C/man3/fmod.3:152 build/C/man3/ilogb.3:146 build/C/man3/j0.3:163 build/C/man3/lgamma.3:167 build/C/man3/log.3:134 build/C/man3/nextafter.3:194 build/C/man3/pow.3:322 build/C/man3/remainder.3:204 build/C/man3/sin.3:122 build/C/man3/tan.3:147 build/C/man3/tgamma.3:169 build/C/man3/y0.3:236
1004 #. Bug: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6759
1005 #. This can be seen in sysdeps/ieee754/k_standard.c
1007 #: build/C/man3/atanh.3:156
1009 "In glibc 2.9 and earlier, when a pole error occurs, I<errno> as set to "
1010 "B<EDOM> instead of the POSIX-mandated B<ERANGE>. Since version 2.10, glibc "
1011 "does the right thing."
1015 #: build/C/man3/atanh.3:163
1016 msgid "B<acosh>(3), B<asinh>(3), B<catanh>(3), B<cosh>(3), B<sinh>(3), B<tanh>(3)"
1020 #: build/C/man3/cbrt.3:30
1026 #: build/C/man3/cbrt.3:30
1032 #: build/C/man3/cbrt.3:33
1033 msgid "cbrt, cbrtf, cbrtl - cube root function"
1037 #: build/C/man3/cbrt.3:38
1039 msgid "B<double cbrt(double >I<x>B<);>\n"
1043 #: build/C/man3/cbrt.3:40
1045 msgid "B<float cbrtf(float >I<x>B<);>\n"
1049 #: build/C/man3/cbrt.3:42
1051 msgid "B<long double cbrtl(long double >I<x>B<);>\n"
1055 #: build/C/man3/cbrt.3:53
1060 #: build/C/man3/cbrt.3:64
1061 msgid "B<cbrtf>(), B<cbrtl>():"
1065 #: build/C/man3/cbrt.3:67
1067 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
1068 "_ISOC99_SOURCE || _POSIX_C_SOUCE\\ E<gt>=\\ 200112L;"
1072 #: build/C/man3/cbrt.3:79
1074 "The B<cbrt>() function returns the (real) cube root of I<x>. This function "
1075 "cannot fail; every representable real value has a representable real cube "
1080 #: build/C/man3/cbrt.3:82
1081 msgid "These functions return the cube root of I<x>."
1085 #: build/C/man3/cbrt.3:88
1087 "If I<x> is +0, -0, positive infinity, negative infinity, or NaN, I<x> is "
1092 #: build/C/man3/cbrt.3:98
1093 msgid "The B<cbrt>(), B<cbrtf>(), and B<cbrtl>() functions are thread-safe."
1097 #: build/C/man3/cbrt.3:102 build/C/man3/expm1.3:147 build/C/man3/fdim.3:91 build/C/man3/fma.3:166 build/C/man3/fmax.3:68 build/C/man3/fmin.3:68 build/C/man3/ilogb.3:146 build/C/man3/isgreater.3:138 build/C/man3/log1p.3:153 build/C/man3/logb.3:153 build/C/man3/lrint.3:123 build/C/man3/lround.3:126 build/C/man3/remquo.3:134 build/C/man3/rint.3:135 build/C/man3/round.3:98 build/C/man3/scalbln.3:173 build/C/man3/tgamma.3:162 build/C/man3/trunc.3:85
1098 msgid "C99, POSIX.1-2001."
1102 #: build/C/man3/cbrt.3:105
1103 msgid "B<pow>(3), B<sqrt>(3)"
1107 #: build/C/man3/ceil.3:27
1113 #: 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
1119 #: build/C/man3/ceil.3:31
1121 "ceil, ceilf, ceill - ceiling function: smallest integral value not less than "
1126 #: build/C/man3/ceil.3:36
1128 msgid "B<double ceil(double >I<x>B<);>\n"
1132 #: build/C/man3/ceil.3:38
1134 msgid "B<float ceilf(float >I<x>B<);>\n"
1138 #: build/C/man3/ceil.3:40
1140 msgid "B<long double ceill(long double >I<x>B<);>\n"
1144 #: build/C/man3/ceil.3:52
1145 msgid "B<ceilf>(), B<ceill>():"
1149 #: build/C/man3/ceil.3:63
1151 "These functions return the smallest integral value that is not less than "
1156 #: build/C/man3/ceil.3:69
1157 msgid "For example, I<ceil(0.5)> is 1.0, and I<ceil(-0.5)> is 0.0."
1161 #: build/C/man3/ceil.3:72
1162 msgid "These functions return the ceiling of I<x>."
1166 #: build/C/man3/ceil.3:78 build/C/man3/rint.3:119 build/C/man3/round.3:83
1167 msgid "If I<x> is integral, +0, -0, NaN, or infinite, I<x> itself is returned."
1171 #: build/C/man3/ceil.3:81 build/C/man3/floor.3:80 build/C/man3/rint.3:122 build/C/man3/round.3:86
1173 "No errors occur. POSIX.1-2001 documents a range error for overflows, but "
1178 #: build/C/man3/ceil.3:89
1179 msgid "The B<ceil>(), B<ceilf>(), and B<ceill>() functions are thread-safe."
1183 #: build/C/man3/ceil.3:111 build/C/man3/floor.3:110 build/C/man3/rint.3:150
1185 "SUSv2 and POSIX.1-2001 contain text about overflow (which might set I<errno> "
1186 "to B<ERANGE>, or raise an B<FE_OVERFLOW> exception). In practice, the "
1187 "result cannot overflow on any current machine, so this error-handling stuff "
1188 "is just nonsense. (More precisely, overflow can happen only when the "
1189 "maximum value of the exponent is smaller than the number of mantissa bits. "
1190 "For the IEEE-754 standard 32-bit and 64-bit floating-point numbers the "
1191 "maximum value of the exponent is 128 (respectively, 1024), and the number of "
1192 "mantissa bits is 24 (respectively, 53).)"
1196 #: build/C/man3/ceil.3:120 build/C/man3/trunc.3:94
1198 "The integral value returned by these functions may be too large to store in "
1199 "an integer type (I<int>, I<long>, etc.). To avoid an overflow, which will "
1200 "produce undefined results, an application should perform a range check on "
1201 "the returned value before assigning it to an integer type."
1205 #: build/C/man3/ceil.3:127
1207 "B<floor>(3), B<lrint>(3), B<nearbyint>(3), B<rint>(3), B<round>(3), "
1212 #: build/C/man3/copysign.3:31
1218 #: build/C/man3/copysign.3:34
1219 msgid "copysign, copysignf, copysignl - copy sign of a number"
1223 #: build/C/man3/copysign.3:39
1225 msgid "B<double copysign(double >I<x>B<, double >I<y>B<);>\n"
1229 #: build/C/man3/copysign.3:41
1231 msgid "B<float copysignf(float >I<x>B<, float >I<y>B<);>\n"
1235 #: build/C/man3/copysign.3:43
1237 msgid "B<long double copysignl(long double >I<x>B<, long double >I<y>B<);>\n"
1241 #: build/C/man3/copysign.3:56
1242 msgid "B<copysign>(), B<copysignf>(), B<copysignl>():"
1246 #: build/C/man3/copysign.3:59
1248 "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
1249 "_ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
1253 #: build/C/man3/copysign.3:75
1255 "The B<copysign>(), B<copysignf>(), and B<copysignl>() functions return a "
1256 "value whose absolute value matches that of I<x>, but whose sign bit matches "
1261 #: build/C/man3/copysign.3:81
1263 "For example, I<copysign(42.0,\\ -1.0)> and I<copysign(-42.0, -1.0)> both "
1268 #: build/C/man3/copysign.3:86
1270 "On success, these functions return a value whose magnitude is taken from "
1271 "I<x> and whose sign is taken from I<y>."
1275 #: build/C/man3/copysign.3:93
1276 msgid "If I<x> is a NaN, a NaN with the sign bit of I<y> is returned."
1280 #: build/C/man3/copysign.3:103
1282 "The B<copysign>(), B<copysignf>(), and B<copysignl>() functions are "
1287 #: build/C/man3/copysign.3:108 build/C/man3/nextafter.3:194 build/C/man3/signbit.3:70
1289 "C99, POSIX.1-2001. This function is defined in IEC 559 (and the appendix "
1290 "with recommended functions in IEEE 754/IEEE 854)."
1294 #: build/C/man3/copysign.3:112
1296 "On architectures where the floating-point formats are not IEEE 754 "
1297 "compliant, these functions may treat a negative zero as positive."
1301 #: build/C/man3/copysign.3:114
1302 msgid "B<signbit>(3)"
1306 #: build/C/man3/cos.3:34
1312 #: build/C/man3/cos.3:37
1313 msgid "cos, cosf, cosl - cosine function"
1317 #: build/C/man3/cos.3:42
1319 msgid "B<double cos(double >I<x>B<);>\n"
1323 #: build/C/man3/cos.3:44
1325 msgid "B<float cosf(float >I<x>B<);>\n"
1329 #: build/C/man3/cos.3:46
1331 msgid "B<long double cosl(long double >I<x>B<);>\n"
1335 #: build/C/man3/cos.3:58
1336 msgid "B<cosf>(), B<cosl>():"
1340 #: build/C/man3/cos.3:75
1342 "The B<cos>() function returns the cosine of I<x>, where I<x> is given in "
1347 #: build/C/man3/cos.3:78
1348 msgid "On success, these functions return the cosine of I<x>."
1352 #: build/C/man3/cos.3:95 build/C/man3/fmod.3:127 build/C/man3/ilogb.3:127 build/C/man3/sin.3:99 build/C/man3/sincos.3:59 build/C/man3/tan.3:114
1354 msgid "Domain error: I<x> is an infinity"
1358 #: build/C/man3/cos.3:104 build/C/man3/fmod.3:136 build/C/man3/sin.3:108 build/C/man3/tan.3:123
1360 "I<errno> is set to B<EDOM> (but see BUGS). An invalid floating-point "
1361 "exception (B<FE_INVALID>) is raised."
1365 #: build/C/man3/cos.3:112
1366 msgid "The B<cos>(), B<cosf>(), and B<cosl>() functions are thread-safe."
1370 #: build/C/man3/cos.3:118 build/C/man3/cosh.3:125 build/C/man3/erf.3:140 build/C/man3/erfc.3:136 build/C/man3/hypot.3:164 build/C/man3/log2.3:97
1372 "C99, POSIX.1-2001. The variant returning I<double> also conforms to SVr4, "
1376 #. http://sourceware.org/bugzilla/show_bug.cgi?id=6782
1378 #: build/C/man3/cos.3:125 build/C/man3/sin.3:129 build/C/man3/tan.3:154
1380 "Before version 2.10, the glibc implementation did not set I<errno> to "
1381 "B<EDOM> when a domain error occurred."
1385 #: build/C/man3/cos.3:134
1387 "B<acos>(3), B<asin>(3), B<atan>(3), B<atan2>(3), B<ccos>(3), B<sin>(3), "
1388 "B<sincos>(3), B<tan>(3)"
1392 #: build/C/man3/cosh.3:36
1398 #: build/C/man3/cosh.3:39
1399 msgid "cosh, coshf, coshl - hyperbolic cosine function"
1403 #: build/C/man3/cosh.3:44
1405 msgid "B<double cosh(double >I<x>B<);>\n"
1409 #: build/C/man3/cosh.3:46
1411 msgid "B<float coshf(float >I<x>B<);>\n"
1415 #: build/C/man3/cosh.3:48
1417 msgid "B<long double coshl(long double >I<x>B<);>\n"
1421 #: build/C/man3/cosh.3:60
1422 msgid "B<coshf>(), B<coshl>():"
1426 #: build/C/man3/cosh.3:75
1428 "The B<cosh>() function returns the hyperbolic cosine of I<x>, which is "
1429 "defined mathematically as:"
1433 #: build/C/man3/cosh.3:78
1435 msgid " cosh(x) = (exp(x) + exp(-x)) / 2\n"
1439 #: build/C/man3/cosh.3:82
1440 msgid "On success, these functions return the hyperbolic cosine of I<x>."
1444 #: build/C/man3/cosh.3:90 build/C/man3/erfc.3:83
1445 msgid "If I<x> is +0 or -0, 1 is returned."
1449 #: build/C/man3/cosh.3:95 build/C/man3/lgamma.3:111
1451 "If I<x> is positive infinity or negative infinity, positive infinity is "
1456 #: build/C/man3/cosh.3:104 build/C/man3/exp.3:105
1458 "If the result overflows, a range error occurs, and the functions return "
1459 "+B<HUGE_VAL>, +B<HUGE_VALF>, or +B<HUGE_VALL>, respectively."
1463 #: 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:148 build/C/man3/nextafter.3:156 build/C/man3/sinh.3:116 build/C/man3/tan.3:123 build/C/man3/tgamma.3:130 build/C/man3/y0.3:217
1465 msgid "Range error: result overflow"
1469 #: 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:158 build/C/man3/pow.3:308 build/C/man3/sinh.3:124 build/C/man3/tgamma.3:138
1471 "I<errno> is set to B<ERANGE>. An overflow floating-point exception "
1472 "(B<FE_OVERFLOW>) is raised."
1476 #: build/C/man3/cosh.3:130
1478 "In glibc version 2.3.4 and earlier, an overflow floating-point "
1479 "(B<FE_OVERFLOW>) exception is not raised when an overflow occurs."
1483 #: build/C/man3/cosh.3:137
1484 msgid "B<acosh>(3), B<asinh>(3), B<atanh>(3), B<ccos>(3), B<sinh>(3), B<tanh>(3)"
1488 #: build/C/man3/div.3:34
1494 #: build/C/man3/div.3:34
1500 #: build/C/man3/div.3:38
1502 "div, ldiv, lldiv, imaxdiv - compute quotient and remainder of an integer "
1507 #: build/C/man3/div.3:43
1509 msgid "B<div_t div(int >I<numerator>B<, int >I<denominator>B<);>\n"
1513 #: build/C/man3/div.3:45
1515 msgid "B<ldiv_t ldiv(long >I<numerator>B<, long >I<denominator>B<);>\n"
1519 #: build/C/man3/div.3:47
1521 msgid "B<lldiv_t lldiv(long long >I<numerator>B<, long long >I<denominator>B<);>\n"
1525 #: build/C/man3/div.3:51
1528 "B<imaxdiv_t imaxdiv(intmax_t >I<numerator>B<, intmax_t "
1529 ">I<denominator>B<);>\n"
1533 #: build/C/man3/div.3:60
1538 #: build/C/man3/div.3:78
1540 "The B<div>() function computes the value I<numerator>/I<denominator> and "
1541 "returns the quotient and remainder in a structure named I<div_t> that "
1542 "contains two integer members (in unspecified order) named I<quot> and "
1543 "I<rem>. The quotient is rounded toward zero. The result satisfies "
1544 "I<quot>*I<denominator>+I<rem> = I<numerator>."
1548 #: build/C/man3/div.3:89
1550 "The B<ldiv>(), B<lldiv>(), and B<imaxdiv>() functions do the same, dividing "
1551 "numbers of the indicated type and returning the result in a structure of the "
1552 "indicated name, in all cases with fields I<quot> and I<rem> of the same type "
1553 "as the function arguments."
1557 #: build/C/man3/div.3:91
1558 msgid "The I<div_t> (etc.) structure."
1562 #: build/C/man3/div.3:100
1564 "The B<div>(), B<ldiv>(), B<lldiv>(), and B<imaxdiv>() functions are "
1569 #: build/C/man3/div.3:107
1571 "SVr4, 4.3BSD, C89. C99. The functions B<lldiv>() and B<imaxdiv>() were "
1576 #: build/C/man3/div.3:107 build/C/man3/frexp.3:122 build/C/man3/matherr.3:280 build/C/man3/remainder.3:213
1582 #: build/C/man3/div.3:109
1587 #: build/C/man3/div.3:112
1589 msgid " div_t q = div(-5, 3);\n"
1593 #: build/C/man3/div.3:115
1594 msgid "the values I<q.quot> and I<q.rem> are -1 and -2, respectively."
1598 #: build/C/man3/div.3:118
1599 msgid "B<abs>(3), B<remainder>(3)"
1603 #: build/C/man3/erf.3:35
1609 #: build/C/man3/erf.3:35 build/C/man3/erfc.3:26
1615 #: build/C/man3/erf.3:38
1616 msgid "erf, erff, erfl, - error function"
1620 #: build/C/man3/erf.3:45
1623 "B<double erf(double >I<x>B<);>\n"
1624 "B<float erff(float >I<x>B<);>\n"
1625 "B<long double erfl(long double >I<x>B<);>\n"
1629 #: build/C/man3/erf.3:56
1634 #: 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
1636 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || "
1637 "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
1641 #: build/C/man3/erf.3:66
1642 msgid "B<erff>(), B<erfl>():"
1646 #: build/C/man3/erf.3:81
1647 msgid "The B<erf>() function returns the error function of I<x>, defined as"
1651 #: build/C/man3/erf.3:81
1653 msgid " erf(x) = 2/sqrt(pi)* integral from 0 to x of exp(-t*t) dt"
1657 #: build/C/man3/erf.3:87
1659 "On success, these functions return the error function of I<x>, a value in "
1660 "the range [-1,\\ 1]."
1664 #. POSIX.1-2001 documents an optional range error (underflow)
1666 #. glibc 2.8 does not do this.
1668 #: build/C/man3/erf.3:100 build/C/man3/tanh.3:98
1669 msgid "If I<x> is positive infinity (negative infinity), +1 (-1) is returned."
1673 #: build/C/man3/erf.3:106
1675 "If I<x> is subnormal, a range error occurs, and the return value is "
1680 #: build/C/man3/erf.3:113
1682 msgid "Range error: result underflow (I<x> is subnormal)"
1685 #. e.g., tgamma(-172.5) on glibc 2.8/x86-32
1690 #: 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:174 build/C/man3/scalb.3:171 build/C/man3/scalbln.3:153 build/C/man3/tgamma.3:150
1691 msgid "An underflow floating-point exception (B<FE_UNDERFLOW>) is raised."
1694 #. FIXME . Is it intentional that these functions do not set errno?
1695 #. sin() and cos() also don't set errno; bugs have been raised for
1697 #. See https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467
1699 #: 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:108 build/C/man3/lround.3:111 build/C/man3/nextafter.3:179 build/C/man3/remquo.3:122 build/C/man3/scalb.3:177 build/C/man3/scalbln.3:158 build/C/man3/sincos.3:74
1700 msgid "These functions do not set I<errno>."
1704 #: build/C/man3/erf.3:134
1705 msgid "The B<erf>(), B<erff>(), and B<erfl>() functions are thread-safe."
1709 #: build/C/man3/erf.3:144
1710 msgid "B<cerf>(3), B<erfc>(3), B<exp>(3)"
1714 #: build/C/man3/erfc.3:26
1720 #: build/C/man3/erfc.3:29
1721 msgid "erfc, erfcf, erfcl - complementary error function"
1725 #: build/C/man3/erfc.3:36
1728 "B<double erfc(double >I<x>B<);>\n"
1729 "B<float erfcf(float >I<x>B<);>\n"
1730 "B<long double erfcl(long double >I<x>B<);>\n"
1734 #: build/C/man3/erfc.3:47
1739 #: build/C/man3/erfc.3:57
1740 msgid "B<erfcf>(), B<erfcl>():"
1744 #: build/C/man3/erfc.3:60
1746 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600|| _ISOC99_SOURCE "
1747 "|| _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
1751 #: build/C/man3/erfc.3:71
1753 "The B<erfc>() function returns the complementary error function of I<x>, "
1754 "that is, 1.0 - erf(x)."
1758 #: build/C/man3/erfc.3:75
1760 "On success, these functions return the complementary error function of I<x>, "
1761 "a value in the range [0,2]."
1765 #: build/C/man3/erfc.3:88
1766 msgid "If I<x> is positive infinity, +0 is returned."
1770 #: build/C/man3/erfc.3:93
1771 msgid "If I<x> is negative infinity, +2 is returned."
1775 #: build/C/man3/erfc.3:96
1777 "If the function result underflows and produces an unrepresentable value, the "
1778 "return value is 0.0."
1781 #. e.g., erfc(27) on x86-32
1783 #: build/C/man3/erfc.3:102
1785 "If the function result underflows but produces a representable (i.e., "
1786 "subnormal) value, that value is returned, and a range error occurs."
1790 #: build/C/man3/erfc.3:109
1792 msgid "Range error: result underflow (result is subnormal)"
1796 #: build/C/man3/erfc.3:130
1797 msgid "The B<erfc>(), B<erfcf>(), and B<erfcl>() functions are thread-safe."
1801 #: build/C/man3/erfc.3:146
1803 "The B<erfc>(), B<erfcf>(), and B<erfcl>() functions are provided to avoid "
1804 "the loss accuracy that would occur for the calculation 1-erf(x) for large "
1805 "values of I<x> (for which the value of erf(x) approaches 1)."
1809 #: build/C/man3/erfc.3:150
1810 msgid "B<cerf>(3), B<erf>(3), B<exp>(3)"
1814 #: build/C/man3/exp.3:36
1820 #: build/C/man3/exp.3:39
1821 msgid "exp, expf, expl - base-e exponential function"
1825 #: build/C/man3/exp.3:44
1827 msgid "B<double exp(double >I<x>B<);>\n"
1831 #: build/C/man3/exp.3:46
1833 msgid "B<float expf(float >I<x>B<);>\n"
1837 #: build/C/man3/exp.3:48
1839 msgid "B<long double expl(long double >I<x>B<);>\n"
1843 #: build/C/man3/exp.3:60
1844 msgid "B<expf>(), B<expl>():"
1848 #: build/C/man3/exp.3:74
1850 "The B<exp>() function returns the value of e (the base of natural "
1851 "logarithms) raised to the power of I<x>."
1855 #: build/C/man3/exp.3:77
1856 msgid "On success, these functions return the exponential value of I<x>."
1860 #: build/C/man3/exp.3:92
1861 msgid "If I<x> is negative infinity, +0 is returned."
1865 #: build/C/man3/exp.3:96 build/C/man3/ldexp.3:96
1866 msgid "If the result underflows, a range error occurs, and zero is returned."
1870 #: 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
1872 msgid "Range error, overflow"
1876 #: build/C/man3/exp.3:120 build/C/man3/ldexp.3:121 build/C/man3/scalb.3:163 build/C/man3/scalbln.3:145
1878 msgid "Range error, underflow"
1882 #: build/C/man3/exp.3:128 build/C/man3/ldexp.3:129 build/C/man3/pow.3:316
1884 "I<errno> is set to B<ERANGE>. An underflow floating-point exception "
1885 "(B<FE_UNDERFLOW>) is raised."
1889 #: build/C/man3/exp.3:140
1890 msgid "B<cbrt>(3), B<cexp>(3), B<exp10>(3), B<exp2>(3), B<sqrt>(3)"
1894 #: build/C/man3/exp10.3:35
1900 #: build/C/man3/exp10.3:35 build/C/man3/ilogb.3:29 build/C/man3/pow.3:35 build/C/man3/tgamma.3:13
1906 #: build/C/man3/exp10.3:38
1907 msgid "exp10, exp10f, exp10l - base-10 exponential function"
1911 #: build/C/man3/exp10.3:41 build/C/man3/fenv.3:309
1913 msgid "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n"
1917 #: build/C/man3/exp10.3:45
1919 msgid "B<double exp10(double >I<x>B<);>\n"
1923 #: build/C/man3/exp10.3:47
1925 msgid "B<float exp10f(float >I<x>B<);>\n"
1929 #: build/C/man3/exp10.3:49
1931 msgid "B<long double exp10l(long double >I<x>B<);>\n"
1935 #: build/C/man3/exp10.3:58
1937 "The B<exp10>() function returns the value of 10 raised to the power of "
1942 #: build/C/man3/exp10.3:61
1943 msgid "On success, these functions return the base-10 exponential value of I<x>."
1947 #: build/C/man3/exp10.3:65 build/C/man3/exp2.3:81
1949 "For various special cases, including the handling of infinity and NaN, as "
1950 "well as overflows and underflows, see B<exp>(3)."
1954 #: build/C/man3/exp10.3:73 build/C/man3/exp2.3:89
1956 "For a discussion of the errors that can occur for these functions, see "
1961 #: build/C/man3/exp10.3:73 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:108 build/C/man3/lround.3:111 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:74 build/C/man3/tgamma.3:158 build/C/man3/trunc.3:73
1967 #: build/C/man3/exp10.3:75 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:110 build/C/man3/lround.3:113 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:76 build/C/man3/tgamma.3:160 build/C/man3/trunc.3:75
1968 msgid "These functions first appeared in glibc in version 2.1."
1972 #: build/C/man3/exp10.3:77
1973 msgid "These functions are GNU extensions."
1976 #. http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787
1978 #: build/C/man3/exp10.3:84
1980 "Prior to version 2.19, the glibc implementation of these functions did not "
1981 "set I<errno> to B<ERANGE> when an underflow error occurred."
1985 #: build/C/man3/exp10.3:90
1986 msgid "B<cbrt>(3), B<exp>(3), B<exp2>(3), B<log10>(3), B<sqrt>(3)"
1990 #: build/C/man3/exp2.3:36
1996 #: build/C/man3/exp2.3:39
1997 msgid "exp2, exp2f, exp2l - base-2 exponential function"
2001 #: build/C/man3/exp2.3:44
2003 msgid "B<double exp2(double >I<x>B<);>\n"
2007 #: build/C/man3/exp2.3:46
2009 msgid "B<float exp2f(float >I<x>B<);>\n"
2013 #: build/C/man3/exp2.3:48
2015 msgid "B<long double exp2l(long double >I<x>B<);>\n"
2019 #: build/C/man3/exp2.3:61
2020 msgid "B<exp2>(), B<exp2f>(), B<exp2l>():"
2024 #: build/C/man3/exp2.3:74
2025 msgid "The B<exp2>() function returns the value of 2 raised to the power of I<x>."
2029 #: build/C/man3/exp2.3:77
2030 msgid "On success, these functions return the base-2 exponential value of I<x>."
2034 #: build/C/man3/exp2.3:103
2035 msgid "B<cbrt>(3), B<cexp2>(3), B<exp>(3), B<exp10>(3), B<sqrt>(3)"
2039 #: build/C/man3/expm1.3:30
2045 #: build/C/man3/expm1.3:33
2046 msgid "expm1, expm1f, expm1l - exponential minus 1"
2050 #: build/C/man3/expm1.3:38
2052 msgid "B<double expm1(double >I<x>B<);>\n"
2056 #: build/C/man3/expm1.3:40
2058 msgid "B<float expm1f(float >I<x>B<);>\n"
2062 #: build/C/man3/expm1.3:42
2064 msgid "B<long double expm1l(long double >I<x>B<);>\n"
2068 #: build/C/man3/expm1.3:53
2073 #: build/C/man3/expm1.3:64
2074 msgid "B<expm1f>(), B<expm1l>():"
2078 #: build/C/man3/expm1.3:75
2079 msgid "I<expm1(x)> returns a value equivalent to"
2083 #: build/C/man3/expm1.3:78
2085 msgid " exp(x) - 1\n"
2089 #: build/C/man3/expm1.3:88
2091 "It is computed in a way that is accurate even if the value of I<x> is near "
2092 "zero\\(ema case where I<exp(x) - 1> would be inaccurate due to subtraction "
2093 "of two numbers that are nearly equal."
2097 #: build/C/man3/expm1.3:91
2098 msgid "On success, these functions return I<exp(x)\\ -\\ 1>."
2102 #: build/C/man3/expm1.3:109
2103 msgid "If I<x> is negative infinity, -1 is returned."
2107 #: build/C/man3/expm1.3:117
2109 "If the result overflows, a range error occurs, and the functions return "
2110 "-B<HUGE_VAL>, -B<HUGE_VALF>, or -B<HUGE_VALL>, respectively."
2114 #. POSIX.1 specifies an optional range error (underflow) if
2115 #. x is subnormal. Glibc does not implement this.
2117 #: build/C/man3/expm1.3:136
2119 "I<errno> is set to B<ERANGE> (but see BUGS). An overflow floating-point "
2120 "exception (B<FE_OVERFLOW>) is raised."
2124 #: build/C/man3/expm1.3:144
2125 msgid "The B<expm1>(), B<expm1f>(), and B<expm1l>() functions are thread-safe."
2129 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778
2131 #: build/C/man3/expm1.3:155
2133 "For some large negative I<x> values (where the function result approaches "
2134 "-1), B<expm1>() raises a bogus underflow floating-point exception."
2138 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814
2139 #. e.g., expm1(1e5) through expm1(1.00199970127e5),
2140 #. but not expm1(1.00199970128e5) and beyond.
2142 #: build/C/man3/expm1.3:166
2144 "For some large positive I<x> values, B<expm1>() raises a bogus invalid "
2145 "floating-point exception in addition to the expected overflow exception, and "
2146 "returns a NaN instead of positive infinity."
2149 #. It looks like the fix was in 2.11, or possibly 2.12.
2150 #. I have no test system for 2.11, but 2.12 passes.
2151 #. From the source (sysdeps/i386/fpu/s_expm1.S) it looks
2152 #. like the changes were in 2.11.
2153 #. http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788
2155 #: build/C/man3/expm1.3:178
2157 "Before version 2.11, the glibc implementation did not set I<errno> to "
2158 "B<ERANGE> when a range error occurred."
2162 #: build/C/man3/expm1.3:182
2163 msgid "B<exp>(3), B<log>(3), B<log1p>(3)"
2167 #: build/C/man3/fabs.3:32
2173 #: build/C/man3/fabs.3:32
2179 #: build/C/man3/fabs.3:35
2180 msgid "fabs, fabsf, fabsl - absolute value of floating-point number"
2184 #: build/C/man3/fabs.3:40
2186 msgid "B<double fabs(double >I<x>B<);>\n"
2190 #: build/C/man3/fabs.3:42
2192 msgid "B<float fabsf(float >I<x>B<);>\n"
2196 #: build/C/man3/fabs.3:44
2198 msgid "B<long double fabsl(long double >I<x>B<);>\n"
2202 #: build/C/man3/fabs.3:56
2203 msgid "B<fabsf>(), B<fabsl>():"
2207 #: build/C/man3/fabs.3:68
2208 msgid "These functions return the absolute value of the floating-point number I<x>."
2212 #: build/C/man3/fabs.3:71
2213 msgid "These functions return the absolute value of I<x>."
2217 #: build/C/man3/fabs.3:79
2218 msgid "If I<x> is -0, +0 is returned."
2222 #: build/C/man3/fabs.3:83
2224 "If I<x> is negative infinity or positive infinity, positive infinity is "
2229 #: build/C/man3/fabs.3:93
2230 msgid "The B<fabs>(), B<fabsf>(), and B<fabsl>() functions are thread-safe."
2234 #: build/C/man3/fabs.3:106
2235 msgid "B<abs>(3), B<cabs>(3), B<ceil>(3), B<floor>(3), B<labs>(3), B<rint>(3)"
2239 #: build/C/man3/fdim.3:9
2245 #: build/C/man3/fdim.3:9
2251 #: build/C/man3/fdim.3:12
2252 msgid "fdim, fdimf, fdiml - positive difference"
2256 #: 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
2257 msgid "B<#include E<lt>math.hE<gt>>"
2261 #: build/C/man3/fdim.3:16
2262 msgid "B<double fdim(double >I<x>B<, double >I<y>B<);>"
2266 #: build/C/man3/fdim.3:18
2267 msgid "B<float fdimf(float >I<x>B<, float >I<y>B<);>"
2271 #: build/C/man3/fdim.3:20
2272 msgid "B<long double fdiml(long double >I<x>B<, long double >I<y>B<);>"
2276 #: build/C/man3/fdim.3:31
2277 msgid "B<fdimf>(), B<fdiml>():"
2281 #: build/C/man3/fdim.3:42
2283 "These functions return the positive difference, max(I<x>-I<y>,0), between "
2288 #: build/C/man3/fdim.3:44
2289 msgid "On success, these functions return the positive difference."
2293 #: build/C/man3/fdim.3:50 build/C/man3/fma.3:63 build/C/man3/fmod.3:102 build/C/man3/nextafter.3:127 build/C/man3/remainder.3:130 build/C/man3/remquo.3:83
2294 msgid "If I<x> or I<y> is a NaN, a NaN is returned."
2298 #: build/C/man3/fdim.3:59 build/C/man3/hypot.3:122
2300 "If the result overflows, a range error occurs, and the functions return "
2301 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively."
2304 #. Unable to test this case, since the best approximation of
2305 #. pi/2 in double precision only yields a tan() value of 1.633e16.
2310 #: build/C/man3/fdim.3:74 build/C/man3/fma.3:141 build/C/man3/nextafter.3:165 build/C/man3/scalb.3:163 build/C/man3/scalbln.3:145 build/C/man3/tan.3:133
2311 msgid "An overflow floating-point exception (B<FE_OVERFLOW>) is raised."
2315 #: build/C/man3/fdim.3:89
2316 msgid "The B<fdim>(), B<fdimf>(), and B<fdiml>() functions are thread-safe."
2320 #: build/C/man3/fdim.3:93 build/C/man3/fmin.3:70
2325 #: build/C/man3/fenv.3:27
2331 #: build/C/man3/fenv.3:27
2337 #: build/C/man3/fenv.3:27 build/C/man7/math_error.7:26 build/C/man3/matherr.3:27
2343 #: build/C/man3/fenv.3:33
2345 "feclearexcept, fegetexceptflag, feraiseexcept, fesetexceptflag, "
2346 "fetestexcept, fegetenv, fegetround, feholdexcept, fesetround, fesetenv, "
2347 "feupdateenv, feenableexcept, fedisableexcept, fegetexcept - floating-point "
2348 "rounding and exception handling"
2352 #: build/C/man3/fenv.3:36 build/C/man3/fenv.3:311
2354 msgid "B<#include E<lt>fenv.hE<gt>>\n"
2358 #: build/C/man3/fenv.3:38
2360 msgid "B<int feclearexcept(int >I<excepts>B<);>\n"
2364 #: build/C/man3/fenv.3:40
2366 msgid "B<int fegetexceptflag(fexcept_t *>I<flagp>B<, int >I<excepts>B<);>\n"
2370 #: build/C/man3/fenv.3:42
2372 msgid "B<int feraiseexcept(int >I<excepts>B<);>\n"
2376 #: build/C/man3/fenv.3:44
2378 msgid "B<int fesetexceptflag(const fexcept_t *>I<flagp>B<, int >I<excepts>B<);>\n"
2382 #: build/C/man3/fenv.3:46
2384 msgid "B<int fetestexcept(int >I<excepts>B<);>\n"
2388 #: build/C/man3/fenv.3:48
2390 msgid "B<int fegetround(void);>\n"
2394 #: build/C/man3/fenv.3:50
2396 msgid "B<int fesetround(int >I<rounding_mode>B<);>\n"
2400 #: build/C/man3/fenv.3:52
2402 msgid "B<int fegetenv(fenv_t *>I<envp>B<);>\n"
2406 #: build/C/man3/fenv.3:54
2408 msgid "B<int feholdexcept(fenv_t *>I<envp>B<);>\n"
2412 #: build/C/man3/fenv.3:56
2414 msgid "B<int fesetenv(const fenv_t *>I<envp>B<);>\n"
2418 #: build/C/man3/fenv.3:58
2420 msgid "B<int feupdateenv(const fenv_t *>I<envp>B<);>\n"
2424 #: build/C/man3/fenv.3:64
2426 "These eleven functions were defined in C99, and describe the handling of "
2427 "floating-point rounding and exceptions (overflow, zero-divide, etc.)."
2431 #: build/C/man3/fenv.3:64
2437 #: build/C/man3/fenv.3:69
2439 "The I<divide-by-zero> exception occurs when an operation on finite numbers "
2440 "produces infinity as exact answer."
2444 #: build/C/man3/fenv.3:75
2446 "The I<overflow> exception occurs when a result has to be represented as a "
2447 "floating-point number, but has (much) larger absolute value than the largest "
2448 "(finite) floating-point number that is representable."
2452 #: build/C/man3/fenv.3:82
2454 "The I<underflow> exception occurs when a result has to be represented as a "
2455 "floating-point number, but has smaller absolute value than the smallest "
2456 "positive normalized floating-point number (and would lose much accuracy when "
2457 "represented as a denormalized number)."
2461 #: build/C/man3/fenv.3:92
2463 "The I<inexact> exception occurs when the rounded result of an operation is "
2464 "not equal to the infinite precision result. It may occur whenever "
2465 "I<overflow> or I<underflow> occurs."
2469 #: build/C/man3/fenv.3:97
2471 "The I<invalid> exception occurs when there is no well-defined result for an "
2472 "operation, as for 0/0 or infinity - infinity or sqrt(-1)."
2476 #: build/C/man3/fenv.3:97
2478 msgid "Exception handling"
2482 #: build/C/man3/fenv.3:103
2484 "Exceptions are represented in two ways: as a single bit (exception "
2485 "present/absent), and these bits correspond in some implementation-defined "
2486 "way with bit positions in an integer, and also as an opaque structure that "
2487 "may contain more information about the exception (perhaps the code address "
2488 "where it occurred)."
2492 #: build/C/man3/fenv.3:119
2494 "Each of the macros B<FE_DIVBYZERO>, B<FE_INEXACT>, B<FE_INVALID>, "
2495 "B<FE_OVERFLOW>, B<FE_UNDERFLOW> is defined when the implementation supports "
2496 "handling of the corresponding exception, and if so then defines the "
2497 "corresponding bit(s), so that one can call exception handling functions, for "
2498 "example, using the integer argument B<FE_OVERFLOW>|B<FE_UNDERFLOW>. Other "
2499 "exceptions may be supported. The macro B<FE_ALL_EXCEPT> is the bitwise OR "
2500 "of all bits corresponding to supported exceptions."
2504 #: build/C/man3/fenv.3:124
2506 "The B<feclearexcept>() function clears the supported exceptions represented "
2507 "by the bits in its argument."
2511 #: build/C/man3/fenv.3:132
2513 "The B<fegetexceptflag>() function stores a representation of the state of "
2514 "the exception flags represented by the argument I<excepts> in the opaque "
2519 #: build/C/man3/fenv.3:137
2521 "The B<feraiseexcept>() function raises the supported exceptions represented "
2522 "by the bits in I<excepts>."
2526 #: build/C/man3/fenv.3:148
2528 "The B<fesetexceptflag>() function sets the complete status for the "
2529 "exceptions represented by I<excepts> to the value I<*flagp>. This value "
2530 "must have been obtained by an earlier call of B<fegetexceptflag>() with a "
2531 "last argument that contained all bits in I<excepts>."
2535 #: build/C/man3/fenv.3:155
2537 "The B<fetestexcept>() function returns a word in which the bits are set "
2538 "that were set in the argument I<excepts> and for which the corresponding "
2539 "exception is currently set."
2543 #: build/C/man3/fenv.3:155
2545 msgid "Rounding mode"
2549 #: build/C/man3/fenv.3:163
2551 "The rounding mode determines how the result of floating-point operations is "
2552 "treated when the result cannot be exactly represented in the significand. "
2553 "Various rounding modes may be provided: round to nearest (the default), "
2554 "round up (toward positive infinity), round down (toward negative infinity), "
2555 "and round toward zero."
2559 #: build/C/man3/fenv.3:172
2561 "Each of the macros B<FE_TONEAREST>, B<FE_UPWARD>, B<FE_DOWNWARD>, and "
2562 "B<FE_TOWARDZERO> is defined when the implementation supports getting and "
2563 "setting the corresponding rounding direction."
2567 #: build/C/man3/fenv.3:177
2569 "The B<fegetround>() function returns the macro corresponding to the current "
2574 #: build/C/man3/fenv.3:182
2576 "The B<fesetround>() function sets the rounding mode as specified by its "
2577 "argument and returns zero when it was successful."
2581 #: build/C/man3/fenv.3:190
2583 "C99 and POSIX.1-2008 specify an identifier, B<FLT_ROUNDS>, defined in "
2584 "I<E<lt>float.hE<gt>>, which indicates the implementation-defined rounding "
2585 "behavior for floating-point addition. This identifier has one of the "
2590 #: build/C/man3/fenv.3:190
2596 #: build/C/man3/fenv.3:192
2597 msgid "The rounding mode is not determinable."
2601 #: build/C/man3/fenv.3:192
2607 #: build/C/man3/fenv.3:194
2608 msgid "Rounding is toward 0."
2612 #: build/C/man3/fenv.3:194
2618 #: build/C/man3/fenv.3:196
2619 msgid "Rounding is toward nearest number."
2623 #: build/C/man3/fenv.3:196
2629 #: build/C/man3/fenv.3:198
2630 msgid "Rounding is toward positive infinity."
2634 #: build/C/man3/fenv.3:198
2640 #: build/C/man3/fenv.3:200
2641 msgid "Rounding is toward negative infinity."
2645 #: build/C/man3/fenv.3:202
2646 msgid "Other values represent machine-dependent, nonstandard rounding modes."
2650 #: build/C/man3/fenv.3:208
2652 "The value of B<FLT_ROUNDS> should reflect the current rounding mode as set "
2653 "by B<fesetround>() (but see BUGS)."
2657 #: build/C/man3/fenv.3:208
2659 msgid "Floating-point environment"
2663 #: build/C/man3/fenv.3:220
2665 "The entire floating-point environment, including control modes and status "
2666 "flags, can be handled as one opaque object, of type I<fenv_t>. The default "
2667 "environment is denoted by B<FE_DFL_ENV> (of type I<const fenv_t\\ *>). This "
2668 "is the environment setup at program start and it is defined by ISO C to have "
2669 "round to nearest, all exceptions cleared and a nonstop (continue on "
2674 #: build/C/man3/fenv.3:225
2676 "The B<fegetenv>() function saves the current floating-point environment in "
2677 "the object I<*envp>."
2681 #: build/C/man3/fenv.3:232
2683 "The B<feholdexcept>() function does the same, then clears all exception "
2684 "flags, and sets a nonstop (continue on exceptions) mode, if available. It "
2685 "returns zero when successful."
2689 #: build/C/man3/fenv.3:245
2691 "The B<fesetenv>() function restores the floating-point environment from the "
2692 "object I<*envp>. This object must be known to be valid, for example, the "
2693 "result of a call to B<fegetenv>() or B<feholdexcept>() or equal to "
2694 "B<FE_DFL_ENV>. This call does not raise exceptions."
2698 #: build/C/man3/fenv.3:258
2700 "The B<feupdateenv>() function installs the floating-point environment "
2701 "represented by the object I<*envp>, except that currently raised exceptions "
2702 "are not cleared. After calling this function, the raised exceptions will be "
2703 "a bitwise OR of those previously set with those in I<*envp>. As before, the "
2704 "object I<*envp> must be known to be valid."
2707 #. Earlier seven of these functions were listed as returning void.
2708 #. This was corrected in Corrigendum 1 (ISO/IEC 9899:1999/Cor.1:2001(E))
2709 #. of the C99 Standard.
2711 #: build/C/man3/fenv.3:263
2712 msgid "These functions return zero on success and nonzero if an error occurred."
2716 #: build/C/man3/fenv.3:284
2718 "The B<feclearexcept>(), B<fegetexceptflag>(), B<fegetexceptflag>(), "
2719 "B<fesetexceptflag>(), B<fetestexcept>(), B<fegetround>(), B<fesetround>(), "
2720 "B<fegetenv>(), B<feholdexcept>(), B<fesetenv>(), B<feupdateenv>(), "
2721 "B<feenableexcept>(), B<fedisableexcept>(), and B<fegetexcept>() functions "
2726 #: build/C/man3/fenv.3:286
2727 msgid "IEC 60559 (IEC 559:1989), ANSI/IEEE 854, C99, POSIX.1-2001."
2731 #: build/C/man3/fenv.3:287
2737 #: build/C/man3/fenv.3:306
2739 "If possible, the GNU C Library defines a macro B<FE_NOMASK_ENV> which "
2740 "represents an environment where every exception raised causes a trap to "
2741 "occur. You can test for this macro using B<#ifdef>. It is defined only if "
2742 "B<_GNU_SOURCE> is defined. The C99 standard does not define a way to set "
2743 "individual bits in the floating-point mask, for example, to trap on specific "
2744 "flags. Since version 2.2, glibc supports the functions B<feenableexcept>() "
2745 "and B<fedisableexcept>() to set individual floating-point traps, and "
2746 "B<fegetexcept>() to query the state."
2750 #: build/C/man3/fenv.3:313
2752 msgid "B<int feenableexcept(int >I<excepts>B<);>\n"
2756 #: build/C/man3/fenv.3:315
2758 msgid "B<int fedisableexcept(int >I<excepts>B<);>\n"
2762 #: build/C/man3/fenv.3:317
2764 msgid "B<int fegetexcept(void);>\n"
2768 #: build/C/man3/fenv.3:331
2770 "The B<feenableexcept>() and B<fedisableexcept>() functions enable "
2771 "(disable) traps for each of the exceptions represented by I<excepts> and "
2772 "return the previous set of enabled exceptions when successful, and -1 "
2773 "otherwise. The B<fegetexcept>() function returns the set of all currently "
2774 "enabled exceptions."
2777 #. Aug 08, glibc 2.8
2778 #. See http://gcc.gnu.org/ml/gcc/2002-02/msg01535.html
2780 #: build/C/man3/fenv.3:342
2782 "C99 specifies that the value of B<FLT_ROUNDS> should reflect changes to the "
2783 "current rounding mode, as set by B<fesetround>(). Currently, this does not "
2784 "occur: B<FLT_ROUNDS> always has the value 1."
2788 #: build/C/man3/fenv.3:344
2789 msgid "B<math_error>(7)"
2793 #: build/C/man3/finite.3:25
2799 #: build/C/man3/finite.3:25
2805 #: build/C/man3/finite.3:29
2807 "finite, finitef, finitel, isinf, isinff, isinfl, isnan, isnanf, isnanl - BSD "
2808 "floating-point classification functions"
2812 #: build/C/man3/finite.3:34
2814 msgid "B<int finite(double >I<x>B<);>\n"
2818 #: build/C/man3/finite.3:36
2820 msgid "B<int finitef(float >I<x>B<);>\n"
2824 #: build/C/man3/finite.3:38
2826 msgid "B<int finitel(long double >I<x>B<);>\n"
2830 #: build/C/man3/finite.3:40
2832 msgid "B<int isinf(double >I<x>B<);>\n"
2836 #: build/C/man3/finite.3:42
2838 msgid "B<int isinff(float >I<x>B<);>\n"
2842 #: build/C/man3/finite.3:44
2844 msgid "B<int isinfl(long double >I<x>B<);>\n"
2848 #: build/C/man3/finite.3:46
2850 msgid "B<int isnan(double >I<x>B<);>\n"
2854 #: build/C/man3/finite.3:48
2856 msgid "B<int isnanf(float >I<x>B<);>\n"
2860 #: build/C/man3/finite.3:50
2862 msgid "B<int isnanl(long double >I<x>B<);>\n"
2866 #: build/C/man3/finite.3:61
2867 msgid "B<finite>(), B<finitef>(), B<finitel>():"
2871 #: build/C/man3/finite.3:63 build/C/man3/finite.3:76 build/C/man3/lgamma.3:65
2872 msgid "_BSD_SOURCE || _SVID_SOURCE"
2876 #: build/C/man3/finite.3:65 build/C/man3/fpclassify.3:58
2881 #: build/C/man3/finite.3:67
2883 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
2888 #: build/C/man3/finite.3:74
2889 msgid "B<isinff>(), B<isinfl>():"
2893 #: build/C/man3/finite.3:78 build/C/man3/fpclassify.3:50
2898 #: build/C/man3/finite.3:80
2899 msgid "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE;"
2903 #: build/C/man3/finite.3:86
2904 msgid "B<isnanf>(), B<isnanl>():"
2908 #: build/C/man3/finite.3:88 build/C/man3/gamma.3:38 build/C/man3/scalb.3:58
2909 msgid "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600"
2913 #: build/C/man3/finite.3:100
2915 "The B<finite>(), B<finitef>(), and B<finitel>() functions return a nonzero "
2916 "value if I<x> is neither infinite nor a \"not-a-number\" (NaN) value, and 0 "
2921 #: build/C/man3/finite.3:110
2923 "The B<isnan>(), B<isnanf>(), and B<isnanl>() functions return a nonzero "
2924 "value if I<x> is a NaN value, and 0 otherwise."
2928 #: build/C/man3/finite.3:121
2930 "The B<isinf>(), B<isinff>(), and B<isinfl>() functions return 1 if I<x> is "
2931 "positive infinity, -1 if I<x> is negative infinity, and 0 otherwise."
2935 #: build/C/man3/finite.3:135
2937 "The B<finite>(), B<finitef>(), B<finitel>(), B<isinf>(), B<isinff>(), "
2938 "B<isinfl>(), B<isnan>(), B<isnanf>(), and B<isnanl>() functions are "
2943 #. finite* not on HP-UX; they exist on Tru64.
2947 #. function occurs in 4.3BSD.
2948 #. see IEEE.3 in the 4.3BSD manual
2950 #: build/C/man3/finite.3:155
2952 "Note that these functions are obsolete. C99 defines macros B<isfinite>(), "
2953 "B<isinf>(), and B<isnan>() (for all types) replacing them. Further note "
2954 "that the C99 B<isinf>() has weaker guarantees on the return value. See "
2959 #: build/C/man3/finite.3:157
2960 msgid "B<fpclassify>(3)"
2964 #: build/C/man3/floor.3:27
2970 #: build/C/man3/floor.3:27
2976 #: build/C/man3/floor.3:30
2977 msgid "floor, floorf, floorl - largest integral value not greater than argument"
2981 #: build/C/man3/floor.3:35
2983 msgid "B<double floor(double >I<x>B<);>\n"
2987 #: build/C/man3/floor.3:37
2989 msgid "B<float floorf(float >I<x>B<);>\n"
2993 #: build/C/man3/floor.3:39
2995 msgid "B<long double floorl(long double >I<x>B<);>\n"
2999 #: build/C/man3/floor.3:51
3000 msgid "B<floorf>(), B<floorl>():"
3004 #: build/C/man3/floor.3:62
3006 "These functions return the largest integral value that is not greater than "
3011 #: build/C/man3/floor.3:68
3012 msgid "For example, I<floor(0.5)> is 0.0, and I<floor(-0.5)> is -1.0."
3016 #: build/C/man3/floor.3:71
3017 msgid "These functions return the floor of I<x>."
3021 #: build/C/man3/floor.3:77
3022 msgid "If I<x> is integral, +0, -0, NaN, or an infinity, I<x> itself is returned."
3026 #: build/C/man3/floor.3:88
3027 msgid "The B<floor>(), B<floorf>(), and B<floorl>() functions are thread-safe."
3031 #: build/C/man3/floor.3:117
3033 "B<ceil>(3), B<lrint>(3), B<nearbyint>(3), B<rint>(3), B<round>(3), "
3038 #: build/C/man3/fma.3:12
3044 #: build/C/man3/fma.3:12 build/C/man3/fmax.3:9 build/C/man3/fmin.3:9
3050 #: build/C/man3/fma.3:15
3051 msgid "fma, fmaf, fmal - floating-point multiply and add"
3055 #: build/C/man3/fma.3:20
3057 msgid "B<double fma(double >I<x>B<, double >I<y>B<, double >I<z>B<);>\n"
3061 #: build/C/man3/fma.3:22
3063 msgid "B<float fmaf(float >I<x>B<, float >I<y>B<, float >I<z>B<);>\n"
3067 #: build/C/man3/fma.3:24
3070 "B<long double fmal(long double >I<x>B<, long double >I<y>B<, long double "
3075 #: build/C/man3/fma.3:37
3076 msgid "B<fma>(), B<fmaf>(), B<fmal>():"
3080 #: build/C/man3/fma.3:53
3082 "The B<fma>() function computes I<x> * I<y> + I<z>. The result is rounded "
3083 "as one ternary operation according to the current rounding mode (see "
3088 #: build/C/man3/fma.3:57
3090 "These functions return the value of I<x> * I<y> + I<z>, rounded as one "
3091 "ternary operation."
3095 #: build/C/man3/fma.3:73
3097 "If I<x> times I<y> is an exact infinity, and I<z> is an infinity with the "
3098 "opposite sign, a domain error occurs, and a NaN is returned."
3101 #. POSIX.1-2008 allows some possible differences for the following two
3102 #. domain error cases, but on Linux they are treated the same (AFAICS).
3103 #. Nevertheless, we'll mirror POSIX.1 and describe the two cases
3105 #. POSIX.1 says that a NaN or an implementation-defined value shall
3106 #. be returned for this case.
3108 #: build/C/man3/fma.3:89
3110 "If one of I<x> or I<y> is an infinity, the other is 0, and I<z> is not a "
3111 "NaN, a domain error occurs, and a NaN is returned."
3114 #. POSIX.1 makes the domain error optional for this case.
3116 #: build/C/man3/fma.3:100
3118 "If one of I<x> or I<y> is an infinity, and the other is 0, and I<z> is a "
3119 "NaN, a domain error occurs, and a NaN is returned."
3123 #: build/C/man3/fma.3:109
3125 "If I<x> times I<y> is not an infinity times zero (or vice versa), and I<z> "
3126 "is a NaN, a NaN is returned."
3130 #: build/C/man3/fma.3:113
3132 "If the result overflows, a range error occurs, and an infinity with the "
3133 "correct sign is returned."
3137 #: build/C/man3/fma.3:117
3138 msgid "If the result underflows, a range error occurs, and a signed 0 is returned."
3142 #: build/C/man3/fma.3:124
3145 "Domain error: I<x> * I<y> + I<z>, or I<x> * I<y> is invalid and I<z> is not "
3153 #: build/C/man3/fma.3:133 build/C/man3/log1p.3:128 build/C/man3/lrint.3:103 build/C/man3/lround.3:106 build/C/man3/remainder.3:165 build/C/man3/remquo.3:117 build/C/man3/scalb.3:155 build/C/man3/sincos.3:67
3154 msgid "An invalid floating-point exception (B<FE_INVALID>) is raised."
3158 #: build/C/man3/fma.3:141 build/C/man3/hypot.3:143 build/C/man3/tgamma.3:141 build/C/man3/y0.3:201
3160 msgid "Range error: result underflow"
3164 #: build/C/man3/fma.3:164
3165 msgid "The B<fma>(), B<fmaf>(), and B<fmal>() functions are thread-safe."
3169 #: build/C/man3/fma.3:169
3170 msgid "B<remainder>(3), B<remquo>(3)"
3174 #: build/C/man3/fmax.3:9
3180 #: build/C/man3/fmax.3:12
3181 msgid "fmax, fmaxf, fmaxl - determine maximum of two floating-point numbers"
3185 #: build/C/man3/fmax.3:16
3186 msgid "B<double fmax(double >I<x>B<, double >I<y>B<);>"
3190 #: build/C/man3/fmax.3:18
3191 msgid "B<float fmaxf(float >I<x>B<, float >I<y>B<);>"
3195 #: build/C/man3/fmax.3:20
3196 msgid "B<long double fmaxl(long double >I<x>B<, long double >I<y>B<);>"
3200 #: build/C/man3/fmax.3:32
3201 msgid "B<fmax>(), B<fmaxf>(), B<fmaxl>():"
3205 #: build/C/man3/fmax.3:45
3206 msgid "These functions return the larger value of I<x> and I<y>."
3210 #: build/C/man3/fmax.3:50
3211 msgid "These functions return the maximum of I<x> and I<y>."
3215 #: build/C/man3/fmax.3:52 build/C/man3/fmin.3:52
3216 msgid "If one argument is a NaN, the other argument is returned."
3220 #: build/C/man3/fmax.3:54 build/C/man3/fmin.3:54
3221 msgid "If both arguments are NaN, a NaN is returned."
3225 #: build/C/man3/fmax.3:66
3226 msgid "The B<fmax>(), B<fmaxf>(), and B<fmaxl>() functions are thread-safe."
3230 #: build/C/man3/fmax.3:70
3235 #: build/C/man3/fmin.3:9
3241 #: build/C/man3/fmin.3:12
3242 msgid "fmin, fminf, fminl - determine minimum of two floating-point numbers"
3246 #: build/C/man3/fmin.3:16
3247 msgid "B<double fmin(double >I<x>B<, double >I<y>B<);>"
3251 #: build/C/man3/fmin.3:18
3252 msgid "B<float fminf(float >I<x>B<, float >I<y>B<);>"
3256 #: build/C/man3/fmin.3:20
3257 msgid "B<long double fminl(long double >I<x>B<, long double >I<y>B<);>"
3261 #: build/C/man3/fmin.3:32
3262 msgid "B<fmin>(), B<fminf>(), B<fminl>():"
3266 #: build/C/man3/fmin.3:45
3267 msgid "These functions return the lesser value of I<x> and I<y>."
3271 #: build/C/man3/fmin.3:50
3272 msgid "These functions return the minimum of I<x> and I<y>."
3276 #: build/C/man3/fmin.3:66
3277 msgid "The B<fmin>(), B<fminf>(), and B<fminl>() functions are thread-safe."
3281 #: build/C/man3/fmod.3:35
3287 #: build/C/man3/fmod.3:35
3293 #: build/C/man3/fmod.3:38
3294 msgid "fmod, fmodf, fmodl - floating-point remainder function"
3298 #: build/C/man3/fmod.3:43
3300 msgid "B<double fmod(double >I<x>B<, double >I<y>B<);>\n"
3304 #: build/C/man3/fmod.3:45
3306 msgid "B<float fmodf(float >I<x>B<, float >I<y>B<);>\n"
3310 #: build/C/man3/fmod.3:47
3312 msgid "B<long double fmodl(long double >I<x>B<, long double >I<y>B<);>\n"
3316 #: build/C/man3/fmod.3:59
3317 msgid "B<fmodf>(), B<fmodl>():"
3321 #: build/C/man3/fmod.3:87
3323 "The B<fmod>() function computes the floating-point remainder of dividing "
3324 "I<x> by I<y>. The return value is I<x> - I<n> * I<y>, where I<n> is the "
3325 "quotient of I<x> / I<y>, rounded toward zero to an integer."
3329 #: build/C/man3/fmod.3:96
3331 "On success, these functions return the value I<x>\\ -\\ I<n>*I<y>, for some "
3332 "integer I<n>, such that the returned value has the same sign as I<x> and a "
3333 "magnitude less than the magnitude of I<y>."
3337 #: build/C/man3/fmod.3:108
3338 msgid "If I<x> is an infinity, a domain error occurs, and a NaN is returned."
3342 #: build/C/man3/fmod.3:114
3343 msgid "If I<y> is zero, a domain error occurs, and a NaN is returned."
3347 #: build/C/man3/fmod.3:120
3348 msgid "If I<x> is +0 (-0), and I<y> is not zero, +0 (-0) is returned."
3351 #. [XXX see bug above] and \fIx\fP is not a NaN
3353 #: build/C/man3/fmod.3:136 build/C/man3/remainder.3:172
3355 msgid "Domain error: I<y> is zero"
3358 #. http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784
3360 #: build/C/man3/fmod.3:160
3362 "Before version 2.10, the glibc implementation did not set I<errno> to "
3363 "B<EDOM> when a domain error occurred for an infinite I<x>."
3367 #: build/C/man3/fmod.3:162
3368 msgid "B<remainder>(3)"
3372 #: build/C/man3/fpclassify.3:10
3378 #: build/C/man3/fpclassify.3:10 build/C/man3/frexp.3:33
3384 #: build/C/man3/fpclassify.3:14
3386 "fpclassify, isfinite, isnormal, isnan, isinf - floating-point classification "
3391 #: build/C/man3/fpclassify.3:19
3393 msgid "B<int fpclassify(>I<x>B<);>\n"
3397 #: build/C/man3/fpclassify.3:21
3399 msgid "B<int isfinite(>I<x>B<);>\n"
3403 #: build/C/man3/fpclassify.3:23
3405 msgid "B<int isnormal(>I<x>B<);>\n"
3409 #: build/C/man3/fpclassify.3:25
3411 msgid "B<int isnan(>I<x>B<);>\n"
3415 #: build/C/man3/fpclassify.3:27
3417 msgid "B<int isinf(>I<x>B<);>\n"
3421 #: build/C/man3/fpclassify.3:42
3422 msgid "B<fpclassify>(), B<isfinite>(), B<isnormal>():"
3426 #: build/C/man3/fpclassify.3:76
3428 "Floating point numbers can have special values, such as infinite or NaN. "
3429 "With the macro B<fpclassify(>I<x>B<)> you can find out what type I<x> is. "
3430 "The macro takes any floating-point expression as argument. The result is "
3431 "one of the following values:"
3435 #: build/C/man3/fpclassify.3:76
3441 #: build/C/man3/fpclassify.3:80
3442 msgid "I<x> is \"Not a Number\"."
3446 #: build/C/man3/fpclassify.3:80
3448 msgid "B<FP_INFINITE>"
3452 #: build/C/man3/fpclassify.3:84
3453 msgid "I<x> is either positive infinity or negative infinity."
3457 #: build/C/man3/fpclassify.3:84
3463 #: build/C/man3/fpclassify.3:88
3464 msgid "I<x> is zero."
3468 #: build/C/man3/fpclassify.3:88
3470 msgid "B<FP_SUBNORMAL>"
3474 #: build/C/man3/fpclassify.3:92
3475 msgid "I<x> is too small to be represented in normalized format."
3479 #: build/C/man3/fpclassify.3:92
3481 msgid "B<FP_NORMAL>"
3485 #: build/C/man3/fpclassify.3:96
3487 "if nothing of the above is correct then it must be a normal floating-point "
3492 #: build/C/man3/fpclassify.3:98
3493 msgid "The other macros provide a short answer to some standard questions."
3497 #: build/C/man3/fpclassify.3:98
3499 msgid "B<isfinite(>I<x>B<)>"
3503 #: build/C/man3/fpclassify.3:101
3504 msgid "returns a nonzero value if"
3508 #: build/C/man3/fpclassify.3:103
3509 msgid "(fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)"
3513 #: build/C/man3/fpclassify.3:103
3515 msgid "B<isnormal(>I<x>B<)>"
3519 #: build/C/man3/fpclassify.3:107
3520 msgid "returns a nonzero value if (fpclassify(x) == FP_NORMAL)"
3524 #: build/C/man3/fpclassify.3:107
3526 msgid "B<isnan(>I<x>B<)>"
3530 #: build/C/man3/fpclassify.3:111
3531 msgid "returns a nonzero value if (fpclassify(x) == FP_NAN)"
3535 #: build/C/man3/fpclassify.3:111
3537 msgid "B<isinf(>I<x>B<)>"
3541 #: build/C/man3/fpclassify.3:118
3542 msgid "returns 1 if I<x> is positive infinity, and -1 if I<x> is negative infinity."
3546 #: build/C/man3/fpclassify.3:128
3548 "The B<fpclassify>(), B<isfinite>(), B<isnormal>(), B<isnan>(), and "
3549 "B<isinf>() macros are thread-safe."
3553 #: build/C/man3/fpclassify.3:130
3554 msgid "C99, POSIX.1."
3558 #: build/C/man3/fpclassify.3:135
3560 "For B<isinf>(), the standards merely say that the return value is nonzero if "
3561 "and only if the argument has an infinite value."
3565 #: build/C/man3/fpclassify.3:142
3567 "In glibc 2.01 and earlier, B<isinf>() returns a nonzero value (actually: 1) "
3568 "if I<x> is positive infinity or negative infinity. (This is all that C99 "
3573 #: build/C/man3/fpclassify.3:147
3574 msgid "B<finite>(3), B<INFINITY>(3), B<isgreater>(3), B<signbit>(3)"
3578 #: build/C/man3/frexp.3:33
3584 #: build/C/man3/frexp.3:37
3586 "frexp, frexpf, frexpl - convert floating-point number to fractional and "
3587 "integral components"
3591 #: build/C/man3/frexp.3:42
3593 msgid "B<double frexp(double >I<x>B<, int *>I<exp>B<);>\n"
3597 #: build/C/man3/frexp.3:44
3599 msgid "B<float frexpf(float >I<x>B<, int *>I<exp>B<);>\n"
3603 #: build/C/man3/frexp.3:46
3605 msgid "B<long double frexpl(long double >I<x>B<, int *>I<exp>B<);>\n"
3609 #: build/C/man3/frexp.3:58
3610 msgid "B<frexpf>(), B<frexpl>():"
3614 #: build/C/man3/frexp.3:74
3616 "The B<frexp>() function is used to split the number I<x> into a normalized "
3617 "fraction and an exponent which is stored in I<exp>."
3621 #: build/C/man3/frexp.3:86
3623 "The B<frexp>() function returns the normalized fraction. If the argument "
3624 "I<x> is not zero, the normalized fraction is I<x> times a power of two, and "
3625 "its absolute value is always in the range 1/2 (inclusive) to 1 (exclusive), "
3630 #: build/C/man3/frexp.3:92
3632 "If I<x> is zero, then the normalized fraction is zero and zero is stored in "
3637 #: build/C/man3/frexp.3:99
3639 "If I<x> is a NaN, a NaN is returned, and the value of I<*exp> is "
3644 #: build/C/man3/frexp.3:106
3646 "If I<x> is positive infinity (negative infinity), positive infinity "
3647 "(negative infinity) is returned, and the value of I<*exp> is unspecified."
3651 #: build/C/man3/frexp.3:116
3652 msgid "The B<frexp>(), B<frexpf>(), and B<frexpl>() functions are thread-safe."
3656 #: build/C/man3/frexp.3:124
3657 msgid "The program below produces results such as the following:"
3661 #: build/C/man3/frexp.3:131
3664 "$B< ./a.out 2560>\n"
3665 "frexp(2560, &e) = 0.625: 0.625 * 2^12 = 2560\n"
3667 "frexp(-4, &e) = -0.5: -0.5 * 2^3 = -4\n"
3671 #: build/C/man3/frexp.3:133 build/C/man3/matherr.3:365
3673 msgid "Program source"
3677 #: build/C/man3/frexp.3:140
3680 "#include E<lt>math.hE<gt>\n"
3681 "#include E<lt>float.hE<gt>\n"
3682 "#include E<lt>stdio.hE<gt>\n"
3683 "#include E<lt>stdlib.hE<gt>\n"
3687 #: build/C/man3/frexp.3:146
3691 "main(int argc, char *argv[])\n"
3698 #: build/C/man3/frexp.3:149
3701 " x = strtod(argv[1], NULL);\n"
3702 " r = frexp(x, &exp);\n"
3706 #: build/C/man3/frexp.3:154
3709 " printf(\"frexp(%g, &e) = %g: %g * %d^%d = %g\\en\",\n"
3710 " x, r, r, FLT_RADIX, exp, x);\n"
3711 " exit(EXIT_SUCCESS);\n"
3716 #: build/C/man3/frexp.3:158
3717 msgid "B<ldexp>(3), B<modf>(3)"
3721 #: build/C/man3/gamma.3:9
3727 #: build/C/man3/gamma.3:9
3733 #: build/C/man3/gamma.3:12
3734 msgid "gamma, gammaf, gammal - (logarithm of the) gamma function"
3738 #: build/C/man3/gamma.3:16
3739 msgid "B<double gamma(double >I<x>B<);>"
3743 #: build/C/man3/gamma.3:18
3744 msgid "B<float gammaf(float >I<x>B<);>"
3748 #: build/C/man3/gamma.3:20
3749 msgid "B<long double gammal(long double >I<x>B<);>"
3753 #: build/C/man3/gamma.3:30
3758 #: build/C/man3/gamma.3:32 build/C/man3/lgamma.3:69
3759 msgid "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE"
3763 #: build/C/man3/gamma.3:35
3764 msgid "B<gammaf>(), B<gammal>():"
3768 #: build/C/man3/gamma.3:46
3770 "These functions are deprecated: instead, use either the B<tgamma>(3) or the "
3771 "B<lgamma>(3) functions, as appropriate."
3775 #: build/C/man3/gamma.3:49 build/C/man3/lgamma.3:74
3776 msgid "For the definition of the Gamma function, see B<tgamma>(3)."
3780 #: build/C/man3/gamma.3:49
3782 msgid "*BSD version"
3786 #: build/C/man3/gamma.3:53
3788 "The libm in 4.4BSD and some versions of FreeBSD had a B<gamma>() function "
3789 "that computes the Gamma function, as one would expect."
3793 #: build/C/man3/gamma.3:53
3795 msgid "glibc version"
3799 #: build/C/man3/gamma.3:59
3801 "Glibc has a B<gamma>() function that is equivalent to B<lgamma>(3) and "
3802 "computes the natural logarithm of the Gamma function."
3806 #: build/C/man3/gamma.3:62 build/C/man3/gamma.3:65
3807 msgid "See B<lgamma>(3)."
3811 #: build/C/man3/gamma.3:68
3813 "Because of historical variations in behavior across systems, this function "
3814 "is not specified in any standard."
3818 #: build/C/man3/gamma.3:69
3824 #: build/C/man3/gamma.3:81
3826 "4.2BSD had a B<gamma>() that computed ln(|Gamma(|I<x>|)|), leaving the sign "
3827 "of Gamma(|I<x>|) in the external integer I<signgam>. In 4.3BSD the name "
3828 "was changed to B<lgamma>(3), and the man page promises"
3832 #: build/C/man3/gamma.3:85
3834 "At some time in the future the name gamma will be rehabilitated and used for "
3835 "the Gamma function"
3838 #. The FreeBSD man page says about gamma() that it is like lgamma()
3839 #. except that is does not set signgam.
3840 #. Also, that 4.4BSD has a gamma() that computes the true gamma function.
3842 #: build/C/man3/gamma.3:97
3844 "This did indeed happen in 4.4BSD, where B<gamma>() computes the Gamma "
3845 "function (with no effect on I<signgam>). However, this came too late, and "
3846 "we now have B<tgamma>(3), the \"true gamma\" function."
3850 #: build/C/man3/gamma.3:101
3851 msgid "B<lgamma>(3), B<signgam>(3), B<tgamma>(3)"
3855 #: build/C/man3/hypot.3:33
3861 #: build/C/man3/hypot.3:36
3862 msgid "hypot, hypotf, hypotl - Euclidean distance function"
3866 #: build/C/man3/hypot.3:41
3868 msgid "B<double hypot(double >I<x>B<, double >I<y>B<);>\n"
3872 #: build/C/man3/hypot.3:43
3874 msgid "B<float hypotf(float >I<x>B<, float >I<y>B<);>\n"
3878 #: build/C/man3/hypot.3:45
3880 msgid "B<long double hypotl(long double >I<x>B<, long double >I<y>B<);>\n"
3884 #: build/C/man3/hypot.3:56
3889 #: build/C/man3/hypot.3:66
3890 msgid "B<hypotf>(), B<hypotl>():"
3894 #: build/C/man3/hypot.3:87
3896 "The B<hypot>() function returns sqrt(I<x>*I<x>+I<y>*I<y>). This is the "
3897 "length of the hypotenuse of a right-angled triangle with sides of length "
3898 "I<x> and I<y>, or the distance of the point (I<x>,I<y>) from the origin."
3901 #. e.g., hypot(DBL_MIN, DBL_MIN) does the right thing, as does, say
3902 #. hypot(DBL_MAX/2.0, DBL_MAX/2.0).
3904 #: build/C/man3/hypot.3:92
3906 "The calculation is performed without undue overflow or underflow during the "
3907 "intermediate steps of the calculation."
3911 #: build/C/man3/hypot.3:98
3913 "On success, these functions return the length of a right-angled triangle "
3914 "with sides of length I<x> and I<y>."
3918 #: build/C/man3/hypot.3:105
3919 msgid "If I<x> or I<y> is an infinity, positive infinity is returned."
3923 #: build/C/man3/hypot.3:113
3925 "If I<x> or I<y> is a NaN, and the other argument is not an infinity, a NaN "
3929 #. Actually, could the result not be subnormal if both arguments
3930 #. are subnormal? I think not -- mtk, Jul 2008
3932 #: build/C/man3/hypot.3:128
3934 "If both arguments are subnormal, and the result is subnormal, a range error "
3935 "occurs, and the correct result is returned."
3938 #. FIXME . Is it intentional that these functions do not set errno?
3939 #. They do set errno for the y == 0 case, below.
3940 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783
3942 #: build/C/man3/hypot.3:158 build/C/man3/remainder.3:172
3943 msgid "These functions do not set I<errno> for this case."
3947 #: build/C/man3/hypot.3:167
3948 msgid "B<cabs>(3), B<sqrt>(3)"
3952 #: build/C/man3/ilogb.3:29
3958 #: build/C/man3/ilogb.3:32
3959 msgid "ilogb, ilogbf, ilogbl - get integer exponent of a floating-point value"
3963 #: build/C/man3/ilogb.3:36
3964 msgid "B<int ilogb(double >I<x>B<);>"
3968 #: build/C/man3/ilogb.3:38
3969 msgid "B<int ilogbf(float >I<x>B<);>"
3973 #: build/C/man3/ilogb.3:40
3974 msgid "B<int ilogbl(long double >I<x>B<);>"
3978 #: build/C/man3/ilogb.3:50
3983 #: build/C/man3/ilogb.3:62
3984 msgid "B<ilogbf>(), B<ilogbl>():"
3988 #: build/C/man3/ilogb.3:78
3990 "These functions return the exponent part of their argument as a signed "
3991 "integer. When no error occurs, these functions are equivalent to the "
3992 "corresponding B<logb>(3) functions, cast to I<int>."
3996 #: build/C/man3/ilogb.3:82
3998 "On success, these functions return the exponent of I<x>, as a signed "
4002 #. the POSIX.1 spec for logb() says logb() gives pole error for this
4003 #. case, but for ilogb() it says domain error.
4004 #. glibc: The numeric value is either `INT_MIN' or `-INT_MAX'.
4006 #: build/C/man3/ilogb.3:90
4008 "If I<x> is zero, then a domain error occurs, and the functions return "
4012 #. glibc: The numeric value is either `INT_MIN' or `INT_MAX'.
4013 #. On i386, FP_ILOGB0 and FP_ILOGBNAN have the same value.
4015 #: build/C/man3/ilogb.3:97
4017 "If I<x> is a NaN, then a domain error occurs, and the functions return "
4022 #. POSIX.1-2001 also says:
4023 #. If the correct value is greater than {INT_MAX}, {INT_MAX}
4024 #. shall be returned and a domain error shall occur.
4026 #. If the correct value is less than {INT_MIN}, {INT_MIN}
4027 #. shall be returned and a domain error shall occur.
4029 #: build/C/man3/ilogb.3:110
4031 "If I<x> is negative infinity or positive infinity, then a domain error "
4032 "occurs, and the functions return B<INT_MAX>."
4036 #: build/C/man3/ilogb.3:117
4038 msgid "Domain error: I<x> is 0 or a NaN"
4042 #: build/C/man3/ilogb.3:126 build/C/man3/ilogb.3:136
4044 "An invalid floating-point exception (B<FE_INVALID>) is raised, and I<errno> "
4045 "is set to B<EDOM> (but see BUGS)."
4049 #: build/C/man3/ilogb.3:144
4050 msgid "The B<ilogb>(), B<ilogbf>(), and B<ilogbl>() functions are thread-safe."
4053 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794
4055 #: build/C/man3/ilogb.3:150
4057 "Before version 2.16, the following bugs xisted in the glibc implementation "
4058 "of these functions:"
4062 #: build/C/man3/ilogb.3:150 build/C/man3/ilogb.3:156
4068 #: build/C/man3/ilogb.3:156
4070 "The domain error case where I<x> is 0 or a NaN did not cause I<errno> to be "
4071 "set or (on some achitectures) raise a floating-point exception."
4075 #: build/C/man3/ilogb.3:162
4077 "The domain error case where I<x> is an infinity did not cause I<errno> to be "
4078 "set or raise a floating-point exception."
4082 #: build/C/man3/ilogb.3:166
4083 msgid "B<log>(3), B<logb>(3), B<significand>(3)"
4087 #: build/C/man3/infnan.3:33
4093 #: build/C/man3/infnan.3:33
4099 #: build/C/man3/infnan.3:36
4100 msgid "infnan - deal with infinite or not-a-number (NaN) result"
4104 #: build/C/man3/infnan.3:41
4106 msgid "B<double infnan(int >I<error>B<);>\n"
4110 #: build/C/man3/infnan.3:56
4112 "The B<infnan>() function returns a suitable value for infinity and "
4113 "\"not-a-number\" (NaN) results. The value of I<error> can be B<ERANGE> to "
4114 "represent infinity or anything else to represent NaN. I<errno> is also set."
4118 #: build/C/man3/infnan.3:64
4119 msgid "If I<error> is B<ERANGE> (Infinity), B<HUGE_VAL> is returned."
4123 #: build/C/man3/infnan.3:72
4124 msgid "If I<error> is -B<ERANGE> (-Infinity), -B<HUGE_VAL> is returned."
4128 #: build/C/man3/infnan.3:76
4129 msgid "If I<error> is anything else, NAN is returned."
4133 #: build/C/man3/infnan.3:77
4139 #: build/C/man3/infnan.3:82
4140 msgid "The value of I<error> is \"not-a-number\" (NaN)."
4144 #: build/C/man3/infnan.3:82
4150 #: build/C/man3/infnan.3:87
4151 msgid "The value of I<error> is positive infinity or negative infinity."
4155 #: build/C/man3/infnan.3:89
4160 #: build/C/man3/infnan.3:92
4162 "This obsolete function was provided in libc4 and libc5, but is not available "
4167 #: build/C/man3/isgreater.3:10
4173 #: build/C/man3/isgreater.3:10
4179 #: build/C/man3/isgreater.3:14
4181 "isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered - "
4182 "floating-point relational tests without exception for NaN"
4186 #: build/C/man3/isgreater.3:19
4188 msgid "B<int isgreater(>I<x>B<, >I<y>B<);>\n"
4192 #: build/C/man3/isgreater.3:21
4194 msgid "B<int isgreaterequal(>I<x>B<, >I<y>B<);>\n"
4198 #: build/C/man3/isgreater.3:23
4200 msgid "B<int isless(>I<x>B<, >I<y>B<);>\n"
4204 #: build/C/man3/isgreater.3:25
4206 msgid "B<int islessequal(>I<x>B<, >I<y>B<);>\n"
4210 #: build/C/man3/isgreater.3:27
4212 msgid "B<int islessgreater(>I<x>B<, >I<y>B<);>\n"
4216 #: build/C/man3/isgreater.3:29
4218 msgid "B<int isunordered(>I<x>B<, >I<y>B<);>\n"
4222 #: build/C/man3/isgreater.3:40
4223 msgid "All functions described here:"
4227 #: build/C/man3/isgreater.3:55
4229 "The normal relation operations (like B<E<lt>>, \"less than\") will fail if "
4230 "one of the operands is NaN. This will cause an exception. To avoid this, "
4231 "C99 defines the macros listed below."
4235 #: build/C/man3/isgreater.3:61
4237 "These macros are guaranteed to evaluate their arguments only once. The "
4238 "arguments must be of real floating-point type (note: do not pass integer "
4239 "values as arguments to these macros, since the arguments will I<not> be "
4240 "promoted to real-floating types)."
4244 #: build/C/man3/isgreater.3:61
4246 msgid "B<isgreater>()"
4250 #: build/C/man3/isgreater.3:69
4251 msgid "determines I<(x)\\ E<gt>\\ (y)> without an exception if I<x> or I<y> is NaN."
4255 #: build/C/man3/isgreater.3:69
4257 msgid "B<isgreaterequal>()"
4261 #: build/C/man3/isgreater.3:77
4263 "determines I<(x)\\ E<gt>=\\ (y)> without an exception if I<x> or I<y> is "
4268 #: build/C/man3/isgreater.3:77
4274 #: build/C/man3/isgreater.3:85
4275 msgid "determines I<(x)\\ E<lt>\\ (y)> without an exception if I<x> or I<y> is NaN."
4279 #: build/C/man3/isgreater.3:85
4281 msgid "B<islessequal>()"
4285 #: build/C/man3/isgreater.3:93
4287 "determines I<(x)\\ E<lt>=\\ (y)> without an exception if I<x> or I<y> is "
4292 #: build/C/man3/isgreater.3:93
4294 msgid "B<islessgreater>()"
4298 #: build/C/man3/isgreater.3:107
4300 "determines I<(x)\\ E<lt> (y) || (x) E<gt>\\ (y)> without an exception if "
4301 "I<x> or I<y> is NaN. This macro is not equivalent to I<x\\ !=\\ y> because "
4302 "that expression is true if I<x> or I<y> is NaN."
4306 #: build/C/man3/isgreater.3:107
4308 msgid "B<isunordered>()"
4312 #: build/C/man3/isgreater.3:111
4314 "determines whether its arguments are unordered, that is, whether at least "
4315 "one of the arguments is a NaN."
4319 #: build/C/man3/isgreater.3:116
4321 "The macros other than B<isunordered>() return the result of the relational "
4322 "comparison; these macros return 0 if either argument is a NaN."
4326 #: build/C/man3/isgreater.3:123
4327 msgid "B<isunordered>() returns 1 if I<x> or I<y> is NaN and 0 otherwise."
4331 #: build/C/man3/isgreater.3:136
4333 "The B<isgreater>(), B<isgreaterequal>(), B<isless>(), B<islessequal>(), "
4334 "B<islessgreater>(), and B<isunordered>() macros are thread-safe."
4338 #: build/C/man3/isgreater.3:143
4340 "Not all hardware supports these functions, and where hardware support isn't "
4341 "provided, they will be emulated by macros. This will result in a "
4342 "performance penalty. Don't use these functions if NaN is of no concern for "
4347 #: build/C/man3/isgreater.3:146
4348 msgid "B<fpclassify>(3), B<isnan>(3)"
4352 #: build/C/man3/j0.3:36
4358 #: build/C/man3/j0.3:36 build/C/man3/lgamma.3:11 build/C/man3/lrint.3:27 build/C/man3/y0.3:36
4364 #: build/C/man3/j0.3:40
4366 "j0, j0f, j0l, j1, j1f, j1l, jn, jnf, jnl - Bessel functions of the first "
4371 #: build/C/man3/j0.3:46
4372 msgid "B<double j0(double >I<x>B<);>"
4376 #: build/C/man3/j0.3:48
4377 msgid "B<double j1(double >I<x>B<);>"
4381 #: build/C/man3/j0.3:50
4382 msgid "B<double jn(int >I<n>B<, double >I<x>B<);>"
4386 #: build/C/man3/j0.3:52
4387 msgid "B<float j0f(float >I<x>B<);>"
4391 #: build/C/man3/j0.3:54
4392 msgid "B<float j1f(float >I<x>B<);>"
4396 #: build/C/man3/j0.3:56
4397 msgid "B<float jnf(int >I<n>B<, float >I<x>B<);>"
4401 #: build/C/man3/j0.3:58
4402 msgid "B<long double j0l(long double >I<x>B<);>"
4406 #: build/C/man3/j0.3:60
4407 msgid "B<long double j1l(long double >I<x>B<);>"
4411 #: build/C/man3/j0.3:62
4412 msgid "B<long double jnl(int >I<n>B<, long double >I<x>B<);>"
4416 #: build/C/man3/j0.3:74
4417 msgid "B<j0>(), B<j1>(), B<jn>():"
4421 #: build/C/man3/j0.3:76 build/C/man3/y0.3:76
4422 msgid "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE"
4426 #: build/C/man3/j0.3:84
4427 msgid "B<j0f>(), B<j0l>(), B<j1f>(), B<j1l>(), B<jnf>(), B<jnl>():"
4430 #. Also seems to work: -std=c99 -D_XOPEN_SOURCE
4432 #: build/C/man3/j0.3:87 build/C/man3/y0.3:87
4433 msgid "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600"
4437 #: build/C/man3/j0.3:104
4439 "The B<j0>() and B<j1>() functions return Bessel functions of I<x> of the "
4440 "first kind of orders 0 and 1, respectively. The B<jn>() function returns "
4441 "the Bessel function of I<x> of the first kind of order I<n>."
4445 #: build/C/man3/j0.3:121
4447 "The B<j0f>(), B<j1f>(), and B<jnf>(), functions are versions that take and "
4448 "return I<float> values. The B<j0l>(), B<j1l>(), and B<jnl>() functions are "
4449 "versions that take and return I<long double> values."
4453 #: build/C/man3/j0.3:125
4455 "On success, these functions return the appropriate Bessel value of the first "
4460 #: build/C/man3/j0.3:136
4462 "If I<x> is too large in magnitude, or the result underflows, a range error "
4463 "occurs, and the return value is 0."
4467 #: build/C/man3/j0.3:143
4469 msgid "Range error: result underflow, or I<x> is too large in magnitude"
4472 #. An underflow floating-point exception
4473 #. .RB ( FE_UNDERFLOW )
4476 #: build/C/man3/j0.3:151
4477 msgid "I<errno> is set to B<ERANGE>."
4480 #. FIXME . Is it intentional that these functions do not raise exceptions?
4482 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805
4484 #: build/C/man3/j0.3:157
4485 msgid "These functions do not raise exceptions for B<fetestexcept>(3)."
4489 #: build/C/man3/j0.3:163 build/C/man3/y0.3:236
4491 "The functions returning I<double> conform to SVr4, 4.3BSD, POSIX.1-2001. "
4492 "The others are nonstandard functions that also exist on the BSDs."
4496 #: build/C/man3/j0.3:172
4498 "There are errors of up to 2e-16 in the values returned by B<j0>(), B<j1>() "
4499 "and B<jn>() for values of I<x> between -8 and 8."
4503 #: build/C/man3/j0.3:174
4508 #: build/C/man3/ldexp.3:34
4514 #: build/C/man3/ldexp.3:34
4520 #: build/C/man3/ldexp.3:37
4522 "ldexp, ldexpf, ldexpl - multiply floating-point number by integral power of "
4527 #: build/C/man3/ldexp.3:42
4529 msgid "B<double ldexp(double >I<x>B<, int >I<exp>B<);>\n"
4533 #: build/C/man3/ldexp.3:44
4535 msgid "B<float ldexpf(float >I<x>B<, int >I<exp>B<);>\n"
4539 #: build/C/man3/ldexp.3:46
4541 msgid "B<long double ldexpl(long double >I<x>B<, int >I<exp>B<);>\n"
4545 #: build/C/man3/ldexp.3:58
4546 msgid "B<ldexpf>(), B<ldexpl>():"
4550 #: build/C/man3/ldexp.3:73
4552 "The B<ldexp>() function returns the result of multiplying the "
4553 "floating-point number I<x> by 2 raised to the power I<exp>."
4557 #: build/C/man3/ldexp.3:76
4558 msgid "On success, these functions return I<x * (2^exp)>."
4562 #: build/C/man3/ldexp.3:82
4563 msgid "If I<exp> is zero, then I<x> is returned."
4567 #: build/C/man3/ldexp.3:106 build/C/man3/scalb.3:133 build/C/man3/scalbln.3:125
4569 "If the result overflows, a range error occurs, and the functions return "
4570 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with a sign the "
4575 #: build/C/man3/ldexp.3:137
4576 msgid "The B<ldexp>(), B<ldexpf>(), and B<ldexpl>() functions are thread-safe."
4580 #: build/C/man3/ldexp.3:147
4581 msgid "B<frexp>(3), B<modf>(3), B<scalbln>(3)"
4585 #: build/C/man3/lgamma.3:11
4591 #: build/C/man3/lgamma.3:15
4593 "lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam - log "
4598 #: build/C/man3/lgamma.3:20
4600 msgid "B<double lgamma(double >I<x>B<);>\n"
4604 #: build/C/man3/lgamma.3:22
4606 msgid "B<float lgammaf(float >I<x>B<);>\n"
4610 #: build/C/man3/lgamma.3:24
4612 msgid "B<long double lgammal(long double >I<x>B<);>\n"
4616 #: build/C/man3/lgamma.3:26
4618 msgid "B<double lgamma_r(double >I<x>B<, int *>I<signp>B<);>\n"
4622 #: build/C/man3/lgamma.3:28
4624 msgid "B<float lgammaf_r(float >I<x>B<, int *>I<signp>B<);>\n"
4628 #: build/C/man3/lgamma.3:30
4630 msgid "B<long double lgammal_r(long double >I<x>B<, int *>I<signp>B<);>\n"
4634 #: build/C/man3/lgamma.3:32
4636 msgid "B<extern int >I<signgam>B<;>\n"
4640 #: build/C/man3/lgamma.3:43
4641 msgid "B<lgamma>():"
4645 #: build/C/man3/lgamma.3:53
4646 msgid "B<lgammaf>(), B<lgammal>():"
4650 #: build/C/man3/lgamma.3:63
4651 msgid "B<lgamma_r>(), B<lgammaf_r>(), B<lgammal_r>():"
4655 #: build/C/man3/lgamma.3:67
4660 #: build/C/man3/lgamma.3:86
4662 "The B<lgamma>() function returns the natural logarithm of the absolute "
4663 "value of the Gamma function. The sign of the Gamma function is returned in "
4664 "the external integer I<signgam> declared in I<E<lt>math.hE<gt>>. It is 1 "
4665 "when the Gamma function is positive or zero, -1 when it is negative."
4669 #: build/C/man3/lgamma.3:96
4671 "Since using a constant location I<signgam> is not thread-safe, the functions "
4672 "B<lgamma_r>(), B<lgammaf_r>(), and B<lgammal_r>() have been introduced; "
4673 "they return the sign via the argument I<signp>."
4677 #: build/C/man3/lgamma.3:98
4678 msgid "On success, these functions return the natural logarithm of Gamma(x)."
4682 #: build/C/man3/lgamma.3:106
4683 msgid "If I<x> is 1 or 2, +0 is returned."
4687 #: build/C/man3/lgamma.3:122
4689 "If I<x> is a nonpositive integer, a pole error occurs, and the functions "
4690 "return +B<HUGE_VAL>, +B<HUGE_VALF>, or +B<HUGE_VALL>, respectively."
4694 #: build/C/man3/lgamma.3:132 build/C/man3/tgamma.3:92
4696 "If the result overflows, a range error occurs, and the functions return "
4697 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the correct "
4698 "mathematical sign."
4702 #: build/C/man3/lgamma.3:139
4704 msgid "Pole error: I<x> is a nonpositive integer"
4708 #: build/C/man3/lgamma.3:167
4710 "The B<lgamma>() functions are specified in C99 and POSIX.1-2001. "
4711 "I<signgam> is specified in POSIX.1-2001, but not in C99. The B<lgamma_r>() "
4712 "functions are nonstandard, but present on several other systems."
4715 #. http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777
4717 #: build/C/man3/lgamma.3:177
4719 "In glibc 2.9 and earlier, when a pole error occurs, I<errno> is set to "
4720 "B<EDOM>; instead of the POSIX-mandated B<ERANGE>. Since version 2.10, glibc "
4721 "does the right thing."
4725 #: build/C/man3/lgamma.3:179
4726 msgid "B<tgamma>(3)"
4730 #: build/C/man3/log.3:36
4736 #: build/C/man3/log.3:39
4737 msgid "log, logf, logl - natural logarithmic function"
4741 #: build/C/man3/log.3:44
4743 msgid "B<double log(double >I<x>B<);>\n"
4747 #: build/C/man3/log.3:46
4749 msgid "B<float logf(float >I<x>B<);>\n"
4753 #: build/C/man3/log.3:48
4755 msgid "B<long double logl(long double >I<x>B<);>\n"
4759 #: build/C/man3/log.3:60
4760 msgid "B<logf>(), B<logl>():"
4764 #: build/C/man3/log.3:73
4765 msgid "The B<log>() function returns the natural logarithm of I<x>."
4769 #: build/C/man3/log.3:76
4770 msgid "On success, these functions return the natural logarithm of I<x>."
4774 #: build/C/man3/log.3:85
4775 msgid "If I<x> is 1, the result is +0."
4779 #: build/C/man3/log.3:100 build/C/man3/logb.3:111
4781 "If I<x> is zero, then a pole error occurs, and the functions return "
4782 "-B<HUGE_VAL>, -B<HUGE_VALF>, or -B<HUGE_VALL>, respectively."
4786 #: build/C/man3/log.3:105
4788 "If I<x> is negative (including negative infinity), then a domain error "
4789 "occurs, and a NaN (not a number) is returned."
4793 #: build/C/man3/log.3:112 build/C/man3/y0.3:178
4795 msgid "Domain error: I<x> is negative"
4799 #: build/C/man3/log.3:120
4801 msgid "Pole error: I<x> is zero"
4805 #: build/C/man3/log.3:128 build/C/man3/tgamma.3:130
4807 "I<errno> is set to B<ERANGE>. A divide-by-zero floating-point exception "
4808 "(B<FE_DIVBYZERO>) is raised."
4812 #: build/C/man3/log.3:141
4814 "In glibc 2.5 and earlier, taking the B<log>() of a NaN produces a bogus "
4815 "invalid floating-point (B<FE_INVALID>) exception."
4819 #: build/C/man3/log.3:148
4820 msgid "B<cbrt>(3), B<clog>(3), B<log10>(3), B<log1p>(3), B<log2>(3), B<sqrt>(3)"
4824 #: build/C/man3/log10.3:36
4830 #: build/C/man3/log10.3:39
4831 msgid "log10, log10f, log10l - base-10 logarithmic function"
4835 #: build/C/man3/log10.3:44
4837 msgid "B<double log10(double >I<x>B<);>\n"
4841 #: build/C/man3/log10.3:46
4843 msgid "B<float log10f(float >I<x>B<);>\n"
4847 #: build/C/man3/log10.3:48
4849 msgid "B<long double log10l(long double >I<x>B<);>\n"
4853 #: build/C/man3/log10.3:60
4854 msgid "B<log10f>(), B<log10l>():"
4858 #: build/C/man3/log10.3:73
4859 msgid "The B<log10>() function returns the base 10 logarithm of I<x>."
4863 #: build/C/man3/log10.3:76
4864 msgid "On success, these functions return the base 10 logarithm of I<x>."
4868 #: build/C/man3/log10.3:81 build/C/man3/log2.3:81
4870 "For special cases, including where I<x> is 0, 1, negative, infinity, or NaN, "
4875 #: build/C/man3/log10.3:89 build/C/man3/log2.3:89
4877 "For a discussion of the errors that can occur for these functions, see "
4882 #: build/C/man3/log10.3:102
4883 msgid "B<cbrt>(3), B<clog10>(3), B<exp10>(3), B<log>(3), B<log2>(3), B<sqrt>(3)"
4887 #: build/C/man3/log1p.3:29
4893 #: build/C/man3/log1p.3:29 build/C/man3/logb.3:29
4899 #: build/C/man3/log1p.3:32
4900 msgid "log1p, log1pf, log1pl - logarithm of 1 plus argument"
4904 #: build/C/man3/log1p.3:37
4906 msgid "B<double log1p(double >I<x>B<);>\n"
4910 #: build/C/man3/log1p.3:39
4912 msgid "B<float log1pf(float >I<x>B<);>\n"
4916 #: build/C/man3/log1p.3:41
4918 msgid "B<long double log1pl(long double >I<x>B<);>\n"
4922 #: build/C/man3/log1p.3:52
4927 #: build/C/man3/log1p.3:63
4928 msgid "B<log1pf>(), B<log1pl>():"
4932 #: build/C/man3/log1p.3:74
4933 msgid "I<log1p(x)> returns a value equivalent to"
4937 #: build/C/man3/log1p.3:77
4939 msgid " log (1 + I<x>)\n"
4943 #: build/C/man3/log1p.3:83
4945 "It is computed in a way that is accurate even if the value of I<x> is near "
4950 #: build/C/man3/log1p.3:86
4951 msgid "On success, these functions return the natural logarithm of I<(1\\ +\\ x)>."
4955 #: build/C/man3/log1p.3:105
4957 "If I<x> is -1, a pole error occurs, and the functions return -B<HUGE_VAL>, "
4958 "-B<HUGE_VALF>, or -B<HUGE_VALL>, respectively."
4961 #. POSIX.1 specifies a possible range error if x is subnormal
4962 #. glibc 2.8 doesn't do this
4964 #: build/C/man3/log1p.3:113
4966 "If I<x> is less than -1 (including negative infinity), a domain error "
4967 "occurs, and a NaN (not a number) is returned."
4971 #: build/C/man3/log1p.3:120
4973 msgid "Domain error: I<x> is less than -1"
4977 #: build/C/man3/log1p.3:128
4979 msgid "Pole error: I<x> is -1"
4986 #: build/C/man3/log1p.3:136 build/C/man3/logb.3:131
4987 msgid "A divide-by-zero floating-point exception (B<FE_DIVBYZERO>) is raised."
4991 #: build/C/man3/log1p.3:150
4992 msgid "The B<log1p>(), B<log1pf>(), and B<log1pl>() functions are thread-safe."
4996 #: build/C/man3/log1p.3:157
4997 msgid "B<exp>(3), B<expm1>(3), B<log>(3)"
5001 #: build/C/man3/log2.3:36
5007 #: build/C/man3/log2.3:36
5013 #: build/C/man3/log2.3:39
5014 msgid "log2, log2f, log2l - base-2 logarithmic function"
5018 #: build/C/man3/log2.3:44
5020 msgid "B<double log2(double >I<x>B<);>\n"
5024 #: build/C/man3/log2.3:46
5026 msgid "B<float log2f(float >I<x>B<);>\n"
5030 #: build/C/man3/log2.3:48
5032 msgid "B<long double log2l(long double >I<x>B<);>\n"
5036 #: build/C/man3/log2.3:61
5037 msgid "B<log2>(), B<log2f>(), B<log2l>():"
5041 #: build/C/man3/log2.3:73
5042 msgid "The B<log2>() function returns the base 2 logarithm of I<x>."
5046 #: build/C/man3/log2.3:76
5047 msgid "On success, these functions return the base 2 logarithm of I<x>."
5051 #: build/C/man3/log2.3:103
5052 msgid "B<cbrt>(3), B<clog2>(3), B<log>(3), B<log10>(3), B<sqrt>(3)"
5056 #: build/C/man3/logb.3:29
5062 #: build/C/man3/logb.3:32
5063 msgid "logb, logbf, logbl - get exponent of a floating-point value"
5067 #: build/C/man3/logb.3:36
5068 msgid "B<double logb(double >I<x>B<);>"
5072 #: build/C/man3/logb.3:38
5073 msgid "B<float logbf(float >I<x>B<);>"
5077 #: build/C/man3/logb.3:40
5078 msgid "B<long double logbl(long double >I<x>B<);>"
5082 #: build/C/man3/logb.3:50
5087 #: build/C/man3/logb.3:61
5088 msgid "B<logbf>(), B<logbl>():"
5092 #: build/C/man3/logb.3:86
5094 "These functions extract the exponent from the internal floating-point "
5095 "representation of I<x> and return it as a floating-point value. The integer "
5096 "constant B<FLT_RADIX>, defined in I<E<lt>float.hE<gt>>, indicates the radix "
5097 "used for the system's floating-point representation. If B<FLT_RADIX> is 2, "
5098 "B<logb(>I<x>B<)> is equal to B<floor(log2(>I<x>B<))>, except that it is "
5103 #: build/C/man3/logb.3:94
5105 "If I<x> is subnormal, B<logb>() returns the exponent I<x> would have if it "
5110 #: build/C/man3/logb.3:97
5111 msgid "On success, these functions return the exponent of I<x>."
5115 #: build/C/man3/logb.3:116
5117 "If I<x> is negative infinity or positive infinity, then positive infinity is "
5122 #: build/C/man3/logb.3:123
5124 msgid "Pole error: I<x> is 0"
5128 #: build/C/man3/logb.3:151
5129 msgid "The B<logb>(), B<logbf>(), and B<logbl>() functions are thread-safe."
5133 #: build/C/man3/logb.3:156
5134 msgid "B<ilogb>(3), B<log>(3)"
5138 #: build/C/man3/lrint.3:27
5144 #: build/C/man3/lrint.3:30
5145 msgid "lrint, lrintf, lrintl, llrint, llrintf, llrintl - round to nearest integer"
5149 #: build/C/man3/lrint.3:35
5151 msgid "B<long int lrint(double >I<x>B<);>\n"
5155 #: build/C/man3/lrint.3:37
5157 msgid "B<long int lrintf(float >I<x>B<);>\n"
5161 #: build/C/man3/lrint.3:39
5163 msgid "B<long int lrintl(long double >I<x>B<);>\n"
5167 #: build/C/man3/lrint.3:41
5169 msgid "B<long long int llrint(double >I<x>B<);>\n"
5173 #: build/C/man3/lrint.3:43
5175 msgid "B<long long int llrintf(float >I<x>B<);>\n"
5179 #: build/C/man3/lrint.3:45
5181 msgid "B<long long int llrintl(long double >I<x>B<);>\n"
5185 #: build/C/man3/lrint.3:56 build/C/man3/lround.3:57
5186 msgid "All functions shown above:"
5190 #: build/C/man3/lrint.3:68
5192 "These functions round their argument to the nearest integer value, using the "
5193 "current rounding direction (see B<fesetround>(3))."
5197 #: build/C/man3/lrint.3:74
5199 "Note that unlike the B<rint>(3) family of functions, the return type of "
5200 "these functions differs from that of their arguments."
5204 #: build/C/man3/lrint.3:76 build/C/man3/lround.3:79 build/C/man3/rint.3:113 build/C/man3/round.3:77 build/C/man3/trunc.3:65
5205 msgid "These functions return the rounded integer value."
5208 #. The return value is -(LONG_MAX - 1) or -(LLONG_MAX -1)
5210 #: build/C/man3/lrint.3:88 build/C/man3/lround.3:91
5212 "If I<x> is a NaN or an infinity, or the rounded value is too large to be "
5213 "stored in a I<long> (I<long long> in the case of the B<ll*> functions), then "
5214 "a domain error occurs, and the return value is unspecified."
5218 #: build/C/man3/lrint.3:95 build/C/man3/lround.3:98
5220 msgid "Domain error: I<x> is a NaN or infinite, or the rounded value is too large"
5224 #: build/C/man3/lrint.3:121
5226 "The B<lrint>(), B<lrintf>(), B<lrintl>(), B<llrint>(), B<llrintf>(), and "
5227 "B<llrintl>() functions are thread-safe."
5231 #: build/C/man3/lrint.3:130
5233 "B<ceil>(3), B<floor>(3), B<lround>(3), B<nearbyint>(3), B<rint>(3), "
5238 #: build/C/man3/lround.3:27
5244 #: build/C/man3/lround.3:27 build/C/man3/rint.3:27
5250 #: build/C/man3/lround.3:31
5252 "lround, lroundf, lroundl, llround, llroundf, llroundl - round to nearest "
5253 "integer, away from zero"
5257 #: build/C/man3/lround.3:36
5259 msgid "B<long int lround(double >I<x>B<);>\n"
5263 #: build/C/man3/lround.3:38
5265 msgid "B<long int lroundf(float >I<x>B<);>\n"
5269 #: build/C/man3/lround.3:40
5271 msgid "B<long int lroundl(long double >I<x>B<);>\n"
5275 #: build/C/man3/lround.3:42
5277 msgid "B<long long int llround(double >I<x>B<);>\n"
5281 #: build/C/man3/lround.3:44
5283 msgid "B<long long int llroundf(float >I<x>B<);>\n"
5287 #: build/C/man3/lround.3:46
5289 msgid "B<long long int llroundl(long double >I<x>B<);>\n"
5293 #: build/C/man3/lround.3:70
5295 "These functions round their argument to the nearest integer value, rounding "
5296 "away from zero, regardless of the current rounding direction (see "
5301 #: build/C/man3/lround.3:77
5303 "Note that unlike the B<round>(3) and B<ceil>(3), functions, the return type "
5304 "of these functions differs from that of their arguments."
5308 #: build/C/man3/lround.3:124
5310 "The B<lround>(), B<lroundf>(), B<lroundl>(), B<llround>(), B<llroundf>(), "
5311 "and B<llroundl>() functions are thread-safe."
5315 #: build/C/man3/lround.3:133 build/C/man3/trunc.3:101
5317 "B<ceil>(3), B<floor>(3), B<lrint>(3), B<nearbyint>(3), B<rint>(3), "
5322 #: build/C/man7/math_error.7:26
5328 #: build/C/man7/math_error.7:26 build/C/man3/pow10.3:25
5334 #: build/C/man7/math_error.7:29
5335 msgid "math_error - detecting errors from mathematical functions"
5339 #: build/C/man7/math_error.7:34
5342 "B<#include E<lt>math.hE<gt>>\n"
5343 "B<#include E<lt>errno.hE<gt>>\n"
5344 "B<#include E<lt>fenv.hE<gt>>\n"
5348 #: build/C/man7/math_error.7:53
5350 "When an error occurs, most library functions indicate this fact by returning "
5351 "a special value (e.g., -1 or NULL). Because they typically return a "
5352 "floating-point number, the mathematical functions declared in "
5353 "I<E<lt>math.hE<gt>> indicate an error using other mechanisms. There are two "
5354 "error-reporting mechanisms: the older one sets I<errno>; the newer one uses "
5355 "the floating-point exception mechanism (the use of B<feclearexcept>(3) and "
5356 "B<fetestexcept>(3), as outlined below) described in B<fenv>(3)."
5360 #: build/C/man7/math_error.7:58
5362 "A portable program that needs to check for an error from a mathematical "
5363 "function should set I<errno> to zero, and make the following call"
5367 #: build/C/man7/math_error.7:62
5369 msgid "feclearexcept(FE_ALL_EXCEPT);\n"
5373 #: build/C/man7/math_error.7:66
5374 msgid "before calling a mathematical function."
5378 #: build/C/man7/math_error.7:72
5380 "Upon return from the mathematical function, if I<errno> is nonzero, or the "
5381 "following call (see B<fenv>(3)) returns nonzero"
5385 #: build/C/man7/math_error.7:77
5388 "fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |\n"
5394 #. FE_INVALID = 0x01,
5395 #. __FE_DENORM = 0x02,
5396 #. FE_DIVBYZERO = 0x04,
5397 #. FE_OVERFLOW = 0x08,
5398 #. FE_UNDERFLOW = 0x10,
5399 #. FE_INEXACT = 0x20
5402 #: build/C/man7/math_error.7:90
5403 msgid "then an error occurred in the mathematical function."
5407 #: build/C/man7/math_error.7:93
5409 "The error conditions that can occur for mathematical functions are described "
5414 #: build/C/man7/math_error.7:93
5416 msgid "Domain error"
5420 #: build/C/man7/math_error.7:109
5422 "A I<domain error> occurs when a mathematical function is supplied with an "
5423 "argument whose value falls outside the domain for which the function is "
5424 "defined (e.g., giving a negative argument to B<log>(3)). When a domain "
5425 "error occurs, math functions commonly return a NaN (though some functions "
5426 "return a different value in this case); I<errno> is set to B<EDOM>, and an "
5427 "\"invalid\" (B<FE_INVALID>) floating-point exception is raised."
5431 #: build/C/man7/math_error.7:109
5437 #: build/C/man7/math_error.7:133
5439 "A I<pole error> occurs when the mathematical result of a function is an "
5440 "exact infinity (e.g., the logarithm of 0 is negative infinity). When a pole "
5441 "error occurs, the function returns the (signed) value B<HUGE_VAL>, "
5442 "B<HUGE_VALF>, or B<HUGE_VALL>, depending on whether the function result type "
5443 "is I<double>, I<float>, or I<long double>. The sign of the result is that "
5444 "which is mathematically correct for the function. I<errno> is set to "
5445 "B<ERANGE>, and a \"divide-by-zero\" (B<FE_DIVBYZERO>) floating-point "
5446 "exception is raised."
5450 #: build/C/man7/math_error.7:133
5456 #: build/C/man7/math_error.7:140
5458 "A I<range error> occurs when the magnitude of the function result means that "
5459 "it cannot be represented in the result type of the function. The return "
5460 "value of the function depends on whether the range error was an overflow or "
5465 #: build/C/man7/math_error.7:162
5467 "A floating result I<overflows> if the result is finite, but is too large to "
5468 "represented in the result type. When an overflow occurs, the function "
5469 "returns the value B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, depending on "
5470 "whether the function result type is I<double>, I<float>, or I<long double>. "
5471 "I<errno> is set to B<ERANGE>, and an \"overflow\" (B<FE_OVERFLOW>) "
5472 "floating-point exception is raised."
5476 #: build/C/man7/math_error.7:177
5478 "A floating result I<underflows> if the result is too small to be represented "
5479 "in the result type. If an underflow occurs, a mathematical function "
5480 "typically returns 0.0 (C99 says a function shall return \"an "
5481 "implementation-defined value whose magnitude is no greater than the smallest "
5482 "normalized positive number in the specified type\"). I<errno> may be set to "
5483 "B<ERANGE>, and an \"overflow\" (B<FE_UNDERFLOW>) floating-point exception "
5488 #: build/C/man7/math_error.7:187
5490 "Some functions deliver a range error if the supplied argument value, or the "
5491 "correct function result, would be I<subnormal>. A subnormal value is one "
5492 "that is nonzero, but with a magnitude that is so small that it can't be "
5493 "presented in normalized form (i.e., with a 1 in the most significant bit of "
5494 "the significand). The representation of a subnormal number will contain one "
5495 "or more leading zeros in the significand."
5498 #. See CONFORMANCE in the glibc 2.8 (and earlier) source.
5500 #: build/C/man7/math_error.7:209
5502 "The I<math_errhandling> identifier specified by C99 and POSIX.1-2001 is not "
5503 "supported by glibc. This identifier is supposed to indicate which of the "
5504 "two error-notification mechanisms (I<errno>, exceptions retrievable via "
5505 "B<fettestexcept>(3)) is in use. The standards require that at least one be "
5506 "in use, but permit both to be available. The current (version 2.8) "
5507 "situation under glibc is messy. Most (but not all) functions raise "
5508 "exceptions on errors. Some also set I<errno>. A few functions set "
5509 "I<errno>, but don't raise an exception. A very few functions do neither. "
5510 "See the individual manual pages for details."
5513 #. http://www.securecoding.cert.org/confluence/display/seccode/FLP32-C.+Prevent+or+detect+domain+and+range+errors+in+math+functions
5515 #: build/C/man7/math_error.7:222
5517 "To avoid the complexities of using I<errno> and B<fetestexcept>(3) for "
5518 "error checking, it is often advised that one should instead check for bad "
5519 "argument values before each call. For example, the following code ensures "
5520 "that B<log>(3)'s argument is not a NaN and is not zero (a pole error) or "
5521 "less than zero (a domain error):"
5525 #: build/C/man7/math_error.7:226
5527 msgid "double x, r;\n"
5531 #: build/C/man7/math_error.7:230
5534 "if (isnan(x) || islessequal(x, 0)) {\n"
5535 " /* Deal with NaN / pole error / domain error */\n"
5540 #: build/C/man7/math_error.7:232
5542 msgid "r = log(x);\n"
5546 #: build/C/man7/math_error.7:240
5548 "The discussion on this page does not apply to the complex mathematical "
5549 "functions (i.e., those declared by I<E<lt>complex.hE<gt>>), which in general "
5550 "are not required to return errors by C99 and POSIX.1-2001."
5554 #: build/C/man7/math_error.7:256
5556 "The B<gcc>(1) I<-fno-math-errno> option causes the executable to employ "
5557 "implementations of some mathematical functions that are faster than the "
5558 "standard implementations, but do not set I<errno> on error. (The B<gcc>(1) "
5559 "I<-ffast-math> option also enables I<-fno-math-errno>.) An error can still "
5560 "be tested for using B<fetestexcept>(3)."
5564 #: build/C/man7/math_error.7:265
5566 "B<gcc>(1), B<errno>(3), B<fenv>(3), B<fpclassify>(3), B<INFINITY>(3), "
5567 "B<isgreater>(3), B<matherr>(3), B<nan>(3)"
5571 #: build/C/man7/math_error.7:267
5572 msgid "I<info libc>"
5576 #: build/C/man3/matherr.3:27
5582 #: build/C/man3/matherr.3:27
5588 #: build/C/man3/matherr.3:30
5589 msgid "matherr - SVID math library exception handling"
5593 #: build/C/man3/matherr.3:34
5596 "B<#define _SVID_SOURCE> /* See feature_test_macros(7) */\n"
5597 "B<#include E<lt>math.hE<gt>>\n"
5601 #: build/C/man3/matherr.3:36
5603 msgid "B<int matherr(struct exception *>I<exc>B<);>\n"
5607 #: build/C/man3/matherr.3:38
5609 msgid "B<extern _LIB_VERSION_TYPE _LIB_VERSION;>\n"
5613 #: build/C/man3/matherr.3:51
5615 "The System V Interface Definition (SVID) specifies that various math "
5616 "functions should invoke a function called B<matherr>() if a math exception "
5617 "is detected. This function is called before the math function returns; "
5618 "after B<matherr>() returns, the system then returns to the math function, "
5619 "which in turn returns to the caller."
5623 #: build/C/man3/matherr.3:62
5625 "The B<matherr>() mechanism is supported by glibc, but is now obsolete: new "
5626 "applications should use the techniques described in B<math_error>(7) and "
5627 "B<fenv>(3). This page documents the glibc B<matherr>() mechanism as an aid "
5628 "for maintaining and porting older applications."
5632 #: build/C/man3/matherr.3:75
5634 "To employ B<matherr>(), the programmer must define the B<_SVID_SOURCE> "
5635 "feature test macro (before including I<any> header files), and assign the "
5636 "value B<_SVID_> to the external variable B<_LIB_VERSION>."
5640 #: build/C/man3/matherr.3:87
5642 "The system provides a default version of B<matherr>(). This version does "
5643 "nothing, and returns zero (see below for the significance of this). The "
5644 "default B<matherr>() can be overridden by a programmer-defined version, "
5645 "which will be invoked when an exception occurs. The function is invoked "
5646 "with one argument, a pointer to an I<exception> structure, defined as "
5651 #: build/C/man3/matherr.3:97
5654 "struct exception {\n"
5655 " int type; /* Exception type */\n"
5656 " char *name; /* Name of function causing exception */\n"
5657 " double arg1; /* 1st argument to function */\n"
5658 " double arg2; /* 2nd argument to function */\n"
5659 " double retval; /* Function return value */\n"
5664 #: build/C/man3/matherr.3:103
5665 msgid "The I<type> field has one of the following values:"
5669 #: build/C/man3/matherr.3:103
5675 #: build/C/man3/matherr.3:111
5677 "A domain error occurred (the function argument was outside the range for "
5678 "which the function is defined). The return value depends on the function; "
5679 "I<errno> is set to B<EDOM>."
5683 #: build/C/man3/matherr.3:111
5689 #: build/C/man3/matherr.3:122
5691 "A pole error occurred (the function result is an infinity). The return "
5692 "value in most cases is B<HUGE> (the largest single precision floating-point "
5693 "number), appropriately signed. In most cases, I<errno> is set to B<EDOM>."
5697 #: build/C/man3/matherr.3:122
5703 #: build/C/man3/matherr.3:131
5705 "An overflow occurred. In most cases, the value B<HUGE> is returned, and "
5706 "I<errno> is set to B<ERANGE>."
5710 #: build/C/man3/matherr.3:131
5712 msgid "B<UNDERFLOW>"
5716 #: build/C/man3/matherr.3:138
5717 msgid "An underflow occurred. 0.0 is returned, and I<errno> is set to B<ERANGE>."
5721 #: build/C/man3/matherr.3:138
5727 #: build/C/man3/matherr.3:145
5729 "Total loss of significance. 0.0 is returned, and I<errno> is set to "
5734 #: build/C/man3/matherr.3:145
5740 #: build/C/man3/matherr.3:150
5742 "Partial loss of significance. This value is unused on glibc (and many other "
5747 #: build/C/man3/matherr.3:158
5749 "The I<arg1> and I<arg2> fields are the arguments supplied to the function "
5750 "(I<arg2> is undefined for functions that take only one argument)."
5754 #: build/C/man3/matherr.3:166
5756 "The I<retval> field specifies the return value that the math function will "
5757 "return to its caller. The programmer-defined B<matherr>() can modify this "
5758 "field to change the return value of the math function."
5762 #: build/C/man3/matherr.3:173
5764 "If the B<matherr>() function returns zero, then the system sets I<errno> as "
5765 "described above, and may print an error message on standard error (see "
5770 #: build/C/man3/matherr.3:179
5772 "If the B<matherr>() function returns a nonzero value, then the system does "
5773 "not set I<errno>, and doesn't print an error message."
5777 #: build/C/man3/matherr.3:179
5779 msgid "Math functions that employ matherr()"
5783 #: build/C/man3/matherr.3:189
5785 "The table below lists the functions and circumstances in which B<matherr>() "
5786 "is called. The \"Type\" column indicates the value assigned to "
5787 "I<exc-E<gt>type> when calling B<matherr>(). The \"Result\" column is the "
5788 "default return value assigned to I<exc-E<gt>retval>."
5792 #: build/C/man3/matherr.3:195
5794 "The \"Msg?\" and \"errno\" columns describe the default behavior if "
5795 "B<matherr>() returns zero. If the \"Msg?\" columns contains \"y\", then "
5796 "the system prints an error message on standard error."
5800 #: build/C/man3/matherr.3:197
5801 msgid "The table uses the following notations and abbreviations:"
5805 #: build/C/man3/matherr.3:209
5808 "x first argument to function\n"
5809 "y second argument to function\n"
5810 "fin finite value for argument\n"
5811 "neg negative value for argument\n"
5812 "int integral value for argument\n"
5813 "o/f result overflowed\n"
5814 "u/f result underflowed\n"
5815 "|x| absolute value of x\n"
5816 "X_TLOSS is a constant defined in I<E<lt>math.hE<gt>>\n"
5820 #: build/C/man3/matherr.3:216
5822 msgid "Function\tType\tResult\tMsg?\terrno\n"
5826 #: build/C/man3/matherr.3:217
5828 msgid "acos(|x|E<gt>1)\tDOMAIN\tHUGE\ty\tEDOM\n"
5832 #: build/C/man3/matherr.3:218
5834 msgid "asin(|x|E<gt>1)\tDOMAIN\tHUGE\ty\tEDOM\n"
5838 #: build/C/man3/matherr.3:219
5840 msgid "atan2(0,0)\tDOMAIN\tHUGE\ty\tEDOM\n"
5843 #. retval is 0.0/0.0
5845 #: build/C/man3/matherr.3:220
5847 msgid "acosh(xE<lt>1)\tDOMAIN\tNAN\ty\tEDOM\t\n"
5850 #. retval is 0.0/0.0
5852 #: build/C/man3/matherr.3:221
5854 msgid "atanh(|x|E<gt>1)\tDOMAIN\tNAN\ty\tEDOM\t\n"
5859 #: build/C/man3/matherr.3:222
5861 msgid "atanh(|x|==1)\tSING\t(xE<gt>0.0)?\ty\tEDOM\t\n"
5865 #: build/C/man3/matherr.3:223 build/C/man3/matherr.3:268
5867 msgid "\\ \t\\ \tHUGE_VAL :\n"
5871 #: build/C/man3/matherr.3:224 build/C/man3/matherr.3:269
5873 msgid "\\ \t\\ \t-HUGE_VAL\n"
5877 #: build/C/man3/matherr.3:225
5879 msgid "cosh(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5883 #: build/C/man3/matherr.3:226
5885 msgid "sinh(fin) o/f\tOVERFLOW\t(xE<gt>0.0) ?\tn\tERANGE\n"
5889 #: build/C/man3/matherr.3:227
5891 msgid "\\ \t\\ \tHUGE : -HUGE\n"
5895 #: build/C/man3/matherr.3:228
5897 msgid "sqrt(xE<lt>0)\tDOMAIN\t0.0\ty\tEDOM\n"
5901 #: build/C/man3/matherr.3:229
5903 msgid "hypot(fin,fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5907 #: build/C/man3/matherr.3:230
5909 msgid "exp(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5913 #: build/C/man3/matherr.3:231
5915 msgid "exp(fin) u/f\tUNDERFLOW\t0.0\tn\tERANGE\n"
5919 #: build/C/man3/matherr.3:232
5921 msgid "exp2(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5925 #: build/C/man3/matherr.3:233
5927 msgid "exp2(fin) u/f\tUNDERFLOW\t0.0\tn\tERANGE\n"
5931 #: build/C/man3/matherr.3:234
5933 msgid "exp10(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
5937 #: build/C/man3/matherr.3:235
5939 msgid "exp10(fin) u/f\tUNDERFLOW\t0.0\tn\tERANGE\n"
5943 #: build/C/man3/matherr.3:236
5945 msgid "j0(|x|E<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5949 #: build/C/man3/matherr.3:237
5951 msgid "j1(|x|E<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5955 #: build/C/man3/matherr.3:238
5957 msgid "jn(|x|E<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5961 #: build/C/man3/matherr.3:239
5963 msgid "y0(xE<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5967 #: build/C/man3/matherr.3:240
5969 msgid "y1(xE<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5973 #: build/C/man3/matherr.3:241
5975 msgid "yn(xE<gt>X_TLOSS)\tTLOSS\t0.0\ty\tERANGE\n"
5979 #: build/C/man3/matherr.3:242
5981 msgid "y0(0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5985 #: build/C/man3/matherr.3:243
5987 msgid "y0(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5991 #: build/C/man3/matherr.3:244
5993 msgid "y1(0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
5997 #: build/C/man3/matherr.3:245
5999 msgid "y1(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
6003 #: build/C/man3/matherr.3:246
6005 msgid "yn(n,0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
6009 #: build/C/man3/matherr.3:247
6011 msgid "yn(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
6015 #: build/C/man3/matherr.3:248
6017 msgid "lgamma(fin) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
6021 #: build/C/man3/matherr.3:249
6023 msgid "lgamma(-int) or\tSING\tHUGE\ty\tEDOM\n"
6027 #: build/C/man3/matherr.3:250
6029 msgid "\\ \\ lgamma(0)\n"
6033 #: build/C/man3/matherr.3:251
6035 msgid "tgamma(fin) o/f\tOVERFLOW\tHUGE_VAL\tn\tERANGE\n"
6039 #: build/C/man3/matherr.3:252
6041 msgid "tgamma(-int)\tSING\tNAN\ty\tEDOM\n"
6045 #: build/C/man3/matherr.3:253
6047 msgid "tgamma(0)\tSING\tcopysign(\ty\tERANGE\n"
6051 #: build/C/man3/matherr.3:254
6053 msgid "\\ \t\\ \tHUGE_VAL,x)\n"
6057 #: build/C/man3/matherr.3:255
6059 msgid "log(0)\tSING\t-HUGE\ty\tEDOM\n"
6063 #: build/C/man3/matherr.3:256
6065 msgid "log(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
6068 #. different from log()
6070 #: build/C/man3/matherr.3:257
6072 msgid "log2(0)\tSING\t-HUGE\tn\tEDOM\t\n"
6075 #. different from log()
6077 #: build/C/man3/matherr.3:258
6079 msgid "log2(xE<lt>0)\tDOMAIN\t-HUGE\tn\tEDOM\t\n"
6083 #: build/C/man3/matherr.3:259
6085 msgid "log10(0)\tSING\t-HUGE\ty\tEDOM\n"
6089 #: build/C/man3/matherr.3:260
6091 msgid "log10(xE<lt>0)\tDOMAIN\t-HUGE\ty\tEDOM\n"
6095 #: build/C/man3/matherr.3:261
6097 msgid "pow(0.0,0.0)\tDOMAIN\t0.0\ty\tEDOM\n"
6101 #: build/C/man3/matherr.3:262
6103 msgid "pow(x,y) o/f\tOVERFLOW\tHUGE\tn\tERANGE\n"
6107 #: build/C/man3/matherr.3:263
6109 msgid "pow(x,y) u/f\tUNDERFLOW\t0.0\tn\tERANGE\n"
6113 #: build/C/man3/matherr.3:264
6115 msgid "pow(NaN,0.0)\tDOMAIN\tx\tn\tEDOM\n"
6120 #: build/C/man3/matherr.3:265
6122 msgid "0**neg\tDOMAIN\t0.0\ty\tEDOM\t\n"
6126 #: build/C/man3/matherr.3:266
6128 msgid "neg**non-int\tDOMAIN\t0.0\ty\tEDOM\n"
6132 #: build/C/man3/matherr.3:267
6134 msgid "scalb() o/f\tOVERFLOW\t(xE<gt>0.0) ?\tn\tERANGE\n"
6138 #: build/C/man3/matherr.3:270
6140 msgid "scalb() u/f\tUNDERFLOW\tcopysign(\tn\tERANGE\n"
6144 #: build/C/man3/matherr.3:271
6146 msgid "\\ \t\\ \t\\ \\ 0.0,x)\n"
6150 #: build/C/man3/matherr.3:272
6152 msgid "fmod(x,0)\tDOMAIN\tx\ty\tEDOM\n"
6155 #. retval is 0.0/0.0
6157 #: build/C/man3/matherr.3:273
6159 msgid "remainder(x,0)\tDOMAIN\tNAN\ty\tEDOM\t\n"
6163 #: build/C/man3/matherr.3:280
6164 msgid "The B<matherr>() function is thread-safe."
6168 #: build/C/man3/matherr.3:301
6170 "The example program demonstrates the use of B<matherr>() when calling "
6171 "B<log>(3). The program takes up to three command-line arguments. The first "
6172 "argument is the floating-point number to be given to B<log>(3). If the "
6173 "optional second argument is provided, then B<_LIB_VERSION> is set to "
6174 "B<_SVID_> so that B<matherr>() is called, and the integer supplied in the "
6175 "command-line argument is used as the return value from B<matherr>(). If the "
6176 "optional third command-line argument is supplied, then it specifies an "
6177 "alternative return value that B<matherr>() should assign as the return "
6178 "value of the math function."
6182 #: build/C/man3/matherr.3:306
6184 "The following example run, where B<log>(3) is given an argument of 0.0, "
6185 "does not use B<matherr>():"
6189 #: build/C/man3/matherr.3:312
6192 "$B< ./a.out 0.0>\n"
6193 "errno: Numerical result out of range\n"
6198 #: build/C/man3/matherr.3:318
6199 msgid "In the following run, B<matherr>() is called, and returns 0:"
6203 #: build/C/man3/matherr.3:328
6206 "$B< ./a.out 0.0 0>\n"
6207 "matherr SING exception in log() function\n"
6208 " args: 0.000000, 0.000000\n"
6209 " retval: -340282346638528859811704183484516925440.000000\n"
6211 "errno: Numerical argument out of domain\n"
6212 "x=-340282346638528859811704183484516925440.000000\n"
6216 #: build/C/man3/matherr.3:332
6217 msgid "The message \"log: SING error\" was printed by the C library."
6221 #: build/C/man3/matherr.3:336
6222 msgid "In the following run, B<matherr>() is called, and returns a nonzero value:"
6226 #: build/C/man3/matherr.3:344
6229 "$B< ./a.out 0.0 1>\n"
6230 "matherr SING exception in log() function\n"
6231 " args: 0.000000, 0.000000\n"
6232 " retval: -340282346638528859811704183484516925440.000000\n"
6233 "x=-340282346638528859811704183484516925440.000000\n"
6237 #: build/C/man3/matherr.3:350
6239 "In this case, the C library did not print a message, and I<errno> was not "
6244 #: build/C/man3/matherr.3:355
6246 "In the following run, B<matherr>() is called, changes the return value of "
6247 "the math function, and returns a nonzero value:"
6251 #: build/C/man3/matherr.3:363
6254 "$B< ./a.out 0.0 1 12345.0>\n"
6255 "matherr SING exception in log() function\n"
6256 " args: 0.000000, 0.000000\n"
6257 " retval: -340282346638528859811704183484516925440.000000\n"
6262 #: build/C/man3/matherr.3:373
6265 "#define _SVID_SOURCE\n"
6266 "#include E<lt>errno.hE<gt>\n"
6267 "#include E<lt>math.hE<gt>\n"
6268 "#include E<lt>stdio.hE<gt>\n"
6269 "#include E<lt>stdlib.hE<gt>\n"
6273 #: build/C/man3/matherr.3:379
6276 "static int matherr_ret = 0; /* Value that matherr()\n"
6277 " should return */\n"
6278 "static int change_retval = 0; /* Should matherr() change\n"
6279 " function\\(aqs return value? */\n"
6280 "static double new_retval; /* New function return value */\n"
6284 #: build/C/man3/matherr.3:394
6288 "matherr(struct exception *exc)\n"
6290 " fprintf(stderr, \"matherr %s exception in %s() function\\en\",\n"
6291 " (exc-E<gt>type == DOMAIN) ? \"DOMAIN\" :\n"
6292 " (exc-E<gt>type == OVERFLOW) ? \"OVERFLOW\" :\n"
6293 " (exc-E<gt>type == UNDERFLOW) ? \"UNDERFLOW\" :\n"
6294 " (exc-E<gt>type == SING) ? \"SING\" :\n"
6295 " (exc-E<gt>type == TLOSS) ? \"TLOSS\" :\n"
6296 " (exc-E<gt>type == PLOSS) ? \"PLOSS\" : \"???\",\n"
6297 " exc-E<gt>name);\n"
6298 " fprintf(stderr, \" args: %f, %f\\en\",\n"
6299 " exc-E<gt>arg1, exc-E<gt>arg2);\n"
6300 " fprintf(stderr, \" retval: %f\\en\", exc-E<gt>retval);\n"
6304 #: build/C/man3/matherr.3:397
6307 " if (change_retval)\n"
6308 " exc-E<gt>retval = new_retval;\n"
6312 #: build/C/man3/matherr.3:400
6315 " return matherr_ret;\n"
6320 #: build/C/man3/matherr.3:405
6324 "main(int argc, char *argv[])\n"
6330 #: build/C/man3/matherr.3:411
6333 " if (argc E<lt> 2) {\n"
6334 " fprintf(stderr, \"Usage: %s E<lt>argvalE<gt>\"\n"
6335 " \" [E<lt>matherr-retE<gt> "
6336 "[E<lt>new-func-retvalE<gt>]]\\en\", argv[0]);\n"
6337 " exit(EXIT_FAILURE);\n"
6342 #: build/C/man3/matherr.3:416
6345 " if (argc E<gt> 2) {\n"
6346 " _LIB_VERSION = _SVID_;\n"
6347 " matherr_ret = atoi(argv[2]);\n"
6352 #: build/C/man3/matherr.3:421
6355 " if (argc E<gt> 3) {\n"
6356 " change_retval = 1;\n"
6357 " new_retval = atof(argv[3]);\n"
6362 #: build/C/man3/matherr.3:425
6365 " x = log(atof(argv[1]));\n"
6366 " if (errno != 0)\n"
6367 " perror(\"errno\");\n"
6371 #: build/C/man3/matherr.3:429
6374 " printf(\"x=%f\\en\", x);\n"
6375 " exit(EXIT_SUCCESS);\n"
6380 #: build/C/man3/matherr.3:434
6381 msgid "B<fenv>(3), B<math_error>(7), B<standards>(7)"
6385 #: build/C/man3/modf.3:33
6391 #: build/C/man3/modf.3:37
6393 "modf, modff, modfl - extract signed integral and fractional values from "
6394 "floating-point number"
6398 #: build/C/man3/modf.3:42
6400 msgid "B<double modf(double >I<x>B<, double *>I<iptr>B<);>\n"
6404 #: build/C/man3/modf.3:44
6406 msgid "B<float modff(float >I<x>B<, float *>I<iptr>B<);>\n"
6410 #: build/C/man3/modf.3:46
6412 msgid "B<long double modfl(long double >I<x>B<, long double *>I<iptr>B<);>\n"
6416 #: build/C/man3/modf.3:58
6417 msgid "B<modf>(), B<modfl>():"
6421 #: build/C/man3/modf.3:76
6423 "The B<modf>() function breaks the argument I<x> into an integral part and a "
6424 "fractional part, each of which has the same sign as I<x>. The integral part "
6425 "is stored in the location pointed to by I<iptr>."
6429 #: build/C/man3/modf.3:81
6430 msgid "The B<modf>() function returns the fractional part of I<x>."
6434 #: build/C/man3/modf.3:87
6435 msgid "If I<x> is a NaN, a NaN is returned, and I<*iptr> is set to a NaN."
6439 #: build/C/man3/modf.3:93
6441 "If I<x> is positive infinity (negative infinity), +0 (-0) is returned, and "
6442 "I<*iptr> is set to positive infinity (negative infinity)."
6446 #: build/C/man3/modf.3:103
6447 msgid "The B<modf>(), B<modff>(), and B<modfl>() functions are thread-safe."
6451 #: build/C/man3/modf.3:112
6452 msgid "B<frexp>(3), B<ldexp>(3)"
6456 #: build/C/man3/nan.3:11
6462 #: build/C/man3/nan.3:14
6463 msgid "nan, nanf, nanl - return 'Not a Number'"
6467 #: build/C/man3/nan.3:18
6468 msgid "B<double nan(const char *>I<tagp>B<);>"
6472 #: build/C/man3/nan.3:20
6473 msgid "B<float nanf(const char *>I<tagp>B<);>"
6477 #: build/C/man3/nan.3:22
6478 msgid "B<long double nanl(const char *>I<tagp>B<);>"
6482 #: build/C/man3/nan.3:34
6483 msgid "B<nan>(), B<nanf>(), B<nanl>():"
6487 #: build/C/man3/nan.3:48
6489 "These functions return a representation (determined by I<tagp>) of a quiet "
6490 "NaN. If the implementation does not support quiet NaNs, these functions "
6495 #: build/C/man3/nan.3:52
6496 msgid "The call I<nan(\"char-sequence\")> is equivalent to:"
6500 #: build/C/man3/nan.3:55
6502 msgid " strtod(\"NAN(char-sequence)\", NULL);\n"
6506 #: build/C/man3/nan.3:65
6508 "Similarly, calls to B<nanf>() and B<nanl>() are equivalent to analogous "
6509 "calls to B<strtof>(3) and B<strtold>(3)."
6513 #: build/C/man3/nan.3:73
6515 "The argument I<tagp> is used in an unspecified manner. On IEEE 754 systems, "
6516 "there are many representations of NaN, and I<tagp> selects one. On other "
6517 "systems it may do nothing."
6521 #: build/C/man3/nan.3:79
6523 "C99, POSIX.1-2001. See also IEC 559 and the appendix with recommended "
6524 "functions in IEEE 754/IEEE 854."
6528 #: build/C/man3/nan.3:83
6529 msgid "B<isnan>(3), B<strtod>(3), B<math_error>(7)"
6533 #: build/C/man3/nextafter.3:11
6539 #: build/C/man3/nextafter.3:11
6545 #: build/C/man3/nextafter.3:15
6547 "nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl - "
6548 "floating-point number manipulation"
6552 #: build/C/man3/nextafter.3:19
6553 msgid "B<double nextafter(double >I<x>B<, double >I<y>B<);>"
6557 #: build/C/man3/nextafter.3:21
6558 msgid "B<float nextafterf(float >I<x>B<, float >I<y>B<);>"
6562 #: build/C/man3/nextafter.3:23
6563 msgid "B<long double nextafterl(long double >I<x>B<, long double >I<y>B<);>"
6567 #: build/C/man3/nextafter.3:25
6568 msgid "B<double nexttoward(double >I<x>B<, long double >I<y>B<);>"
6572 #: build/C/man3/nextafter.3:27
6573 msgid "B<float nexttowardf(float >I<x>B<, long double >I<y>B<);>"
6577 #: build/C/man3/nextafter.3:29
6578 msgid "B<long double nexttowardl(long double >I<x>B<, long double >I<y>B<);>"
6582 #: build/C/man3/nextafter.3:39
6583 msgid "B<nextafter>():"
6587 #: build/C/man3/nextafter.3:51
6588 msgid "B<nextafterf>(), B<nextafterl>():"
6592 #: build/C/man3/nextafter.3:62
6593 msgid "B<nexttoward>(), B<nexttowardf>(), B<nexttowardl>():"
6597 #: build/C/man3/nextafter.3:86
6599 "The B<nextafter>(), B<nextafterf>(), and B<nextafterl>() functions return "
6600 "the next representable floating-point value following I<x> in the direction "
6601 "of I<y>. If I<y> is less than I<x>, these functions will return the largest "
6602 "representable number less than I<x>."
6606 #: build/C/man3/nextafter.3:93
6607 msgid "If I<x> equals I<y>, the functions return I<y>."
6611 #: build/C/man3/nextafter.3:104
6613 "The B<nexttoward>(), B<nexttowardf>(), and B<nexttowardl>() functions do "
6614 "the same as the corresponding B<nextafter>() functions, except that they "
6615 "have a I<long double> second argument."
6619 #: build/C/man3/nextafter.3:110
6621 "On success, these functions return the next representable floating-point "
6622 "value after I<x> in the direction of I<y>."
6626 #: build/C/man3/nextafter.3:120
6627 msgid "If I<x> equals I<y>, then I<y> (cast to the same type as I<x>) is returned."
6632 #: build/C/man3/nextafter.3:140
6634 "If I<x> is finite, and the result would overflow, a range error occurs, and "
6635 "the functions return B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, "
6636 "respectively, with the correct mathematical sign."
6640 #: build/C/man3/nextafter.3:149
6642 "If I<x> is not equal to I<y>, and the correct function result would be "
6643 "subnormal, zero, or underflow, a range error occurs, and either the correct "
6644 "value (if it can be represented), or 0.0, is returned."
6648 #: build/C/man3/nextafter.3:165
6650 msgid "Range error: result is subnormal or underflows"
6654 #: build/C/man3/nextafter.3:190
6656 "The B<nextafter>(), B<nextafterf>(), B<nextafterl>(), B<nexttoward>(), "
6657 "B<nexttowardf>(), and B<nexttowardl>() functions are thread-safe."
6661 #: build/C/man3/nextafter.3:199
6663 "In glibc version 2.5 and earlier, these functions do not raise an underflow "
6664 "floating-point (B<FE_UNDERFLOW>) exception when an underflow occurs."
6668 #: build/C/man3/nextafter.3:201
6669 msgid "B<nearbyint>(3)"
6673 #: build/C/man3/pow.3:35
6679 #: build/C/man3/pow.3:38
6680 msgid "pow, powf, powl - power functions"
6684 #: build/C/man3/pow.3:43
6686 msgid "B<double pow(double >I<x>B<, double >I<y>B<);>\n"
6690 #: build/C/man3/pow.3:45
6692 msgid "B<float powf(float >I<x>B<, float >I<y>B<);>\n"
6696 #: build/C/man3/pow.3:47
6698 msgid "B<long double powl(long double >I<x>B<, long double >I<y>B<);>\n"
6702 #: build/C/man3/pow.3:59
6703 msgid "B<powf>(), B<powl>():"
6707 #: build/C/man3/pow.3:75
6709 "The B<pow>() function returns the value of I<x> raised to the power of "
6714 #: build/C/man3/pow.3:80
6715 msgid "On success, these functions return the value of I<x> to the power of I<y>."
6718 #. The domain error is generated at least as far back as glibc 2.4
6720 #: build/C/man3/pow.3:88
6722 "If I<x> is a finite value less than 0, and I<y> is a finite noninteger, a "
6723 "domain error occurs, and a NaN is returned."
6726 #. The range error is generated at least as far back as glibc 2.4
6728 #: build/C/man3/pow.3:98
6730 "If the result overflows, a range error occurs, and the functions return "
6731 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the "
6732 "mathematically correct sign."
6735 #. POSIX.1 does not specify the sign of the zero,
6736 #. but http://sources.redhat.com/bugzilla/show_bug.cgi?id=2678
6737 #. points out that the zero has the wrong sign in some cases.
6739 #: build/C/man3/pow.3:105
6741 "If result underflows, and is not representable, a range error occurs, and "
6746 #: build/C/man3/pow.3:111
6747 msgid "Except as specified below, if I<x> or I<y> is a NaN, the result is a NaN."
6751 #: build/C/man3/pow.3:117
6752 msgid "If I<x> is +1, the result is 1.0 (even if I<y> is a NaN)."
6756 #: build/C/man3/pow.3:123
6757 msgid "If I<y> is 0, the result is 1.0 (even if I<x> is a NaN)."
6761 #: build/C/man3/pow.3:131
6763 "If I<x> is +0 (-0), and I<y> is an odd integer greater than 0, the result is "
6768 #: build/C/man3/pow.3:139
6770 "If I<x> is 0, and I<y> greater than 0 and not an odd integer, the result is "
6775 #: build/C/man3/pow.3:147
6777 "If I<x> is -1, and I<y> is positive infinity or negative infinity, the "
6782 #: build/C/man3/pow.3:155
6784 "If the absolute value of I<x> is less than 1, and I<y> is negative infinity, "
6785 "the result is positive infinity."
6789 #: build/C/man3/pow.3:163
6791 "If the absolute value of I<x> is greater than 1, and I<y> is negative "
6792 "infinity, the result is +0."
6796 #: build/C/man3/pow.3:171
6798 "If the absolute value of I<x> is less than 1, and I<y> is positive infinity, "
6803 #: build/C/man3/pow.3:179
6805 "If the absolute value of I<x> is greater than 1, and I<y> is positive "
6806 "infinity, the result is positive infinity."
6810 #: build/C/man3/pow.3:187
6812 "If I<x> is negative infinity, and I<y> is an odd integer less than 0, the "
6817 #: build/C/man3/pow.3:195
6819 "If I<x> is negative infinity, and I<y> less than 0 and not an odd integer, "
6824 #: build/C/man3/pow.3:203
6826 "If I<x> is negative infinity, and I<y> is an odd integer greater than 0, the "
6827 "result is negative infinity."
6831 #: build/C/man3/pow.3:211
6833 "If I<x> is negative infinity, and I<y> greater than 0 and not an odd "
6834 "integer, the result is positive infinity."
6838 #: build/C/man3/pow.3:219
6839 msgid "If I<x> is positive infinity, and I<y> less than 0, the result is +0."
6843 #: build/C/man3/pow.3:227
6845 "If I<x> is positive infinity, and I<y> greater than 0, the result is "
6846 "positive infinity."
6850 #: build/C/man3/pow.3:242
6852 "If I<x> is +0 or -0, and I<y> is an odd integer less than 0, a pole error "
6853 "occurs and B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, is returned, with the "
6854 "same sign as I<x>."
6857 #. The pole error is generated at least as far back as glibc 2.4
6859 #: build/C/man3/pow.3:256
6861 "If I<x> is +0 or -0, and I<y> is less than 0 and not an odd integer, a pole "
6862 "error occurs and +B<HUGE_VAL>, +B<HUGE_VALF>, or +B<HUGE_VALL>, is returned."
6866 #: build/C/man3/pow.3:283
6868 msgid "Domain error: I<x> is negative, and I<y> is a finite noninteger"
6872 #: build/C/man3/pow.3:291
6874 msgid "Pole error: I<x> is zero, and I<y> is negative"
6878 #: build/C/man3/pow.3:300
6880 msgid "Range error: the result overflows"
6884 #: build/C/man3/pow.3:308
6886 msgid "Range error: the result underflows"
6890 #. https://sourceware.org/bugzilla/show_bug.cgi?id=13932
6892 #: build/C/man3/pow.3:335
6894 "On 64-bits, B<pow>() may be more than 10,000 times slower for some (rare) "
6895 "inputs than for other nearby inputs. This only affects B<pow>(), and not "
6896 "B<powf>() nor B<powl>()."
6900 #. http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776
6901 #. or possibly 2.9, I haven't found the source code change
6902 #. and I don't have a 2.9 system to test
6904 #: build/C/man3/pow.3:349
6906 "In glibc 2.9 and earlier, when a pole error occurs, I<errno> is set to "
6907 "B<EDOM> instead of the POSIX-mandated B<ERANGE>. Since version 2.10, glibc "
6908 "does the right thing."
6911 #. see bug http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866
6912 #. and http://sources.redhat.com/bugzilla/show_bug.cgi?id=369
6914 #: build/C/man3/pow.3:369
6916 "If I<x> is negative, then large negative or positive I<y> values yield a NaN "
6917 "as the function result, with I<errno> set to B<EDOM>, and an invalid "
6918 "(B<FE_INVALID>) floating-point exception. For example, with B<pow>(), one "
6919 "sees this behavior when the absolute value of I<y> is greater than about "
6923 #. FIXME . Actually, 2.3.2 is the earliest test result I have; so yet
6924 #. to confirm if this error occurs only in 2.3.2.
6926 #: build/C/man3/pow.3:378
6928 "In version 2.3.2 and earlier, when an overflow or underflow error occurs, "
6929 "glibc's B<pow>() generates a bogus invalid floating-point exception "
6930 "(B<FE_INVALID>) in addition to the overflow or underflow exception."
6934 #: build/C/man3/pow.3:382
6935 msgid "B<cbrt>(3), B<cpow>(3), B<sqrt>(3)"
6939 #: build/C/man3/pow10.3:25
6945 #: build/C/man3/pow10.3:28
6946 msgid "pow10, pow10f, pow10l - base-10 power functions"
6950 #: build/C/man3/pow10.3:32 build/C/man3/sincos.3:16
6953 "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n"
6954 "B<#include E<lt>math.hE<gt>>\n"
6958 #: build/C/man3/pow10.3:34
6960 msgid "B<double pow10(double >I<x>B<);>\n"
6964 #: build/C/man3/pow10.3:36
6966 msgid "B<float pow10f(float >I<x>B<);>\n"
6970 #: build/C/man3/pow10.3:38
6972 msgid "B<long double pow10l(long double >I<x>B<);>\n"
6976 #: build/C/man3/pow10.3:47
6977 msgid "The B<pow10>() function returns the value of 10 raised to the power I<x>."
6981 #: build/C/man3/pow10.3:51
6982 msgid "This is a GNU extension."
6986 #: build/C/man3/pow10.3:54
6987 msgid "These functions are identical to the functions listed under B<exp10>(3)."
6991 #: build/C/man3/pow10.3:57
6992 msgid "B<exp10>(3), B<pow>(3)"
6996 #: build/C/man3/remainder.3:37
7002 #: build/C/man3/remainder.3:41
7004 "drem, dremf, dreml, remainder, remainderf, remainderl - floating-point "
7005 "remainder function"
7009 #: build/C/man3/remainder.3:49
7012 "/* The C99 versions */\n"
7013 "B<double remainder(double >I<x>B<, double >I<y>B<);>\n"
7014 "B<float remainderf(float >I<x>B<, float >I<y>B<);>\n"
7015 "B<long double remainderl(long double >I<x>B<, long double >I<y>B<);>\n"
7019 #: build/C/man3/remainder.3:54
7022 "/* Obsolete synonyms */\n"
7023 "B<double drem(double >I<x>B<, double >I<y>B<);>\n"
7024 "B<float dremf(float >I<x>B<, float >I<y>B<);>\n"
7025 "B<long double dreml(long double >I<x>B<, long double >I<y>B<);>\n"
7029 #: build/C/man3/remainder.3:65
7030 msgid "B<remainder>():"
7034 #: build/C/man3/remainder.3:70
7036 "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7037 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || "
7038 "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
7042 #: build/C/man3/remainder.3:77
7043 msgid "B<remainderf>(), B<remainderl>():"
7047 #: build/C/man3/remainder.3:88
7048 msgid "B<drem>(), B<dremf>(), B<dreml>():"
7052 #: build/C/man3/remainder.3:90 build/C/man3/significand.3:35
7053 msgid "_SVID_SOURCE || _BSD_SOURCE"
7057 #: build/C/man3/remainder.3:111
7059 "The B<remainder>() function computes the remainder of dividing I<x> by "
7060 "I<y>. The return value is I<x>-I<n>*I<y>, where I<n> is the value I<x\\ /\\ "
7061 "y>, rounded to the nearest integer. If the absolute value of I<x>-I<n>*I<y> "
7062 "is 0.5, I<n> is chosen to be even."
7066 #: build/C/man3/remainder.3:114
7068 "These functions are unaffected by the current rounding mode (see "
7073 #: build/C/man3/remainder.3:118
7074 msgid "The B<drem>() function does precisely the same thing."
7078 #: build/C/man3/remainder.3:124
7080 "On success, these functions return the floating-point remainder, "
7081 "I<x>-I<n>*I<y>. If the return value is 0, it has the sign of I<x>."
7085 #: build/C/man3/remainder.3:139 build/C/man3/remquo.3:92
7087 "If I<x> is an infinity, and I<y> is not a NaN, a domain error occurs, and a "
7092 #: build/C/man3/remainder.3:150 build/C/man3/remquo.3:101
7094 "If I<y> is zero, and I<x> is not a NaN, a domain error occurs, and a NaN is "
7099 #: build/C/man3/remainder.3:157
7101 msgid "Domain error: I<x> is an infinity and I<y> is not a NaN"
7106 #: build/C/man3/remainder.3:188
7108 "The functions B<remainder>(), B<remainderf>(), and B<remainderl>() are "
7109 "specified in C99 and POSIX.1-2001."
7113 #: build/C/man3/remainder.3:204
7115 "The function B<drem>() is from 4.3BSD. The I<float> and I<long double> "
7116 "variants B<dremf>() and B<dreml>() exist on some systems, such as Tru64 "
7117 "and glibc2. Avoid the use of these functions in favor of B<remainder>() "
7122 #: build/C/man3/remainder.3:206
7127 #: build/C/man3/remainder.3:208
7129 msgid " remainder(nan(\"\"), 0);\n"
7132 #. FIXME . this bug occurs as at glibc 2.8.
7133 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6779
7135 #: build/C/man3/remainder.3:213
7137 "returns a NaN, as expected, but wrongly causes a domain error; it should "
7138 "yield a silent NaN."
7142 #: build/C/man3/remainder.3:215
7143 msgid "The call \"remainder(29.0, 3.0)\" returns -1."
7147 #: build/C/man3/remainder.3:219
7148 msgid "B<div>(3), B<fmod>(3), B<remquo>(3)"
7152 #: build/C/man3/remquo.3:12
7158 #: build/C/man3/remquo.3:12
7164 #: build/C/man3/remquo.3:15
7165 msgid "remquo, remquof, remquol - remainder and part of quotient"
7169 #: build/C/man3/remquo.3:20
7171 msgid "B<double remquo(double >I<x>B<, double >I<y>B<, int *>I<quo>B<);>\n"
7175 #: build/C/man3/remquo.3:22
7177 msgid "B<float remquof(float >I<x>B<, float >I<y>B<, int *>I<quo>B<);>\n"
7181 #: build/C/man3/remquo.3:24
7184 "B<long double remquol(long double >I<x>B<, long double >I<y>B<, int "
7189 #: build/C/man3/remquo.3:37
7190 msgid "B<remquo>(), B<remquof>(), B<remquol>():"
7194 #: build/C/man3/remquo.3:55
7196 "These functions compute the remainder and part of the quotient upon division "
7197 "of I<x> by I<y>. A few bits of the quotient are stored via the I<quo> "
7198 "pointer. The remainder is returned as the function result."
7202 #: build/C/man3/remquo.3:59
7204 "The value of the remainder is the same as that computed by the "
7205 "B<remainder>(3) function."
7209 #: build/C/man3/remquo.3:65
7211 "The value stored via the I<quo> pointer has the sign of I<x\\ /\\ y> and "
7212 "agrees with the quotient in at least the low order 3 bits."
7215 #. A possible application of this function might be the computation
7216 #. of sin(x). Compute remquo(x, pi/2, &quo) or so.
7218 #. glibc, UnixWare: return 3 bits
7219 #. MacOS 10: return 7 bits
7221 #: build/C/man3/remquo.3:73
7223 "For example, I<remquo(29.0,\\ 3.0)> returns -1.0 and might store 2. Note "
7224 "that the actual quotient might not fit in an integer."
7228 #: build/C/man3/remquo.3:77
7230 "On success, these functions return the same value as the analogous functions "
7231 "described in B<remainder>(3)."
7235 #: build/C/man3/remquo.3:108
7238 "Domain error: I<x> is an infinity or I<y> is 0, and the other argument is "
7243 #: build/C/man3/remquo.3:132
7244 msgid "The B<remquo>(), B<remquof>(), and B<remquol>() functions are thread-safe."
7248 #: build/C/man3/remquo.3:138
7249 msgid "B<fmod>(3), B<logb>(3), B<remainder>(3)"
7253 #: build/C/man3/rint.3:27
7259 #: build/C/man3/rint.3:31
7261 "nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - round to nearest "
7266 #: build/C/man3/rint.3:36
7268 msgid "B<double nearbyint(double >I<x>B<);>\n"
7272 #: build/C/man3/rint.3:38
7274 msgid "B<float nearbyintf(float >I<x>B<);>\n"
7278 #: build/C/man3/rint.3:40
7280 msgid "B<long double nearbyintl(long double >I<x>B<);>\n"
7284 #: build/C/man3/rint.3:42
7286 msgid "B<double rint(double >I<x>B<);>\n"
7290 #: build/C/man3/rint.3:44
7292 msgid "B<float rintf(float >I<x>B<);>\n"
7296 #: build/C/man3/rint.3:46
7298 msgid "B<long double rintl(long double >I<x>B<);>\n"
7302 #: build/C/man3/rint.3:59
7303 msgid "B<nearbyint>(), B<nearbyintf>(), B<nearbyintl>():"
7307 #: build/C/man3/rint.3:61
7309 "_XOPEN_SOURCE\\ E<gt>=\\ 600 || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L || "
7314 #: build/C/man3/rint.3:67
7319 #: build/C/man3/rint.3:78
7320 msgid "B<rintf>(), B<rintl>():"
7324 #: build/C/man3/rint.3:98
7326 "The B<nearbyint>(), B<nearbyintf>(), and B<nearbyintl>() functions round "
7327 "their argument to an integer value in floating-point format, using the "
7328 "current rounding direction (see B<fesetround>(3)) and without raising the "
7329 "I<inexact> exception."
7333 #: build/C/man3/rint.3:111
7335 "The B<rint>(), B<rintf>(), and B<rintl>() functions do the same, but will "
7336 "raise the I<inexact> exception (B<FE_INEXACT>, checkable via "
7337 "B<fetestexcept>(3)) when the result differs in value from the argument."
7341 #: build/C/man3/rint.3:133
7343 "The B<nearbyint>(), B<nearbyintf>(), B<nearbyintl>(), B<rint>(), B<rintf>(), "
7344 "and B<rintl>() functions are thread-safe."
7348 #: build/C/man3/rint.3:155
7350 "If you want to store the rounded value in an integer type, you probably want "
7351 "to use one of the functions described in B<lrint>(3) instead."
7355 #: build/C/man3/rint.3:161
7356 msgid "B<ceil>(3), B<floor>(3), B<lrint>(3), B<round>(3), B<trunc>(3)"
7360 #: build/C/man3/round.3:27
7366 #: build/C/man3/round.3:30
7367 msgid "round, roundf, roundl - round to nearest integer, away from zero"
7371 #: build/C/man3/round.3:35
7373 msgid "B<double round(double >I<x>B<);>\n"
7377 #: build/C/man3/round.3:37
7379 msgid "B<float roundf(float >I<x>B<);>\n"
7383 #: build/C/man3/round.3:39
7385 msgid "B<long double roundl(long double >I<x>B<);>\n"
7389 #: build/C/man3/round.3:52
7390 msgid "B<round>(), B<roundf>(), B<roundl>():"
7394 #: build/C/man3/round.3:69
7396 "These functions round I<x> to the nearest integer, but round halfway cases "
7397 "away from zero (regardless of the current rounding direction, see "
7398 "B<fenv>(3)), instead of to the nearest even integer like B<rint>(3)."
7402 #: build/C/man3/round.3:75
7403 msgid "For example, I<round(0.5)> is 1.0, and I<round(-0.5)> is -1.0."
7407 #: build/C/man3/round.3:96
7408 msgid "The B<round>(), B<roundf>(), and B<roundl>() functions are thread-safe."
7411 #. The POSIX.1-2001 APPLICATION USAGE SECTION discusses this point.
7413 #: build/C/man3/round.3:114
7415 "POSIX.1-2001 contains text about overflow (which might set I<errno> to "
7416 "B<ERANGE>, or raise an B<FE_OVERFLOW> exception). In practice, the result "
7417 "cannot overflow on any current machine, so this error-handling stuff is just "
7418 "nonsense. (More precisely, overflow can happen only when the maximum value "
7419 "of the exponent is smaller than the number of mantissa bits. For the "
7420 "IEEE-754 standard 32-bit and 64-bit floating-point numbers the maximum value "
7421 "of the exponent is 128 (respectively, 1024), and the number of mantissa bits "
7422 "is 24 (respectively, 53).)"
7426 #: build/C/man3/round.3:119
7428 "If you want to store the rounded value in an integer type, you probably want "
7429 "to use one of the functions described in B<lround>(3) instead."
7433 #: build/C/man3/round.3:126
7435 "B<ceil>(3), B<floor>(3), B<lround>(3), B<nearbyint>(3), B<rint>(3), "
7440 #: build/C/man3/scalb.3:27
7446 #: build/C/man3/scalb.3:27
7452 #: build/C/man3/scalb.3:31
7454 "scalb, scalbf, scalbl - multiply floating-point number by integral power of "
7459 #: build/C/man3/scalb.3:35
7460 msgid "B<double scalb(double >I<x>B<, double >I<exp>B<);>"
7464 #: build/C/man3/scalb.3:37
7465 msgid "B<float scalbf(float >I<x>B<, float >I<exp>B<);>"
7469 #: build/C/man3/scalb.3:39
7470 msgid "B<long double scalbl(long double >I<x>B<, long double >I<exp>B<);>"
7474 #: build/C/man3/scalb.3:49
7479 #: build/C/man3/scalb.3:52
7481 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7482 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
7486 #: build/C/man3/scalb.3:56
7487 msgid "B<scalbf>(), B<scalbl>():"
7491 #: build/C/man3/scalb.3:69 build/C/man3/scalbln.3:85
7493 "These functions multiply their first argument I<x> by B<FLT_RADIX> (probably "
7494 "2) to the power of I<exp>, that is:"
7498 #: build/C/man3/scalb.3:72 build/C/man3/scalbln.3:88
7500 msgid " x * FLT_RADIX ** exp\n"
7503 #. not in /usr/include but in a gcc lib
7505 #: build/C/man3/scalb.3:79 build/C/man3/scalbln.3:95
7507 "The definition of B<FLT_RADIX> can be obtained by including "
7508 "I<E<lt>float.hE<gt>>."
7512 #: build/C/man3/scalb.3:86 build/C/man3/scalbln.3:102
7513 msgid "On success, these functions return I<x> * B<FLT_RADIX> ** I<exp>."
7517 #: build/C/man3/scalb.3:92
7518 msgid "If I<x> or I<exp> is a NaN, a NaN is returned."
7522 #: build/C/man3/scalb.3:100
7524 "If I<x> is positive infinity (negative infinity), and I<exp> is not negative "
7525 "infinity, positive infinity (negative infinity) is returned."
7529 #: build/C/man3/scalb.3:106
7531 "If I<x> is +0 (-0), and I<exp> is not positive infinity, +0 (-0) is "
7536 #: build/C/man3/scalb.3:114
7538 "If I<x> is zero, and I<exp> is positive infinity, a domain error occurs, and "
7539 "a NaN is returned."
7543 #: build/C/man3/scalb.3:123
7545 "If I<x> is an infinity, and I<exp> is negative infinity, a domain error "
7546 "occurs, and a NaN is returned."
7550 #: build/C/man3/scalb.3:138 build/C/man3/scalbln.3:130
7552 "If the result underflows, a range error occurs, and the functions return "
7553 "zero, with a sign the same as I<x>."
7557 #: build/C/man3/scalb.3:145
7560 "Domain error: I<x> is 0, and I<exp> is positive infinity, or I<x> is "
7561 "positive infinity and I<exp> is negative infinity and the other argument is "
7566 #: build/C/man3/scalb.3:191
7568 "B<scalb>() is specified in POSIX.1-2001, but marked obsolescent. "
7569 "POSIX.1-2008 removes the specification of B<scalb>(), recommending the use "
7570 "of B<scalbln>(3), B<scalblnf>(3), or B<scalblnl>(3) instead. The "
7571 "B<scalb>() function is from 4.3BSD."
7574 #. Looking at header files: scalbf() is present on the
7575 #. BSDs, Tru64, HP-UX 11, Irix 6.5; scalbl() is on HP-UX 11 and Tru64.
7577 #: build/C/man3/scalb.3:200
7579 "B<scalbf>() and B<scalbl>() are unstandardized; B<scalbf>() is "
7580 "nevertheless present on several other systems"
7584 #: build/C/man3/scalb.3:203
7585 msgid "B<ldexp>(3), B<scalbln>(3)"
7589 #: build/C/man3/scalbln.3:27
7595 #: build/C/man3/scalbln.3:31
7597 "scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl - multiply "
7598 "floating-point number by integral power of radix"
7602 #: build/C/man3/scalbln.3:35
7603 msgid "B<double scalbln(double >I<x>B<, long int >I<exp>B<);>"
7607 #: build/C/man3/scalbln.3:37
7608 msgid "B<float scalblnf(float >I<x>B<, long int >I<exp>B<);>"
7612 #: build/C/man3/scalbln.3:39
7613 msgid "B<long double scalblnl(long double >I<x>B<, long int >I<exp>B<);>"
7617 #: build/C/man3/scalbln.3:41
7618 msgid "B<double scalbn(double >I<x>B<, int >I<exp>B<);>"
7622 #: build/C/man3/scalbln.3:43
7623 msgid "B<float scalbnf(float >I<x>B<, int >I<exp>B<);>"
7627 #: build/C/man3/scalbln.3:45
7628 msgid "B<long double scalbnl(long double >I<x>B<, int >I<exp>B<);>"
7632 #: build/C/man3/scalbln.3:57
7633 msgid "B<scalbln>(), B<scalblnf>(), B<scalblnl>():"
7637 #: build/C/man3/scalbln.3:68
7638 msgid "B<scalbn>(), B<scalbnf>(), B<scalbnl>():"
7642 #: build/C/man3/scalbln.3:171
7644 "The B<scalbn>(), B<scalbnf>(), B<scalbnl>(), B<scalbln>(), B<scalblnf>(), "
7645 "and B<scalblnl>() functions are thread-safe."
7649 #: build/C/man3/scalbln.3:182
7651 "These functions differ from the obsolete functions described in B<scalb>(3) "
7652 "in the type of their second argument. The functions described on this page "
7653 "have a second argument of an integral type, while those in B<scalb>(3) have "
7654 "a second argument of type I<double>."
7658 #: build/C/man3/scalbln.3:189
7660 "If B<FLT_RADIX> equals 2 (which is usual), then B<scalbn>() is equivalent "
7665 #: build/C/man3/scalbln.3:192
7666 msgid "B<ldexp>(3), B<scalb>(3)"
7670 #: build/C/man3/signbit.3:11
7676 #: build/C/man3/signbit.3:11
7682 #: build/C/man3/signbit.3:14
7683 msgid "signbit - test sign of a real floating-point number"
7687 #: build/C/man3/signbit.3:18
7688 msgid "B<int signbit(>I<x>B<);>"
7692 #: build/C/man3/signbit.3:28
7693 msgid "B<signbit>():"
7697 #: build/C/man3/signbit.3:42
7699 "B<signbit>() is a generic macro which can work on all real floating-point "
7700 "types. It returns a nonzero value if the value of I<x> has its sign bit "
7705 #: build/C/man3/signbit.3:51
7707 "This is not the same as I<x E<lt> 0.0>, because IEEE 754 floating point "
7708 "allows zero to be signed. The comparison I<-0.0 E<lt> 0.0> is false, but "
7709 "I<signbit(-0.0)> will return a nonzero value."
7713 #: build/C/man3/signbit.3:53
7714 msgid "NaNs and infinities have a sign bit."
7718 #: build/C/man3/signbit.3:59
7720 "The B<signbit>() macro returns nonzero if the sign of I<x> is negative; "
7721 "otherwise it returns zero."
7725 #: build/C/man3/signbit.3:66
7726 msgid "The B<signbit>() macro is thread-safe."
7730 #: build/C/man3/signbit.3:72
7731 msgid "B<copysign>(3)"
7735 #: build/C/man3/significand.3:9
7741 #: build/C/man3/significand.3:9
7747 #: build/C/man3/significand.3:13
7749 "significand, significandf, significandl - get mantissa of floating-point "
7754 #: build/C/man3/significand.3:17
7755 msgid "B<double significand(double >I<x>B<);>"
7759 #: build/C/man3/significand.3:19
7760 msgid "B<float significandf(float >I<x>B<);>"
7764 #: build/C/man3/significand.3:21
7765 msgid "B<long double significandl(long double >I<x>B<);>"
7769 #: build/C/man3/significand.3:33
7770 msgid "B<significand>(), B<significandf>(), B<significandl>():"
7774 #: build/C/man3/significand.3:44
7776 "The B<significand>() function returns the mantissa of I<x> scaled to the "
7777 "range [1,2). It is equivalent to"
7781 #: build/C/man3/significand.3:47
7782 msgid "scalb(x, (double) -ilogb(x))"
7786 #: build/C/man3/significand.3:51
7788 "This function exists mainly for use in certain standardized tests for IEEE "
7793 #. This function came from BSD.
7795 #: build/C/man3/significand.3:57
7797 "These functions are nonstandard; the I<double> version is available on a "
7798 "number of other systems."
7802 #: build/C/man3/significand.3:60
7803 msgid "B<ilogb>(3), B<scalb>(3)"
7807 #: build/C/man3/sin.3:35
7813 #: build/C/man3/sin.3:35
7819 #: build/C/man3/sin.3:38
7820 msgid "sin, sinf, sinl - sine function"
7824 #: build/C/man3/sin.3:43
7826 msgid "B<double sin(double >I<x>B<);>\n"
7830 #: build/C/man3/sin.3:45
7832 msgid "B<float sinf(float >I<x>B<);>\n"
7836 #: build/C/man3/sin.3:47
7838 msgid "B<long double sinl(long double >I<x>B<);>\n"
7842 #: build/C/man3/sin.3:59
7843 msgid "B<sinf>(), B<sinl>():"
7847 #: build/C/man3/sin.3:76
7849 "The B<sin>() function returns the sine of I<x>, where I<x> is given in "
7854 #: build/C/man3/sin.3:79
7855 msgid "On success, these functions return the sine of I<x>."
7859 #: build/C/man3/sin.3:116
7860 msgid "The B<sin>(), B<sinf>(), and B<sinl>() functions are thread-safe."
7864 #: build/C/man3/sin.3:138
7866 "B<acos>(3), B<asin>(3), B<atan>(3), B<atan2>(3), B<cos>(3), B<csin>(3), "
7867 "B<sincos>(3), B<tan>(3)"
7871 #: build/C/man3/sincos.3:9
7877 #: build/C/man3/sincos.3:9
7883 #: build/C/man3/sincos.3:12
7884 msgid "sincos, sincosf, sincosl - calculate sin and cos simultaneously"
7888 #: build/C/man3/sincos.3:18
7890 msgid "B<void sincos(double >I<x>B<, double *>I<sin>B<, double *>I<cos>B<);>\n"
7894 #: build/C/man3/sincos.3:20
7896 msgid "B<void sincosf(float >I<x>B<, float *>I<sin>B<, float *>I<cos>B<);>\n"
7900 #: build/C/man3/sincos.3:22
7903 "B<void sincosl(long double >I<x>B<, long double *>I<sin>B<, long double "
7908 #: build/C/man3/sincos.3:32
7910 "Several applications need sine and cosine of the same angle I<x>. This "
7911 "function computes both at the same time, and stores the results in I<*sin> "
7916 #: build/C/man3/sincos.3:40
7917 msgid "If I<x> is a NaN, a NaN is returned in I<*sin> and I<*cos>."
7921 #: build/C/man3/sincos.3:49
7923 "If I<x> is positive infinity or negative infinity, a domain error occurs, "
7924 "and a NaN is returned in I<*sin> and I<*cos>."
7928 #: build/C/man3/sincos.3:52
7929 msgid "These functions return I<void>."
7933 #: build/C/man3/sincos.3:84
7934 msgid "The B<sincos>(), B<sincosf>(), and B<sincosl>() functions are thread-safe."
7938 #: build/C/man3/sincos.3:86
7939 msgid "This function is a GNU extension."
7943 #: build/C/man3/sincos.3:90
7944 msgid "B<cos>(3), B<sin>(3), B<tan>(3)"
7948 #: build/C/man3/sinh.3:36
7954 #: build/C/man3/sinh.3:39
7955 msgid "sinh, sinhf, sinhl - hyperbolic sine function"
7959 #: build/C/man3/sinh.3:44
7961 msgid "B<double sinh(double >I<x>B<);>\n"
7965 #: build/C/man3/sinh.3:46
7967 msgid "B<float sinhf(float >I<x>B<);>\n"
7971 #: build/C/man3/sinh.3:48
7973 msgid "B<long double sinhl(long double >I<x>B<);>\n"
7977 #: build/C/man3/sinh.3:60
7978 msgid "B<sinhf>(), B<sinhl>():"
7982 #: build/C/man3/sinh.3:75
7984 "The B<sinh>() function returns the hyperbolic sine of I<x>, which is "
7985 "defined mathematically as:"
7989 #: build/C/man3/sinh.3:78
7991 msgid " sinh(x) = (exp(x) - exp(-x)) / 2\n"
7995 #: build/C/man3/sinh.3:82
7996 msgid "On success, these functions return the hyperbolic sine of I<x>."
8000 #. POSIX.1-2001 documents an optional range error (underflow)
8002 #. glibc 2.8 does not do this.
8004 #: build/C/man3/sinh.3:109
8006 "If the result overflows, a range error occurs, and the functions return "
8007 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the same sign "
8012 #: build/C/man3/sinh.3:137
8013 msgid "B<acosh>(3), B<asinh>(3), B<atanh>(3), B<cosh>(3), B<csinh>(3), B<tanh>(3)"
8017 #: build/C/man3/sqrt.3:34
8023 #: build/C/man3/sqrt.3:37
8024 msgid "sqrt, sqrtf, sqrtl - square root function"
8028 #: build/C/man3/sqrt.3:42
8030 msgid "B<double sqrt(double >I<x>B<);>\n"
8034 #: build/C/man3/sqrt.3:44
8036 msgid "B<float sqrtf(float >I<x>B<);>\n"
8040 #: build/C/man3/sqrt.3:46
8042 msgid "B<long double sqrtl(long double >I<x>B<);>\n"
8046 #: build/C/man3/sqrt.3:58
8047 msgid "B<sqrtf>(), B<sqrtl>():"
8051 #: build/C/man3/sqrt.3:71
8052 msgid "The B<sqrt>() function returns the nonnegative square root of I<x>."
8056 #: build/C/man3/sqrt.3:74
8057 msgid "On success, these functions return the square root of I<x>."
8061 #: build/C/man3/sqrt.3:92
8062 msgid "If I<x> is less than -0, a domain error occurs, and a NaN is returned."
8066 #: build/C/man3/sqrt.3:99
8068 msgid "Domain error: I<x> less than -0"
8072 #: build/C/man3/sqrt.3:117
8073 msgid "B<cbrt>(3), B<csqrt>(3), B<hypot>(3)"
8077 #: build/C/man3/tan.3:35
8083 #: build/C/man3/tan.3:35
8089 #: build/C/man3/tan.3:38
8090 msgid "tan, tanf, tanl - tangent function"
8094 #: build/C/man3/tan.3:43
8096 msgid "B<double tan(double >I<x>B<);>\n"
8100 #: build/C/man3/tan.3:45
8102 msgid "B<float tanf(float >I<x>B<);>\n"
8106 #: build/C/man3/tan.3:47
8108 msgid "B<long double tanl(long double >I<x>B<);>\n"
8112 #: build/C/man3/tan.3:59
8113 msgid "B<tanf>(), B<tanl>():"
8117 #: build/C/man3/tan.3:76
8119 "The B<tan>() function returns the tangent of I<x>, where I<x> is given in "
8124 #: build/C/man3/tan.3:79
8125 msgid "On success, these functions return the tangent of I<x>."
8128 #. I think overflow can't occur, because the closest floating-point
8129 #. representation of pi/2 is still not close enough to pi/2 to
8130 #. produce a large enough value to overflow.
8131 #. Testing certainly seems to bear this out. -- mtk, Jul 08
8133 #. POSIX.1 allows an optional underflow error;
8134 #. glibc 2.8 doesn't do this
8135 #. POSIX.1 an optional range error for subnormal x;
8136 #. glibc 2.8 doesn't do this
8138 #: build/C/man3/tan.3:107
8140 "If the correct result would overflow, a range error occurs, and the "
8141 "functions return B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, "
8142 "with the mathematically correct sign."
8146 #: build/C/man3/tan.3:141
8147 msgid "The B<tan>(), B<tanf>(), and B<tanl>() functions are thread-safe."
8151 #: build/C/man3/tan.3:162
8153 "B<acos>(3), B<asin>(3), B<atan>(3), B<atan2>(3), B<cos>(3), B<ctan>(3), "
8158 #: build/C/man3/tanh.3:35
8164 #: build/C/man3/tanh.3:35
8170 #: build/C/man3/tanh.3:38
8171 msgid "tanh, tanhf, tanhl - hyperbolic tangent function"
8175 #: build/C/man3/tanh.3:43
8177 msgid "B<double tanh(double >I<x>B<);>\n"
8181 #: build/C/man3/tanh.3:45
8183 msgid "B<float tanhf(float >I<x>B<);>\n"
8187 #: build/C/man3/tanh.3:47
8189 msgid "B<long double tanhl(long double >I<x>B<);>\n"
8193 #: build/C/man3/tanh.3:59
8194 msgid "B<tanhf>(), B<tanhl>():"
8198 #: build/C/man3/tanh.3:74
8200 "The B<tanh>() function returns the hyperbolic tangent of I<x>, which is "
8201 "defined mathematically as:"
8205 #: build/C/man3/tanh.3:77
8207 msgid " tanh(x) = sinh(x) / cosh(x)\n"
8211 #: build/C/man3/tanh.3:81
8212 msgid "On success, these functions return the hyperbolic tangent of I<x>."
8216 #: build/C/man3/tanh.3:108
8217 msgid "The B<tanh>(), B<tanhf>(), and B<tanhl>() functions are thread-safe."
8221 #: build/C/man3/tanh.3:121
8222 msgid "B<acosh>(3), B<asinh>(3), B<atanh>(3), B<cosh>(3), B<ctanh>(3), B<sinh>(3)"
8226 #: build/C/man3/tgamma.3:13
8232 #: build/C/man3/tgamma.3:16
8233 msgid "tgamma, tgammaf, tgammal - true gamma function"
8237 #: build/C/man3/tgamma.3:20
8238 msgid "B<double tgamma(double >I<x>B<);>"
8242 #: build/C/man3/tgamma.3:22
8243 msgid "B<float tgammaf(float >I<x>B<);>"
8247 #: build/C/man3/tgamma.3:24
8248 msgid "B<long double tgammal(long double >I<x>B<);>"
8252 #: build/C/man3/tgamma.3:36
8253 msgid "B<tgamma>(), B<tgammaf>(), B<tgammal>():"
8257 #: build/C/man3/tgamma.3:46
8258 msgid "The Gamma function is defined by"
8262 #: build/C/man3/tgamma.3:48
8264 msgid " Gamma(x) = integral from 0 to infinity of t^(x-1) e^-t dt\n"
8268 #: build/C/man3/tgamma.3:53
8270 "It is defined for every real number except for nonpositive integers. For "
8271 "nonnegative integral I<m> one has"
8275 #: build/C/man3/tgamma.3:55
8277 msgid " Gamma(m+1) = m!\n"
8281 #: build/C/man3/tgamma.3:58
8282 msgid "and, more generally, for all I<x>:"
8286 #: build/C/man3/tgamma.3:60
8288 msgid " Gamma(x+1) = x * Gamma(x)\n"
8292 #: build/C/man3/tgamma.3:64
8294 "Furthermore, the following is valid for all values of I<x> outside the "
8299 #: build/C/man3/tgamma.3:66
8301 msgid " Gamma(x) * Gamma(1 - x) = PI / sin(PI * x)\n"
8305 #: build/C/man3/tgamma.3:69
8306 msgid "On success, these functions return Gamma(x)."
8310 #: build/C/man3/tgamma.3:83
8312 "If I<x> is a negative integer, or is negative infinity, a domain error "
8313 "occurs, and a NaN is returned."
8317 #: build/C/man3/tgamma.3:96
8319 "If the result underflows, a range error occurs, and the functions return 0, "
8320 "with the correct mathematical sign."
8324 #: build/C/man3/tgamma.3:107
8326 "If I<x> is -0 or +0, a pole error occurs, and the functions return "
8327 "B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, respectively, with the same sign "
8332 #: build/C/man3/tgamma.3:114
8334 msgid "Domain error: I<x> is a negative integer, or negative infinity"
8338 #: build/C/man3/tgamma.3:122
8340 "I<errno> is set to B<EDOM>. An invalid floating-point exception "
8341 "(B<FE_INVALID>) is raised (but see BUGS)."
8345 #: build/C/man3/tgamma.3:122
8347 msgid "Pole error: I<x> is +0 or -0"
8351 #: build/C/man3/tgamma.3:141
8353 "glibc also gives the following error which is not specified in C99 or "
8357 #. FIXME . Is it intentional that errno is not set:
8358 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810
8360 #. glibc (as at 2.8) also supports and an inexact
8361 #. exception for various cases.
8363 #: build/C/man3/tgamma.3:158
8364 msgid "I<errno> is not set for this case."
8368 #: build/C/man3/tgamma.3:169
8370 "This function had to be called \"true gamma function\" since there is "
8371 "already a function B<gamma>(3) that returns something else (see B<gamma>(3) "
8375 #. http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
8377 #: build/C/man3/tgamma.3:178
8379 "Before version 2.18, the glibc implementation of these functions did not set "
8380 "I<errno> to B<EDOM> when I<x> is negative infinity."
8384 #: build/C/man3/tgamma.3:187
8386 "In glibc versions 2.3.3 and earlier, an argument of +0 or -0 incorrectly "
8387 "produced a domain error (I<errno> set to B<EDOM> and an B<FE_INVALID> "
8388 "exception raised), rather than a pole error."
8392 #: build/C/man3/tgamma.3:190
8393 msgid "B<gamma>(3), B<lgamma>(3)"
8397 #: build/C/man3/trunc.3:25
8403 #: build/C/man3/trunc.3:28
8404 msgid "trunc, truncf, truncl - round to integer, toward zero"
8408 #: build/C/man3/trunc.3:33
8410 msgid "B<double trunc(double >I<x>B<);>\n"
8414 #: build/C/man3/trunc.3:35
8416 msgid "B<float truncf(float >I<x>B<);>\n"
8420 #: build/C/man3/trunc.3:37
8422 msgid "B<long double truncl(long double >I<x>B<);>\n"
8426 #: build/C/man3/trunc.3:50
8427 msgid "B<trunc>(), B<truncf>(), B<truncl>():"
8431 #: build/C/man3/trunc.3:63
8433 "These functions round I<x> to the nearest integer not larger in absolute "
8438 #: build/C/man3/trunc.3:71
8439 msgid "If I<x> is integral, infinite, or NaN, I<x> itself is returned."
8443 #: build/C/man3/trunc.3:83
8444 msgid "The B<trunc>(), B<truncf>(), and B<truncl>() functions are thread-safe."
8448 #: build/C/man3/y0.3:36
8454 #: build/C/man3/y0.3:40
8456 "y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl - Bessel functions of the second "
8461 #: build/C/man3/y0.3:45
8463 msgid "B<double y0(double >I<x>B<);>\n"
8467 #: build/C/man3/y0.3:47
8469 msgid "B<double y1(double >I<x>B<);>\n"
8473 #: build/C/man3/y0.3:49
8475 msgid "B<double yn(int >I<n>B<, double >I<x>B<);>\n"
8479 #: build/C/man3/y0.3:51
8481 msgid "B<float y0f(float >I<x>B<);>\n"
8485 #: build/C/man3/y0.3:53
8487 msgid "B<float y1f(float >I<x>B<);>\n"
8491 #: build/C/man3/y0.3:55
8493 msgid "B<float ynf(int >I<n>B<, float >I<x>B<);>\n"
8497 #: build/C/man3/y0.3:57
8499 msgid "B<long double y0l(long double >I<x>B<);>\n"
8503 #: build/C/man3/y0.3:59
8505 msgid "B<long double y1l(long double >I<x>B<);>\n"
8509 #: build/C/man3/y0.3:61
8511 msgid "B<long double ynl(int >I<n>B<, long double >I<x>B<);>\n"
8515 #: build/C/man3/y0.3:74
8516 msgid "B<y0>(), B<y1>(), B<yn>():"
8520 #: build/C/man3/y0.3:84
8521 msgid "B<y0f>(), B<y0l>(), B<y1f>(), B<y1l>(), B<ynf>(), B<ynl>():"
8525 #: build/C/man3/y0.3:105
8527 "The B<y0>() and B<y1>() functions return Bessel functions of I<x> of the "
8528 "second kind of orders 0 and 1, respectively. The B<yn>() function returns "
8529 "the Bessel function of I<x> of the second kind of order I<n>."
8533 #: build/C/man3/y0.3:109
8534 msgid "The value of I<x> must be positive."
8538 #: build/C/man3/y0.3:126
8540 "The B<y0f>(), B<y1f>(), and B<ynf>() functions are versions that take and "
8541 "return I<float> values. The B<y0l>(), B<y1l>(), and B<ynl>() functions are "
8542 "versions that take and return I<long double> values."
8546 #: build/C/man3/y0.3:130
8548 "On success, these functions return the appropriate Bessel value of the "
8549 "second kind for I<x>."
8553 #: build/C/man3/y0.3:146
8555 "If I<x> is negative, a domain error occurs, and the functions return "
8556 "-B<HUGE_VAL>, -B<HUGE_VALF>, or -B<HUGE_VALL>, respectively. (POSIX.1-2001 "
8557 "also allows a NaN return for this case.)"
8561 #: build/C/man3/y0.3:157
8563 "If I<x> is 0.0, a pole error occurs, and the functions return -B<HUGE_VAL>, "
8564 "-B<HUGE_VALF>, or -B<HUGE_VALL>, respectively."
8568 #: build/C/man3/y0.3:161
8569 msgid "If the result underflows, a range error occurs, and the functions return 0.0"
8573 #: build/C/man3/y0.3:171
8575 "If the result overflows, a range error occurs, and the functions return "
8576 "-B<HUGE_VAL>, -B<HUGE_VALF>, or -B<HUGE_VALL>, respectively. (POSIX.1-2001 "
8577 "also allows a 0.0 return for this case.)"
8581 #: build/C/man3/y0.3:186
8583 msgid "Pole error: I<x> is 0.0"
8586 #. Before POSIX.1-2001 TC2, this was (inconsistently) specified
8587 #. as a range error.
8588 #. FIXME . y0(0.0) gives EDOM
8589 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808
8591 #: build/C/man3/y0.3:201
8593 "I<errno> is set to B<ERANGE> (but see BUGS). No B<FE_DIVBYZERO> exception "
8594 "is returned by B<fetestexcept>(3) for this case."
8597 #. e.g., y0(1e33) on glibc 2.8/x86-32
8598 #. An underflow floating-point exception
8599 #. .RB ( FE_UNDERFLOW )
8601 #. FIXME . Is it intentional that these functions do not use FE_*?
8602 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806
8604 #: build/C/man3/y0.3:217
8606 "I<errno> is set to B<ERANGE>. No B<FE_UNDERFLOW> exception is returned by "
8607 "B<fetestexcept>(3) for this case."
8610 #. e.g., yn(10, 1e-40) on glibc 2.8/x86-32
8614 #. FIXME . Is it intentional that errno is not set?
8615 #. Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808
8617 #: build/C/man3/y0.3:230
8619 "I<errno> is not set for this case. An overflow floating-point exception "
8620 "(B<FE_OVERFLOW>) is raised."
8624 #. Bug raised: http://sourceware.org/bugzilla/show_bug.cgi?id=6807
8626 #: build/C/man3/y0.3:246
8628 "On a pole error, these functions set I<errno> to B<EDOM>, instead of "
8629 "B<ERANGE> as POSIX.1-2004 requires."
8632 #. FIXME . Actually, 2.3.2 is the earliest test result I have; so yet
8633 #. to confirm if this error occurs only in 2.3.2.
8635 #: build/C/man3/y0.3:253
8637 "In glibc version 2.3.2 and earlier, these functions do not raise an invalid "
8638 "floating-point exception (B<FE_INVALID>) when a domain error occurs."
8642 #: build/C/man3/y0.3:255