.\" -*- 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 .\" .\" Modified 2004-11-15, fixed error noted by Fabian Kreutz .\" .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH tgamma 3 "20 lipca 2023 r." "Linux man\-pages 6.05.01" .SH NAZWA tgamma, tgammaf, tgammal \- prawdziwa funkcja gamma .SH BIBLIOTEKA Biblioteka matematyczna (\fIlibm\fP, \fI\-lm\fP) .SH SKŁADNIA .nf \fB#include \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 ATRYBUTY Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfejs Atrybut Wartość T{ .na .nh \fBtgamma\fP(), \fBtgammaf\fP(), \fBtgammal\fP() T} Bezpieczeństwo wątkowe MT\-bezpieczne .TE .sp 1 .SH STANDARDY C11, POSIX.1\-2008. .SH HISTORIA glibc 2.1. C99, POSIX.1\-2001. .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 .\" https://www.sourceware.org/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 .\" https://www.sourceware.org/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 , 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 .