NAZWA

       round, roundf, roundl - zaokrąglenie 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ą. POSIX.1-2001 dokumentuje błąd zakresu przy przepełnieniu — patrz UWAGI.

WERSJE

       Funkcje te dodano w glibc 2.1.

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-Safe │
       └──────────────────────────────────────────────────────┴────────────────────────┴─────────┘

STANDARDY

       C99, POSIX.1-2001, POSIX.1-2008.

UWAGI

       POSIX.1-2001 contains text about overflow (which might set errno to ERANGE,  or  raise  an
       FE_OVERFLOW  exception).   In practice, the result cannot overflow on any current machine,
       so this error-handling stuff is just nonsense.  (More precisely, overflow can happen  only
       when  the  maximum value of the exponent is smaller than the number of mantissa bits.  For
       the IEEE-754 standard 32-bit and 64-bit floating-point numbers the maximum  value  of  the
       exponent  is  127  (respectively,  1023),  and  the  number of mantissa bits including the
       implicit bit is 24 (respectively, 53).)

       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

       Autorami  polskiego  tłumaczenia  niniejszej strony podręcznika są: 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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   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⟩.