NAZWA

       round, roundf, roundl - zaokrągla do najbliższej liczby całkowitej z omijaniem zera

BIBLIOTEKA

       Biblioteka matematyczna (libm, -lm)

SKŁADNIA

       #include <math.h>

       double round(double x);
       float roundf(float x);
       long double roundl(long double x);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       round(), roundf(), roundl():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

OPIS

       Funkcje  te  zaokrąglają x do najbliższej liczby całkowitej, ale w okolicy zera omijają zero (niezależnie
       od bieżącego kierunku zaokrąglania, patrz fenv(3)) zaokrąglając, tak jak rint(3), do  najbliższej  liczby
       parzystej.

       Na przykład round(0.5) zwraca 1.0, a round(-0.5) zwraca -1.0.

WARTOŚĆ ZWRACANA

       Funkcje te zwracają zaokrągloną wartość całkowitą.

       Jeśli x jest całkowite, +0, -0, NaN lub nieskończoność, to zwracane jest x.

BŁĘDY

       Nie występują.

ATRYBUTY

       Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).
       ┌──────────────────────────────────────────────────────────────┬────────────────────────┬───────────────┐
       │ Interfejs                                                    │ Atrybut                │ Wartość       │
       ├──────────────────────────────────────────────────────────────┼────────────────────────┼───────────────┤
       │ round(), roundf(), roundl()                                  │ Bezpieczeństwo wątkowe │ MT-bezpieczne │
       └──────────────────────────────────────────────────────────────┴────────────────────────┴───────────────┘

STANDARDY

       C11, POSIX.1-2008.

HISTORIA

       glibc 2.1.  C99, POSIX.1-2001.

       POSIX.1-2001  zawiera tekst dotyczący przepełnienia (które może spowodować ustawienie errno na ERANGE lub
       spowodować  wyjątek  FE_OVERFLOW).  W  praktyce  wynik  nie  może  spowodować  przepełnienia  na   żadnej
       współczesnej  maszynie,  więc  obsługa  tego błędu była po prostu bezsensowna. (Dokładniej, przepełnienie
       może wystąpić, tylko gdy wartość maksymalna wykładnika jest mniejsza niż  liczba  bitów  mantysy.  Według
       standardu  IEEE-754  dla 32 i 64-bitowych liczb zmiennoprzecinkowych wartość maksymalna wykładnika wynosi
       127 (odpowiednio 1023), a liczba bitów mantysy (włącznie z niejawnym bitem) wynosi 24 (odpowiednio  53)).
       Usunięto to w POSIX.1-2008.

       Aby  przechowywać  zaokrągloną  wartość  w  typie  całkowitym,  należy  użyć jednej z funkcji opisanych w
       podręczniku lround(3).

ZOBACZ TAKŻE

       ceil(3), floor(3), lround(3), nearbyint(3), rint(3), trunc(3)

TŁUMACZENIE

       Tłumaczenie niniejszej strony  podręcznika:  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  listy  dyskusyjnej manpages-pl-
       list@lists.sourceforge.net.

Linux man-pages 6.9.1                          16 czerwca 2024 r.                                       round(3)