nearbyint, , nearbyintfnearbyintl
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 | Zpět |
|---|---|
x = ±INFINITY |
±INFINITY, nezměněné |
x = ±0 |
±0, nezměněné |
x = NaN |
Není číslo |
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, , nearbyintfnearbyintl |
<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