nearbyint, nearbyintf, nearbyintl

Zaokrouhlí zadanou hodnotu s plovoucí desetinou čárkou na celé číslo a vrátí danou hodnotu ve formátu s plovoucí desetinou čárkou.

Syntaxe

double nearbyint( double x );
float nearbyintf( float x );
long double nearbyintl( long double x );
#define nearbyint( X ) // Requires C11 or higher

float nearbyint( float x ); //C++ only
long double nearbyint( long double x ); //C++ only

Parametry

x
Hodnota, která se má zaokrouhlit.

Vrácená hodnota

V případě úspěchu vrátí hodnotu xzaokrouhlenou na nejbližší celé číslo pomocí aktuálního formátu zaokrouhlování podle .fegetround V opačném případě může funkce vrátit jednu z následujících hodnot:

Problém	Vrácení
x = ±INFINITY	±INFINITY, nezměněné
x = ±0	±0, nezměněné
x = NaN	NaN

Chyby nejsou hlášeny prostřednictvím _matherr, konkrétně tato funkce nehlásí žádné FE_INEXACT výjimky.

Poznámky

Hlavním rozdílem mezi touto funkcí a rint je, že tato funkce nevyvolá výjimku s plovoucí desetinou čárkou.

Vzhledem k tomu, že maximální hodnoty s plovoucí desetinou čárkou jsou přesná celá čísla, nebude tato funkce nikdy přetékat sama sebou; Výstup může přetéct návratové hodnoty v závislosti na tom, jakou verzi funkce používáte.

Jazyk C++ umožňuje přetížení, takže můžete volat přetíženínearbyint, která přebírají a vracejí nebo long double parametryfloat. Pokud v programu jazyka C nepoužíváte <makro tgmath.h> k volání této funkce, nearbyint vždy přebírá dvě dvojité hodnoty a vrací dvojitou hodnotu.

Pokud použijete <makro tgmath.h>nearbyint() , typ argumentu určuje, která verze funkce je vybrána. Podrobnosti najdete v tématu Matematika pro obecné typy.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Function	Záhlaví jazyka C	Hlavička jazyka C++
nearbyint, nearbyintf, nearbyintl	<math.h>	<cmath> nebo <math.h>
nearbyint Makro	<tgmath.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Viz také

Abecední odkaz na funkci
Podpora pro matematiku a plovoucí desetinou čárku