table of contents
- buster 1:0.7-1
- buster-backports 1:4.2.0-1~bpo10+2
- testing 1:4.2.0-1
- unstable 1:4.2.0-1
REMAINDER(3) | Podręcznik programisty Linuksa | REMAINDER(3) |
NAZWA¶
drem, dremf, dreml, remainder, remainderf, remainderl - reszta z dzielenia zmiennoprzecinkowegoSKŁADNIA¶
#include <math.h>
/* Wersje C99 */ double remainder(double x, double y); float remainderf(float x, float y); long double remainderl(long double x, long double y);
/* Przestarzałe synonimy */ double drem(double x, double y); float dremf(float x, float y); long double dreml(long double x, long double y);Proszę linkować z -lm.
Wymagane ustawienia makr biblioteki glibc (patrz
feature_test_macros(7)):
remainder():
remainderf(), remainderl():
drem(), dremf(), dreml():
OPIS¶
Funkcje te obliczają resztę z dzielenia x przez y. Zwracana wartość to x-n*y, gdzie n jest wynikiem dzielenia x / y, zaokrąglonym do najbliższej liczby całkowitej. Jeśli wartość bezwzględna z x-n*y wynosi 0.5, to n jest zaokrąglane do liczby parzystej.Funkcje te nie zależą od bieżącego kierunku zaokrąglania (patrz fenv(3)).
Funkcja drem() robi dokładnie to samo.
WARTOŚĆ ZWRACANA¶
Funkcje te, gdy się zakończą pomyślnie, zwracają resztę z dzielenia zmiennoprzecinkowego x-n*y. Jeśli wynikiem jest 0, to przyjmuje ono znak taki sam jak znak argumentu x.Jeśli x lub y jest NaN, to zwracane jest NaN.
Jeśli x jest równe nieskończoności, a y jest różne od NaN, to występuje błąd dziedziny i zwracane jest NaN.
Jeśli y wynosi zero, a x jest różne od NaN, to występuje błąd dziedziny i zwracane jest NaN.
BŁĘDY¶
Informacje o tym, jak określić, czy wystąpił błąd podczas wywołania tych funkcji, można znaleźć w podręczniku math_error(7).Mogą wystąpić następujące błędy:
- Błąd dziedziny: x jest nieskończonością, a y nie jest NaN
- errno is set to EDOM (but see BUGS). An invalid floating-point exception (FE_INVALID) is raised.
- Funkcje te nie ustawiają errno w tym przypadku.
- Błąd dziedziny: y jest równe zero
- errno jest ustawiane na EDOM. Rzucany jest wyjątek niepoprawnej operacji zmiennoprzecinkowej (FE_INVALID).
ATRYBUTY¶
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).Interfejs | Atrybut | Wartość |
drem(), dremf(), dreml(), remainder(), remainderf(), remainderl() | Bezpieczeństwo wątkowe | MT-Safe |
ZGODNE Z¶
Funkcje remainder(), remainderf() oraz remainderl() są wymienione w C99, POSIX.1-2001 i POSIX.1-2008.Funkcja drem() pochodzi z 4.3BSD. Warianty przyjmujące float oraz long double, czyli dremf() i dreml() istnieją w niektórych systemach takich jak Tru64 i glibc2. Prosimy unikać używania tych funkcji, preferując remainder() itd. zamiast nich.
BŁĘDY¶
Before glibc 2.15, the callremainder(nan(""), 0);
returned a NaN, as expected, but wrongly caused a domain error. Since glibc 2.15, a silent NaN (i.e., no domain error) is returned.
Before glibc 2.15, errno was not set to EDOM for the domain error that occurs when x is an infinity and y is not a NaN.
PRZYKŁAD¶
Wywołanie "remainder(29.0, 3.0)" zwraca -1.ZOBACZ TAKŻE¶
div(3), fmod(3), remquo(3)O STRONIE¶
Angielska wersja tej strony pochodzi z wydania 5.04 projektu Linux man-pages. 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/.TŁUMACZENIE¶
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: 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>Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres <manpages-pl-list@lists.sourceforge.net>.
15 września 2017 r. |