po4a/math/po/math.pot

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