math_error(7)          Miscellaneous Information Manual          math_error(7)

NUME
       math_error - detecteaza erorile din func<?>iile matematice

SINOPSIS
       #include <math.h>
       #include <errno.h>
       #include <fenv.h>

DESCRIERE
       Atunci cand apare o eroare, majoritatea func<?>iilor de biblioteca
       indica acest fapt prin returnarea unei valori speciale (de exemplu, -1
       sau NULL). Deoarece in mod obi<?>nuit returneaza un numar in virgula
       mobila, func<?>iile matematice declarate in <math.h> indica o eroare
       folosind alte mecanisme. Exista doua mecanisme de semnalizare a
       erorilor: cel mai vechi define<?>te errno; cel mai nou utilizeaza
       mecanismul de excep<?>ie in virgula mobila (utilizarea lui
       feclearexcept(3) <?>i fetestexcept(3), a<?>a cum este prezentat mai
       jos) descris in fenv(3).

       Un program portabil care trebuie sa verifice o eroare dintr-o func<?>ie
       matematica ar trebui sa stabileasca errno la zero <?>i sa faca
       urmatorul apel

           feclearexcept(FE_ALL_EXCEPT);

       inainte de a apela o func<?>ie matematica.

       La revenirea din func<?>ia matematica, daca errno este diferita de
       zero, sau daca apelul urmator (a se vedea fenv(3)) returneaza un
       rezultat diferit de zero,

           fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
                        FE_UNDERFLOW);

       atunci s-a produs o eroare in func<?>ia matematica.

       Condi<?>iile de eroare care pot aparea pentru func<?>iile matematice
       sunt descrise mai jos.

   Eroare de domeniu
       O eroare de domeniu apare atunci cand o func<?>ie matematica este
       furnizata cu un argument a carui valoare se afla in afara domeniului
       pentru care este definita func<?>ia (de exemplu, dand un argument
       negativ lui log(3)). Atunci cand apare o eroare de domeniu, func<?>iile
       matematice returneaza in mod obi<?>nuit un NaN (de<?>i unele func<?>ii
       returneaza o valoare diferita in acest caz); errno este stabilita la
       EDOM <?>i se genereaza o excep<?>ie ,,nevalida" (FE_INVALID) in virgula
       mobila.

   Eroare de pol (semn)
       O eroare de pol apare atunci cand rezultatul matematic al unei
       func<?>ii este un infinit exact (de exemplu, logaritmul lui 0 este un
       infinit negativ). Atunci cand apare o eroare de pol, func<?>ia
       returneaza valoarea (cu semn) HUGE_VAL, HUGE_VALF sau HUGE_VALL, in
       func<?>ie de tipul rezultatului func<?>iei: double, float sau long
       double. Semnul rezultatului este cel care este corect din punct de
       vedere matematic pentru func<?>ia respectiva. errno este stabilita la
       ERANGE <?>i se genereaza o excep<?>ie de ,,impar<?>ire la zero"
       (FE_DIVBYZERO) in virgula mobila.

   Eroare de interval
       O eroare de interval apare atunci cand magnitudinea rezultatului
       func<?>iei inseamna ca acesta nu poate fi reprezentat in tipul de
       rezultat al func<?>iei.  Valoarea de returnare a func<?>iei depinde de
       faptul daca eroarea de interval a fost o depa<?>ire a limitei maxime
       sau o depa<?>ire a limitei minime.

       Un rezultat flotant de depa<?>ire a limitei maxime daca rezultatul este
       finit, dar este prea mare pentru a fi reprezentat in tipul de rezultat.
       Atunci cand se produce o depa<?>ire, func<?>ia returneaza valoarea
       HUGE_VAL, HUGE_VALF sau HUGE_VALL, in func<?>ie de faptul ca tipul
       rezultatului func<?>iei este double, float sau long double. errno este
       stabilita la ERANGE <?>i se genereaza o excep<?>ie de ,,depa<?>ire a
       limitei maxime" (FE_OVERFLOW) in virgula mobila.

       Un rezultat flotant de depa<?>ire a limitei minime daca rezultatul este
       prea mic pentru a fi reprezentat in tipul de rezultat. In cazul in care
       se produce o depa<?>ire a limitei minime, o func<?>ie matematica
       returneaza de obicei 0,0 (C99 spune ca o func<?>ie trebuie sa returneze
       ,,o valoare definita de implementare a carei marime nu este mai mare
       decat cel mai mic numar pozitiv normalizat in tipul specificat"). errno
       poate fi stabilita la ERANGE <?>i poate fi generata o excep<?>ie
       ,,depa<?>ire a limitei minime" (FE_UNDERFLOW) in virgula mobila.

       Unele func<?>ii genereaza o eroare de interval in cazul in care
       valoarea argumentului furnizat sau rezultatul corect al func<?>iei ar
       fi subnormal. O valoare subnormala este o valoare diferita de zero, dar
       cu o magnitudine atat de mica incat nu poate fi prezentata in forma
       normalizata (adica cu un 1 in cel mai semnificativ bit al
       semnificantului). Reprezentarea unui numar subnormal va con<?>ine unul
       sau mai multe zerouri la inceput in semnifica<?>ie.

NOTE
       Identificatorul math_errhandling specificat de C99 <?>i POSIX.1 nu este
       acceptat de glibc. Acest identificator ar trebui sa indice care dintre
       cele doua mecanisme de notificare a erorilor (errno, excep<?>ii
       recuperabile prin fetestexcept(3)) este utilizat. Standardele impun ca
       cel pu<?>in unul dintre ele sa fie utilizat, dar permit ca ambele sa
       fie disponibile. Situa<?>ia actuala (glibc 2.8) in cadrul glibc este
       dezordonata. Majoritatea func<?>iilor (dar nu toate) ridica excep<?>ii
       in caz de eroare. Unele stabilesc, de asemenea, errno. Cateva func<?>ii
       configureaza errno, dar nu genereaza o excep<?>ie. Foarte pu<?>ine
       func<?>ii nu fac nici una, nici alta. Consulta<?>i paginile de manual
       individuale pentru detalii.

       Pentru a evita complexitatea utilizarii errno <?>i fetestexcept(3)
       pentru verificarea erorilor, se recomanda adesea sa se verifice daca
       exista valori de argument gre<?>ite inainte de fiecare apel.  De
       exemplu, codul urmator se asigura ca argumentul lui log(3) nu este un
       NaN <?>i nu este zero (o eroare de pol) sau mai mic decat zero (o
       eroare de domeniu):

           double x, r;

           if (isnan(x) || islessequal(x, 0)) {
               /* Rezolva problemele cu NaN / eroare de pol / eroare de domeniu */
           }

           r = log(x);

       Discu<?>ia de pe aceasta pagina nu se aplica func<?>iilor matematice
       complexe (de exemplu, cele declarate de <complex.h>), care, in general,
       nu sunt obligate sa returneze erori prin C99 <?>i POSIX.1.

       Op<?>iunea gcc(1) -fno-math-errno face ca executabilul sa utilizeze
       implementari ale unor func<?>ii matematice care sunt mai rapide decat
       implementarile standard, dar nu configureaza errno in caz de eroare;
       (op<?>iunea gcc(1) -ffast-math activeaza, de asemenea,
       -fno-math-errno). O eroare poate fi in continuare testata folosind
       fetestexcept(3).

CONSULTA<?>I <?>I
       gcc(1), errno(3), fenv(3), fpclassify(3), INFINITY(3), isgreater(3),
       matherr(3), nan(3)

       info libc

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.8     2 mai 2024                     math_error(7)