diff options
Diffstat (limited to 'templates/man7/math_error.7.pot')
-rw-r--r-- | templates/man7/math_error.7.pot | 382 |
1 files changed, 382 insertions, 0 deletions
diff --git a/templates/man7/math_error.7.pot b/templates/man7/math_error.7.pot new file mode 100644 index 00000000..a97d9e1c --- /dev/null +++ b/templates/man7/math_error.7.pot @@ -0,0 +1,382 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-03-01 17:01+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "math_error" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "math_error - detecting errors from mathematical functions" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"B<#include E<lt>math.hE<gt>>\n" +"B<#include E<lt>errno.hE<gt>>\n" +"B<#include E<lt>fenv.hE<gt>>\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"When an error occurs, most library functions indicate this fact by returning " +"a special value (e.g., -1 or NULL). Because they typically return a " +"floating-point number, the mathematical functions declared in I<E<lt>math." +"hE<gt>> indicate an error using other mechanisms. There are two error-" +"reporting mechanisms: the older one sets I<errno>; the newer one uses the " +"floating-point exception mechanism (the use of B<feclearexcept>(3) and " +"B<fetestexcept>(3), as outlined below) described in B<fenv>(3)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A portable program that needs to check for an error from a mathematical " +"function should set I<errno> to zero, and make the following call" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "feclearexcept(FE_ALL_EXCEPT);\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "before calling a mathematical function." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Upon return from the mathematical function, if I<errno> is nonzero, or the " +"following call (see B<fenv>(3)) returns nonzero" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |\n" +" FE_UNDERFLOW);\n" +msgstr "" + +#. enum +#. { +#. FE_INVALID = 0x01, +#. __FE_DENORM = 0x02, +#. FE_DIVBYZERO = 0x04, +#. FE_OVERFLOW = 0x08, +#. FE_UNDERFLOW = 0x10, +#. FE_INEXACT = 0x20 +#. }; +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "then an error occurred in the mathematical function." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The error conditions that can occur for mathematical functions are described " +"below." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Domain error" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A I<domain error> occurs when a mathematical function is supplied with an " +"argument whose value falls outside the domain for which the function is " +"defined (e.g., giving a negative argument to B<log>(3)). When a domain " +"error occurs, math functions commonly return a NaN (though some functions " +"return a different value in this case); I<errno> is set to B<EDOM>, and an " +"\"invalid\" (B<FE_INVALID>) floating-point exception is raised." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Pole error" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A I<pole error> occurs when the mathematical result of a function is an " +"exact infinity (e.g., the logarithm of 0 is negative infinity). When a pole " +"error occurs, the function returns the (signed) value B<HUGE_VAL>, " +"B<HUGE_VALF>, or B<HUGE_VALL>, depending on whether the function result type " +"is I<double>, I<float>, or I<long double>. The sign of the result is that " +"which is mathematically correct for the function. I<errno> is set to " +"B<ERANGE>, and a \"divide-by-zero\" (B<FE_DIVBYZERO>) floating-point " +"exception is raised." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Range error" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A I<range error> occurs when the magnitude of the function result means that " +"it cannot be represented in the result type of the function. The return " +"value of the function depends on whether the range error was an overflow or " +"an underflow." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A floating result I<overflows> if the result is finite, but is too large to " +"represented in the result type. When an overflow occurs, the function " +"returns the value B<HUGE_VAL>, B<HUGE_VALF>, or B<HUGE_VALL>, depending on " +"whether the function result type is I<double>, I<float>, or I<long double>. " +"I<errno> is set to B<ERANGE>, and an \"overflow\" (B<FE_OVERFLOW>) floating-" +"point exception is raised." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A floating result I<underflows> if the result is too small to be represented " +"in the result type. If an underflow occurs, a mathematical function " +"typically returns 0.0 (C99 says a function shall return \"an implementation-" +"defined value whose magnitude is no greater than the smallest normalized " +"positive number in the specified type\"). I<errno> may be set to B<ERANGE>, " +"and an \"underflow\" (B<FE_UNDERFLOW>) floating-point exception may be " +"raised." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Some functions deliver a range error if the supplied argument value, or the " +"correct function result, would be I<subnormal>. A subnormal value is one " +"that is nonzero, but with a magnitude that is so small that it can't be " +"presented in normalized form (i.e., with a 1 in the most significant bit of " +"the significand). The representation of a subnormal number will contain one " +"or more leading zeros in the significand." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. See CONFORMANCE in the glibc 2.8 (and earlier) source. +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<math_errhandling> identifier specified by C99 and POSIX.1 is not " +"supported by glibc. This identifier is supposed to indicate which of the " +"two error-notification mechanisms (I<errno>, exceptions retrievable via " +"B<fetestexcept>(3)) is in use. The standards require that at least one be " +"in use, but permit both to be available. The current (glibc 2.8) situation " +"under glibc is messy. Most (but not all) functions raise exceptions on " +"errors. Some also set I<errno>. A few functions set I<errno>, but don't " +"raise an exception. A very few functions do neither. See the individual " +"manual pages for details." +msgstr "" + +#. http://www.securecoding.cert.org/confluence/display/seccode/FLP32-C.+Prevent+or+detect+domain+and+range+errors+in+math+functions +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"To avoid the complexities of using I<errno> and B<fetestexcept>(3) for " +"error checking, it is often advised that one should instead check for bad " +"argument values before each call. For example, the following code ensures " +"that B<log>(3)'s argument is not a NaN and is not zero (a pole error) or " +"less than zero (a domain error):" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"double x, r;\n" +"\\&\n" +"if (isnan(x) || islessequal(x, 0)) {\n" +" /* Deal with NaN / pole error / domain error */\n" +"}\n" +"\\&\n" +"r = log(x);\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The discussion on this page does not apply to the complex mathematical " +"functions (i.e., those declared by I<E<lt>complex.hE<gt>>), which in general " +"are not required to return errors by C99 and POSIX.1." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<gcc>(1) I<-fno-math-errno> option causes the executable to employ " +"implementations of some mathematical functions that are faster than the " +"standard implementations, but do not set I<errno> on error. (The B<gcc>(1) " +"I<-ffast-math> option also enables I<-fno-math-errno>.) An error can still " +"be tested for using B<fetestexcept>(3)." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<gcc>(1), B<errno>(3), B<fenv>(3), B<fpclassify>(3), B<INFINITY>(3), " +"B<isgreater>(3), B<matherr>(3), B<nan>(3)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<info libc>" +msgstr "" + +#. type: TH +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "2022-12-04" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "double x, r;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"if (isnan(x) || islessequal(x, 0)) {\n" +" /* Deal with NaN / pole error / domain error */\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "r = log(x);\n" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "2023-05-03" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |