.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\" Based on glibc infopages
.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
.\"     <mtk.manpages@gmail.com>
.\" Modified 2004-11-15, fixed error noted by Fabian Kreutz
.\"	 <kreutz@dbs.uni-hannover.de>
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH tgamma 3 "10 lutego 2023 r." "Linux man\-pages 6.03" 
.SH NAZWA
tgamma, tgammaf, tgammal \- prawdziwa funkcja gamma
.SH BIBLIOTEKA
Biblioteka matematyczna (\fIlibm\fP, \fI\-lm\fP)
.SH SKŁADNIA
.nf
\fB#include <math.h>\fP
.PP
\fBdouble tgamma(double \fP\fIx\fP\fB);\fP
\fBfloat tgammaf(float \fP\fIx\fP\fB);\fP
\fBlong double tgammal(long double \fP\fIx\fP\fB);\fP
.fi
.PP
.RS -4
Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)):
.RE
.PP
\fBtgamma\fP(), \fBtgammaf\fP(), \fBtgammal\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
.fi
.SH OPIS
Funkcje te obliczają funkcję gamma dla \fIx\fP.
.PP
Funkcja gamma jest definiowana jako:
.PP
.RS
Gamma(x) = integral from 0 to infinity of t\[ha](x\-1) e\[ha]\-t dt
.RE
.PP
Jest zdefiniowana dla każdej liczby rzeczywistej z wyjątkiem niedodatnich
liczb całkowitych. Dla nieujemnej liczby całkowitej zachodzi:
.PP
.RS
Gamma(m+1) = m!
.RE
.PP
i ogólnie dla wszystkich \fIx\fP:
.PP
.RS
Gamma(x+1) = x * Gamma(x)
.RE
.PP
Co więcej dla wszystkich poprawnych wartości \fIx\fP poza biegunem:
.PP
.RS
Gamma(x) * Gamma(1 \- x) = PI / sin(PI * x)
.RE
.SH "WARTOŚĆ ZWRACANA"
Funkcje te, gdy się zakończą pomyślnie, zwracają Gamma(x).
.PP
Jeśli \fIx\fP wynosi NaN, to zwracane jest NaN.
.PP
Jeśli \fIx\fP jest równe dodatniej nieskończoności, to zwracana jest dodatnia
nieskończoność.
.PP
Jeśli \fIx\fP jest ujemną liczbą całkowitą lub ujemną nieskończonością, to
występuje błąd dziedziny i zwracane jest NaN.
.PP
Jeśli wartość wynikowa jest zbyt duża, to występuje błąd przekroczenia
zakresu i funkcje odpowiednio zwracają \fBHUGE_VAL\fP, \fBHUGE_VALF\fP lub
\fBHUGE_VALL\fP z poprawnie ustawionym znakiem (dodatnim lub ujemnym).
.PP
Jeśli wartość wynikowa jest zbyt mała, występuje błąd przekroczenia zakresu
i funkcje zwracają 0 z matematycznie poprawnym znakiem (dodatnim lub
ujemnym).
.PP
Jeśli \fIx\fP jest równe \-0 lub +0, występuje błąd bieguna i funkcje
odpowiednio zwracają \fBHUGE_VAL\fP, \fBHUGE_VALF\fP lub \fBHUGE_VALL\fP z takim
samym znakiem, jak znak przed 0.
.SH BŁĘDY
Informacje o tym, jak określić, czy wystąpił błąd podczas wywołania tych
funkcji, można znaleźć w podręczniku \fBmath_error\fP(7).
.PP
Mogą wystąpić następujące błędy:
.TP 
Błąd dziedziny: \fIx\fP jest ujemną liczbą całkowitą lub ujemną nieskończonością
\fIerrno\fP jest ustawiane na \fBEDOM\fP. Rzucany jest wyjątek niepoprawnej
operacji zmiennoprzecinkowej (\fBFE_INVALID\fP) (patrz także USTERKI).
.TP 
Błąd bieguna: \fIx\fP jest równe +0 lub \-0
\fIerrno\fP jest ustawiane na \fBERANGE\fP. Rzucany jest wyjątek
zmiennoprzecinkowego dzielenia przez zero (\fBFE_DIVBYZERO\fP).
.TP 
Błąd zakresu: przekroczenie w górę wartości wynikowej
\fIerrno\fP jest ustawiane na \fBERANGE\fP. Rzucany jest wyjątek przekroczenia
zakresu operacji zmiennoprzecinkowej (\fBFE_OVERFLOW\fP).
.PP
glibc także może zwrócić następujący błąd niewymieniony w C99 ani w
POSIX.1\-2001.
.TP 
Błąd zakresu: przekroczenie w dół wartości wynikowej
.\" e.g., tgamma(-172.5) on glibc 2.8/x86-32
.\" .I errno
.\" is set to
.\" .BR ERANGE .
.\" glibc (as at 2.8) also supports an inexact
.\" exception for various cases.
Rzucany jest wyjątek przekroczenia w dół zakresu operacji
zmiennoprzecinkowej (\fBFE_UNDERFLOW\fP), a \fIERRNO\fP jest ustawiane na
\fBERANGE\fP.
.SH WERSJE
Funkcje te dodano w glibc 2.1.
.SH ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku
\fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Interfejs	Atrybut	Wartość
T{
\fBtgamma\fP(),
\fBtgammaf\fP(),
\fBtgammal\fP()
T}	Bezpieczeństwo wątkowe	MT\-bezpieczne
.TE
.hy
.ad
.sp 1
.SH STANDARDY
C99, POSIX.1\-2001, POSIX.1\-2008.
.SH UWAGI
Nazwa funkcji musi brzmieć "prawdziwa funkcja gamma", gdyż istnieje już
funkcja \fBgamma\fP(3) zwracająca co innego (szczegóły opisano w \fBgamma\fP(3)).
.SH USTERKI
.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
Before glibc 2.18, the glibc implementation of these functions did not set
\fIerrno\fP to \fBEDOM\fP when \fIx\fP is negative infinity.
.PP
.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810
Before glibc 2.19, the glibc implementation of these functions did not set
\fIerrno\fP to \fBERANGE\fP on an underflow range error.
.PP
.\"
W wersji 2.3.3 i wcześniejszych biblioteki glibc, argument +0 lub \-0
niepoprawnie powodował błąd dziedziny (\fIerrno\fP ustawione na \fBEDOM\fP i
wyrzucony wyjątek \fBFE_INVALID\fP) zamiast błędu bieguna.
.SH "ZOBACZ TAKŻE"
\fBgamma\fP(3), \fBlgamma\fP(3)
.PP
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>,
Robert Luberda <robert@debian.org>
i
Michał Kułach <michal.kulach@gmail.com>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .
