pow(3) Library Functions Manual pow(3) NAZWA pow, powf, powl - funkcja potegowa BIBLIOTEKA Biblioteka matematyczna (libm, -lm) SKLADNIA #include double pow(double x, double y); float powf(float x, float y); long double powl(long double x, long double y); Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)): powf(), powl(): _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || /* Od glibc 2.19: */ _DEFAULT_SOURCE || /* glibc w wersji <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE OPIS Funkcje te zwracaja wartosc x podniesiona do potegi y. WARTOSC ZWRACANA Funkcje te, gdy sie zakoncza pomyslnie, zwracaja wartosc x podniesiona do potegi y. 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. If result underflows, and is not representable, a range error occurs, and 0.0 with the appropriate sign is returned. Jesli x jest rowne +0 lub -0 oraz y jest nieparzysta liczba calkowita mniejsza od 0, wystepuje blad bieguna i funkcje odpowiednio zwracaja HUGE_VAL, HUGE_VALF lub HUGE_VALL z takim samym znakiem, jak znak x. Jesli x jest rowne +0 lub -0 oraz y jest mniejsze od 0, ale nie jest nieparzysta liczba calkowita, wystepuje blad bieguna i funkcje odpowiednio zwracaja +HUGE_VAL, +HUGE_VALF lub +HUGE_VALL. Jesli x wynosi +0 (-0) i y jest nieparzysta liczba calkowita wieksza od 0, to zwracane jest +0 (-0). Jesli x wynosi 0 i y jest wieksze od zera, ale nie jest nieparzysta liczba calkowita, to zwracane jest +0. Jesli x wynosi -1 i y jest dodatnia lub ujemna nieskonczonoscia, to wynikiem jest 1.0 Jesli x wynosi +1, to wynikiem jest 1.0 (nawet gdy y wynosi NaN). Jesli y wynosi 0, to wynikiem jest 1.0 (nawet gdy x wynosi NaN). Jezeli x jest wartoscia skonczona mniejsza niz 0 i y jest wartoscia skonczona niebedaca liczba calkowita, wystepuje blad dziedziny i zwracane jest NaN. Jesli wartosc bezwzgledna x jest mniejsza niz 1 i y jest ujemna nieskonczonoscia, to wynikiem jest dodatnia nieskonczonosc. Jesli wartosc bezwzgledna x jest wieksza od 1 i y jest ujemna nieskonczonoscia, to wynikiem jest +0. Jesli wartosc bezwzgledna x jest mniejsza niz 1 i y jest dodatnia nieskonczonoscia, to wynikiem jest +0. Jesli wartosc bezwzgledna x jest wieksza od 1 i y jest dodatnia nieskonczonoscia, to wynikiem jest dodatnia nieskonczonosc. Jesli x jest rowne ujemnej nieskonczonosci i y jest nieparzysta liczba calkowita mniejsza od 0, to zwracane jest -0. Jesli x jest rowne ujemnej nieskonczonosci i y jest mniejsze od 0 i nie jest nieparzysta liczba calkowita, to zwracane jest +0. Jesli x jest rowne ujemnej nieskonczonosci i y jest nieparzysta liczba calkowita wieksza od 0, to zwracana jest ujemna nieskonczonosc. Jesli x jest rowne ujemnej nieskonczonosci i y jest wieksze od 0 i nie jest nieparzysta liczba calkowita, to zwracana jest dodatnia nieskonczonosc. Jesli x jest rowne dodatniej nieskonczonosci i y jest mniejsze od 0, to zwracane jest +0. Jesli x jest rowne dodatniej nieskonczonosci i y jest wieksze od 0, to zwracana jest dodatnia nieskonczonosc. Except as specified above, if x or y is a NaN, the result is a NaN. 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 ujemne, a y jest liczba skonczona, ale niecalkowita errno jest ustawiane na EDOM. Rzucany jest wyjatek niepoprawnej operacji zmiennoprzecinkowej (FE_INVALID). Blad bieguna: x wynosi zero, a y jest ujemne errno jest ustawiane na ERANGE (patrz takze USTERKI). 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). Blad zakresu: przekroczenie w dol wartosci wynikowej errno jest ustawiane na ERANGE. Rzucany jest wyjatek przekroczenia w dol zakresu operacji zmiennoprzecinkowej (FE_UNDERFLOW). ATRYBUTY Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w podreczniku attributes(7). +---------------------------+--------------------------+---------------+ |Interfejs | Atrybut | Wartosc | +---------------------------+--------------------------+---------------+ |pow(), powf(), powl() | Bezpieczenstwo watkowe | MT-bezpieczne | +---------------------------+--------------------------+---------------+ STANDARDY C11, POSIX.1-2008. HISTORIA C99, POSIX.1-2001. Wariant zwracajacy wartosc typu double jest zgodny rowniez z SVr4, 4.3BSD, C89. USTERKI Historical bugs (now fixed) Before glibc 2.28, on some architectures (e.g., x86-64) pow() may be more than 10,000 times slower for some inputs than for other nearby inputs. This affects only pow(), and not powf() nor powl(). This problem was fixed in glibc 2.28. A number of bugs in the glibc implementation of pow() were fixed in glibc 2.16. In glibc 2.9 and earlier, when a pole error occurs, errno is set to EDOM instead of the POSIX-mandated ERANGE. Since glibc 2.10, glibc does the right thing. In glibc 2.3.2 and earlier, when an overflow or underflow error occurs, glibc's pow() generates a bogus invalid floating-point exception (FE_INVALID) in addition to the overflow or underflow exception. ZOBACZ TAKZE cbrt(3), cpow(3), sqrt(3) TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Adam Byrtek , Robert Luberda i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . Linux man-pages 6.06 31 pazdziernika 2023 r. pow(3)