.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1995 Jim Van Zandt <jrv@vanzandt.mv.com>
.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
.\"     <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Modified 2002-07-27 Walter Harms
.\" 	(walter.harms@informatik.uni-oldenburg.de)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH expm1 3 "2 maja 2024 r." "Linux man\-pages 6.9.1" 
.SH NAZWA
expm1, expm1f, expm1l \- funkcja wykładnicza minus 1
.SH BIBLIOTEKA
Biblioteka matematyczna (\fIlibm\fP, \fI\-lm\fP)
.SH SKŁADNIA
.nf
\fB#include <math.h>\fP
.P
\fBdouble expm1(double \fP\fIx\fP\fB);\fP
\fBfloat expm1f(float \fP\fIx\fP\fB);\fP
\fBlong double expm1l(long double \fP\fIx\fP\fB);\fP
.P
.fi
.RS -4
Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)):
.RE
.P
\fBexpm1\fP():
.nf
.\"    || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    || _XOPEN_SOURCE >= 500
    || /* Od glibc 2.19: */ _DEFAULT_SOURCE
    || /* glibc w wersji <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.P
\fBexpm1f\fP(), \fBexpm1l\fP():
.nf
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    || /* Od glibc 2.19: */ _DEFAULT_SOURCE
    || /* glibc w wersji <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH OPIS
Funkcje te zwracają wartość równoważną z
.P
.nf
    exp(x) \- 1
.fi
.P
Wynik jest obliczany w sposób zapewniający dokładność nawet gdy \fIx\fP wynosi
prawie zero, czyli w sytuacji, w której użycie \fIexp(x) \- 1\fP prowadziłoby do
niedokładności z powodu odejmowania dwóch prawie takich samych liczb.
.SH "WARTOŚĆ ZWRACANA"
Funkcje te, gdy się zakończą pomyślnie, zwracają \fIexp(x)\ \-\ 1\fP.
.P
Jeśli \fIx\fP wynosi NaN, to zwracane jest NaN.
.P
Jeśli \fIx\fP wynosi +0 (\-0), to zwracane jest +0 (\-0).
.P
Jeśli \fIx\fP jest równe dodatniej nieskończoności, to zwracana jest dodatnia
nieskończoność.
.P
Jeśli \fIx\fP jest równe ujemnej nieskończoności, to zwracane jest \-1.
.P
W przypadku przepełnienia wyniku operacji, występuje błąd zakresu i funkcje
zwracają odpowiednio \-\fBHUGE_VAL\fP, \-\fBHUGE_VALF\fP lub \-\fBHUGE_VALL\fP.
.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).
.P
Mogą wystąpić następujące błędy:
.TP 
Błąd zakresu: przekroczenie w górę wartości wynikowej
.\"
.\" POSIX.1 specifies an optional range error (underflow) if
.\" x is subnormal.  glibc does not implement this.
\fIerrno\fP jest ustawiane na \fBERANGE\fP (ale patrz \fIUSTERKI\fP). Rzucany jest
wyjątek przekroczenia zakresu operacji zmiennoprzecinkowej (\fBFE_OVERFLOW\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
\fBexpm1\fP(),
\fBexpm1f\fP(),
\fBexpm1l\fP()
T}	Bezpieczeństwo wątkowe	MT\-bezpieczne
.TE
.SH STANDARDY
C11, POSIX.1\-2008.
.SH HISTORIA
C99, POSIX.1\-2001.  BSD.
.SH USTERKI
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6778
Przed glibc 2.17, na określonych architekturach (np. x86, lecz nie x86_64)
\fBexpm1\fP() rzucała nieprawidłowy wyjątek niedomiaru zmiennoprzecinkowego w
przypadku pewnych dużych, ujemnych wartości \fIx\fP (gdzie wynik funkcji zbliża
się do \-1).
.P
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6814
.\" e.g., expm1(1e5) through expm1(1.00199970127e5),
.\" but not expm1(1.00199970128e5) and beyond.
Przed mniej więcej glibc 2.11 \fBexpm1\fP() niewłaściwie rzucała wyjątek
niepoprawnej operacji zmiennoprzecinkowej w połączeniu z oczekiwanym
wyjątkiem przekroczenia zakresu oraz zwracała NaN zamiast dodatniej
nieskończoności, dla pewnych dużych, dodatnich wartości \fIx\fP.
.P
.\" It looks like the fix was in glibc 2.11, or possibly glibc 2.12.
.\" I have no test system for glibc 2.11, but glibc 2.12 passes.
.\" From the source (sysdeps/i386/fpu/s_expm1.S) it looks
.\" like the changes were in glibc 2.11.
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6788
Przed glibc 2.11, implementacja glibc nie ustawiała \fIerrno\fP na \fBERANGE\fP,
gdy wystąpił błąd zakresu.
.SH "ZOBACZ TAKŻE"
\fBexp\fP(3), \fBlog\fP(3), \fBlog1p\fP(3)
.PP
.SH TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika:
Adam Byrtek <alpha@irc.pl>,
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 .
