tgamma(3)                  Library Functions Manual                  tgamma(3)

NAZWA
       tgamma, tgammaf, tgammal - prawdziwa funkcja gamma

BIBLIOTEKA
       Biblioteka matematyczna (libm, -lm)

SKLADNIA
       #include <math.h>

       double tgamma(double x);
       float tgammaf(float x);
       long double tgammal(long double x);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       tgamma(), tgammaf(), tgammal():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

OPIS
       Funkcje te obliczaja funkcje gamma dla x.

       Funkcja gamma jest definiowana jako:

              Gamma(x) = integral from 0 to infinity of t^(x-1) e^-t dt

       Jest zdefiniowana dla kazdej liczby rzeczywistej z wyjatkiem
       niedodatnich liczb calkowitych. Dla nieujemnej liczby calkowitej
       zachodzi:

              Gamma(m+1) = m!

       i ogolnie dla wszystkich x:

              Gamma(x+1) = x * Gamma(x)

       Co wiecej dla wszystkich poprawnych wartosci x poza biegunem:

              Gamma(x) * Gamma(1 - x) = PI / sin(PI * x)

WARTOSC ZWRACANA
       Funkcje te, gdy sie zakoncza pomyslnie, zwracaja Gamma(x).

       Jesli x wynosi NaN, to zwracane jest NaN.

       Jesli x jest rowne dodatniej nieskonczonosci, to zwracana jest dodatnia
       nieskonczonosc.

       Jesli x jest ujemna liczba calkowita lub ujemna nieskonczonoscia, to
       wystepuje blad dziedziny i zwracane jest NaN.

       Jesli wartosc wynikowa jest zbyt duza, to wystepuje blad przekroczenia
       zakresu i funkcje odpowiednio zwracaja HUGE_VAL, HUGE_VALF lub
       HUGE_VALL z poprawnie ustawionym znakiem (dodatnim lub ujemnym).

       Jesli wartosc wynikowa jest zbyt mala, wystepuje blad przekroczenia
       zakresu i funkcje zwracaja 0 z matematycznie poprawnym znakiem
       (dodatnim lub ujemnym).

       Jesli x jest rowne -0 lub +0, wystepuje blad bieguna i funkcje
       odpowiednio zwracaja HUGE_VAL, HUGE_VALF lub HUGE_VALL z takim samym
       znakiem, jak znak przed 0.

BLEDY
       Informacje o tym, jak okreslic, czy wystapil blad podczas wywolania
       tych funkcji, mozna znalezc w podreczniku math_error(7).

       Moga wystapic nastepujace bledy:

       Blad dziedziny: x jest ujemna liczba calkowita lub ujemna
       nieskonczonoscia
              errno jest ustawiane na EDOM. Rzucany jest wyjatek niepoprawnej
              operacji zmiennoprzecinkowej (FE_INVALID) (patrz takze USTERKI).

       Blad bieguna: x jest rowne +0 lub -0
              errno jest ustawiane na ERANGE. Rzucany jest wyjatek
              zmiennoprzecinkowego dzielenia przez zero (FE_DIVBYZERO).

       Blad zakresu: przekroczenie w gore wartosci wynikowej
              errno jest ustawiane na ERANGE. Rzucany jest wyjatek
              przekroczenia zakresu operacji zmiennoprzecinkowej
              (FE_OVERFLOW).

       glibc takze moze zwrocic nastepujacy blad niewymieniony w C99 ani w
       POSIX.1-2001.

       Blad zakresu: przekroczenie w dol wartosci wynikowej
              Rzucany jest wyjatek przekroczenia w dol zakresu operacji
              zmiennoprzecinkowej (FE_UNDERFLOW), a ERRNO jest ustawiane na
              ERANGE.

ATRYBUTY
       Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w
       podreczniku attributes(7).

       +---------------------------+--------------------------+---------------+
       |Interfejs                  | Atrybut                  | Wartosc       |
       +---------------------------+--------------------------+---------------+
       |tgamma(), tgammaf(),       | Bezpieczenstwo watkowe   | MT-bezpieczne |
       |tgammal()                  |                          |               |
       +---------------------------+--------------------------+---------------+
STANDARDY
       C11, POSIX.1-2008.

HISTORIA
       glibc 2.1.  C99, POSIX.1-2001.

UWAGI
       Nazwa funkcji musi brzmiec "prawdziwa funkcja gamma", gdyz istnieje juz
       funkcja gamma(3) zwracajaca co innego (szczegoly opisano w gamma(3)).

USTERKI
       Before glibc 2.18, the glibc implementation of these functions did not
       set errno to EDOM when x is negative infinity.

       Before glibc 2.19, the glibc implementation of these functions did not
       set errno to ERANGE on an underflow range error.

       W wersji 2.3.3 i wczesniejszych biblioteki glibc, argument +0 lub -0
       niepoprawnie powodowal blad dziedziny (errno ustawione na EDOM i
       wyrzucony wyjatek FE_INVALID) zamiast bledu bieguna.

ZOBACZ TAKZE
       gamma(3), lgamma(3)

TLUMACZENIE
       Autorami polskiego tlumaczenia niniejszej strony podrecznika sa:
       Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda
       <robert@debian.org> i Michal Kulach <michal.kulach@gmail.com>

       Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o
       warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public
       License w wersji 3 <https://www.gnu.org/licenses/gpl-3.0.html> lub
       nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI.

       Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy
       dyskusyjnej <manpages-pl-list@lists.sourceforge.net>.

Linux man-pages 6.06       31 pazdziernika 2023 r.                   tgamma(3)