lround

NAZWA

lround, lroundf, lroundl, llround, llroundf, llroundl - round to nearest integer

BIBLIOTEKA

Math library ( libm, -lm)

SKŁADNIA

#include <math.h>

long lround(double x);
long lroundf(float x);
long lroundl(long double x);

long long llround(double x);
long long llroundf(float x);
long long llroundl(long double x);

Wszystkie funkcje powyżej:

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

OPIS

These functions round their argument to the nearest integer value, rounding halfway cases away from zero, regardless of the current rounding direction (see fenv(3)). Proszę zauważyć, że w przeciwieństwie do funkcji round(3) i ceil(3) itp., typ wartości zwracanej przez te funkcje różni się od typu ich parametrów.

WARTOŚĆ ZWRACANA

Funkcje te zwracają zaokrągloną wartość całkowitą. Jeżeli x wynosi NaN lub nieskończoność lub zaokrąglona wartość jest zbyt duża, by mogła być umieszczona w typie long (lub long long w przypadku funkcji ll*), to występuje błąd dziedziny, a zwracana wartość nie jest określona.

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 wynosi NaN lub nieskończoność lub zaokrąglona wartość jest zbyt duża.

Rzucany jest wyjątek niepoprawnej operacji zmiennoprzecinkowej ( FE_INVALID).

Funkcje te nie ustawiają zmiennej errno.

WERSJE

These functions were added in glibc 2.1.

ATRYBUTY

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

Interfejs	Atrybut	Wartość
lround(), lroundf(), lroundl(), llround(), llroundf(), llroundl()	Bezpieczeństwo wątkowe	MT-Safe

STANDARDY

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

ZOBACZ TAKŻE

ceil(3), floor(3), lrint(3), nearbyint(3), rint(3), round(3)

TŁUMACZENIE

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz <[email protected]>, Robert Luberda <[email protected]> i Michał Kułach <[email protected]> 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 [email protected]