strtod, strtof, strtold - Convertir une chaîne ASCII en nombre à
virgule flottante
Bibliothèque C standard (
libc,
-lc)
#include <stdlib.h>
double strtod(const char *restrict nptr, char **restrict endptr);
float strtof(const char *restrict nptr, char **restrict endptr);
long double strtold(const char *restrict nptr, char **restrict endptr);
strtof(),
strtold() :
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
Les fonctions
strtod(),
strtof() et
strtold() convertissent
la portion initiale de la chaîne pointée par
nptr en un
réel de type
double,
float, et
long double
respectivement.
La (portion initiale de la) chaîne attendue est de la forme
suivante : des espaces éventuels en tête, ou des
caractères interprétés comme tels par
isspace(3),
un éventuel signe plus (« + ») ou moins
(« - »), et ensuite soit (1) un nombre
décimal, soit (2) un nombre hexadécimal, soit (3) un infini,
soit (4) un non nombre
NAN (not-a-number).
Un
nombre décimal consiste en une séquence non vide de
chiffres décimaux, pouvant contenir un point décimal
(dépendant de la localisation, mais habituellement
« . »), suivi éventuellement d'un exposant
décimal. Ce dernier est constitué d'un
« E » ou « e » suivi
éventuellement du signe plus ou du signe moins, puis d’une
séquence non vide de chiffres décimaux, indiquant la
multiplication par une puissance de
10.
Un
nombre hexadécimal commence « 0x »
ou « 0X », suivi d'une séquence non vide de
chiffres hexadécimaux, pouvant contenir un point décimal suivi
éventuellement d'un exposant binaire. Ce dernier est constitué
d'un « P » ou « p »
suivi éventuellement du signe plus ou du signe moins, puis d’une
séquence non vide de chiffres décimaux, indiquant la
multiplication par une puissance de deux. Au moins un point ou un exposant
binaire doit être présent.
Un
infini est soit « INF », soit
« INFINITY », sans tenir compte des
différences entre majuscules et minuscules.
Un
non-nombre est « NAN » (sans tenir compte
de la casse) suivi éventuellement d'une chaîne
(n-char-sequence), où
n-char-sequence indique d'une
façon dépendante de l'implémentation le type de
NAN (consultez NOTES).
Ces fonctions renvoient la valeur convertie si c'est possible.
Si
endptr n'est pas NULL, un pointeur sur le caractère suivant le
dernier caractère converti est stocké dans l'emplacement
pointé par
endptr.
Si aucune conversion n'est possible, la fonction renvoie zéro, et
(à moins que
endptr soit NULL) la valeur de
nptr est
stockée dans
endptr.
Si la valeur convertie déclenche un débordement (overflow), la
fonction renvoie plus ou moins
HUGE_VAL,
HUGE_VALF ou
HUGE_VALL (en fonction du type de retour et du signe de la valeur) et
errno contient
ERANGE.
Si la valeur convertie déclenche un débordement inférieur
(underflow), la fonction renvoie une valeur de grandeur inférieure
à
DBL_MIN,
FLT_MIN ou
LDBL_MIN et
errno
contient
ERANGE.
- ERANGE
- Débordement.
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
| Interface |
Attribut |
Valeur |
|
strtod(), strtof(), strtold() |
Sécurité des threads |
MT-Safe locale |
POSIX.1-2001, POSIX.1-2008, C99.
Comme la valeur
0 peut légitimement être renvoyée
à la fois en cas de succès et d'échec, le programme
appelant doit positionner
errno à
0 avant l'appel, et
déterminer si une erreur s'est produite en regardant si
errno a
une valeur non nulle après l'appel.
Dans l'implémentation qui en est faite par la glibc, la
n-char-sequence qui suit
NAN est interprétée comme
un nombre entier (avec un préfixe « 0 » ou
« 0x » optionnel pour sélectionner la base
8 ou
16) placé dans la mantisse de la valeur
retournée.
Consultez l'exemple dans la page de manuel
strtol(3) ;
l'utilisation des fonctions décrites dans cette page de manuel est
identique.
atof(3),
atoi(3),
atol(3),
nan(3),
nanf(3),
nanl(3),
strfromd(3),
strtol(3),
strtoul(3)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Grégoire Scano <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]