Namespaces
Variants

std:: isnan

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
isnan
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
Défini dans l'en-tête <cmath>
(1)
bool isnan ( float num ) ;

bool isnan ( double num ) ;

bool isnan ( long double num ) ;
(depuis C++11)
(jusqu'à C++23)
constexpr bool isnan ( /*floating-point-type*/ num ) ;
(depuis C++23)
Surcharge SIMD (depuis C++26)
Défini dans l'en-tête <simd>
template < /*math-floating-point*/ V >

constexpr typename /*deduced-simd-t*/ < V > :: mask_type

isnan ( const V & v_num ) ;
(S) (depuis C++26)
Défini dans l'en-tête <cmath>
template < class Integer >
bool isnan ( Integer num ) ;
(A) (depuis C++11)
(constexpr depuis C++23)
1) Détermine si le nombre à virgule flottante donné num est une valeur non numérique (NaN). La bibliothèque fournit des surcharges pour tous les types à virgule flottante non qualifiés cv comme type du paramètre num . (depuis C++23)
S) La surcharge SIMD effectue un std::isnan élément par élément sur v_num .
(Voir math-floating-point et deduced-simd-t pour leurs définitions.)
(depuis C++26)
A) Des surcharges supplémentaires sont fournies pour tous les types entiers, qui sont traités comme double .

Table des matières

Paramètres

num - valeur à virgule flottante ou entière
v_num - un objet parallèle de données de std::basic_simd spécialisation où son type d'élément est un type à virgule flottante

Valeur de retour

1) true si num est un NaN, false sinon.
S) Un objet masque data-parallel où le i ème élément est égal à true si v_num [ i ] est un NaN ou false sinon pour tout i dans l'intervalle [ ​ 0 ​ , v_num. size ( ) ) .

Notes

Il existe de nombreuses valeurs NaN différentes avec des bits de signe et des charges utiles distincts, voir std::nan et std::numeric_limits::quiet_NaN .

Les valeurs NaN ne sont jamais égales à elles-mêmes ni à d'autres valeurs NaN. La copie d'un NaN n'est pas obligatoire, selon IEEE-754, pour préserver sa représentation binaire (signe et payload ), bien que la plupart des implémentations le fassent.

Une autre manière de tester si une valeur à virgule flottante est NaN est de la comparer avec elle-même : bool is_nan ( double x ) { return x ! = x ; } .

GCC et Clang prennent en charge une option -ffinite-math (également impliquée par -ffast-math ), qui permet au compilateur respectif de supposer l'inexistence de valeurs spéciales à virgule flottante IEEE-754 telles que NaN, l'infini ou le zéro négatif. En d'autres termes, std::isnan est supposé retourner toujours false sous cette option.

Les surcharges supplémentaires ne sont pas requises d'être fournies exactement comme (A) . Elles doivent seulement être suffisantes pour garantir que pour leur argument num de type entier, std :: isnan ( num ) ait le même effet que std :: isnan ( static_cast < double > ( num ) ) .

Exemple

Exécuter ce code 
#include <cfloat>
#include <cmath>
#include <iostream>
int main()
{
    std::cout << std::boolalpha
              << "isnan(NaN) = " << std::isnan(NAN) << '\n'
              << "isnan(Inf) = " << std::isnan(INFINITY) << '\n'
              << "isnan(0.0) = " << std::isnan(0.0) << '\n'
              << "isnan(DBL_MIN/2.0) = " << std::isnan(DBL_MIN / 2.0) << '\n'
              << "isnan(0.0 / 0.0)   = " << std::isnan(0.0 / 0.0) << '\n'
              << "isnan(Inf - Inf)   = " << std::isnan(INFINITY - INFINITY) << '\n';
}

Sortie : 

isnan(NaN) = true
isnan(Inf) = false
isnan(0.0) = false
isnan(DBL_MIN/2.0) = false
isnan(0.0 / 0.0)   = true
isnan(Inf - Inf)   = true

Voir aussi

(C++11) (C++11) (C++11)
pas un nombre (NaN)
(fonction)
(C++11)
catégorise la valeur à virgule flottante donnée
(fonction)
(C++11)
vérifie si le nombre donné a une valeur finie
(fonction)
(C++11)
vérifie si le nombre donné est infini
(fonction)
(C++11)
vérifie si le nombre donné est normal
(fonction)
(C++11)
vérifie si deux valeurs à virgule flottante ne sont pas ordonnées
(fonction)
Documentation C pour isnan