.\" -*- coding: UTF-8 -*- .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de) .\" .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) .\" Distributed under GPL .\" %%%LICENSE_END .\" .\" Based on glibc infopages .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk .\" .\" Modified 2004-11-15, fixed error noted by Fabian Kreutz .\" .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH TGAMMA 3 "15 września 2017 r." GNU "Podręcznik programisty Linuksa" .SH NAZWA tgamma, tgammaf, tgammal \- prawdziwa funkcja gamma .SH SKŁADNIA \fB#include \fP .PP \fBdouble tgamma(double \fP\fIx\fP\fB);\fP .br \fBfloat tgammaf(float \fP\fIx\fP\fB);\fP .br \fBlong double tgammal(long double \fP\fIx\fP\fB);\fP .PP Proszę linkować z \fI\-lm\fP. .PP .RS -4 Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)): .RE .PP .ad l \fBtgamma\fP(), \fBtgammaf\fP(), \fBtgammal\fP(): .RS 4 _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH OPIS Funkcje te obliczają funkcję gamma dla \fIx\fP. .PP Funkcja gamma jest definiowana jako: .PP .RS Gamma(x) = całka od 0 do nieskończoności z t^(x\-1) e^\-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 BŁĘDY IMPLEMENTACJI). .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 pojawiły się po raz pierwszy w wersji 2.1 biblioteki glibc. .SH ATRYBUTY Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku \fBattributes\fP(7). .TS allbox; lbw30 lb lb l l l. Interfejs Atrybut Wartość T{ \fBtgamma\fP(), \fBtgammaf\fP(), \fBtgammal\fP() T} Bezpieczeństwo wątkowe MT\-Safe .TE .SH "ZGODNE Z" 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 BŁĘDY .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809 Implementacja tych funkcji w wersjach wcześniejszych niż 2.18 biblioteki glibc nie ustawiała \fIerrno\fP na \fBEDOM\fP, gdy \fIx\fP było ujemną nieskończonością. .PP .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810 Implementacja tych funkcji w wersjach wcześniejszych niż 2.19 biblioteki glibc nie ustawiała \fIerrno\fP na \fBERANGE\fP w przypadku przekroczenia w dół wartości wynikowej (underflow). .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) .SH "O STRONIE" Angielska wersja tej strony pochodzi z wydania 5.10 projektu Linux \fIman\-pages\fP. Opis projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem \%https://www.kernel.org/doc/man\-pages/. .PP .SH TŁUMACZENIE Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz , Robert Luberda i Michał Kułach . .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 .