nearbyint, nearbyintf, nearbyintl

Arrotonda il valore a virgola mobile specificato a un intero e restituisce tale valore in un formato a virgola mobile.

Sintassi

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

Parametri

x
Il valore da arrotondare.

Valore restituito

Se ha esito positivo, restituisce x, arrotondato all'intero più vicino, utilizzando il formato di arrotondamento corrente come segnalato da fegetround. In caso contrario, la funzione può restituire uno dei valori seguenti:

Problema	Restituzione
x = ±INFINITY	±INFINITY, non modificato
x = ±0	±0, non modificato
x = NaN	NaN

Gli errori non vengono segnalati tramite _matherr. In particolare, questa funzione non segnala eccezioni FE_INEXACT .

Osservazioni:

La differenza principale tra questa funzione e rint è che questa funzione non genera l'eccezione a virgola mobile inesattiva.

Dato che i valori a virgola massimi sono interi esatti, questa funzione da sola non genererà mai un overflow. È invece possibile un overflow del valore restituito nell'output, a seconda della versione della funzione usata.

C++ consente l'overload, quindi è possibile chiamare overload di nearbyint che accettino e restituiscano i parametri float e long double. In un programma C, a meno che non si usi la <macro tgmath.h> per chiamare questa funzione, nearbyint accetta sempre due valori double e restituisce un valore double.

Se si utilizza la <macro tgmath.h>nearbyint() , il tipo dell'argomento determina quale versione della funzione è selezionata. Per informazioni dettagliate, vedere La matematica generica dei tipi.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Funzione	Intestazione C	Intestazione C++
nearbyint, nearbyintf, nearbyintl	<math.h>	<cmath> o <math.h>
nearbyint macro	<tgmath.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

Informazioni di riferimento sulle funzioni alfabetiche
Supporto matematico e a virgola mobile