nan, nanf, nanl − Fonctions renvoyant « Not a Number ».

#include <math.h>

double nan(const char *tagp);
float nanf(const char *tagp);
long double nanl(const char *tagp);

Ces fonctions renvoient une représentation (déterminée par tagp) d’un NaN (Not A Number, élément non-numérique indiquant un cas d’erreur dans les routines mathématiques). Si cette implémentation ne supporte pas support les NaNs, ces fonctions renvoient zéro.

L’appel nan("char-sequence") est équivalent à strtod("NAN(char-sequence)",NULL) ; de même nanf() et nanl() sont équivalentes aux appels analogues strtof () et strtold().

L’argument tagp est utilisé de manière non spécifiée. Sur les systèmes IEEE 754, il existe de nombreuses représentations de NaN, et tagp en sélectionne une. Sur les autres systèmes, il peut n’avoir aucun effet.

Pour utiliser les fonctions de la bibliothèque mathématique, il ne faut pas oublier d’ajouter l’argument −lm sur la ligne de commande de cc(1) ou ld(1), lors de l’édition des liens.

Pour cette fonction, vous devez également compiler avec l’option −std=c99.

C99. Voir aussi IEC 559 et l’annexe sur les fonctions recommendées dans IEEE 754/IEEE 854.

isnan(3), strtod(3)

Ce document est une traduction réalisée par Thierry Vignaud <tvignaud AT mandriva DOT com> en 2002 et révisée le 11 juillet 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=en man 3 nan ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.