Fonctions
des bibliothèques (section 3) strtoul
Nom
strtoul - Convertir une chaîne en un entier long non-signé.Synopsis
#include <stdlib.h> unsigned long int strtoul (const char *nptr, char **endptr,int base)
Description
La fonction strtoul() convertit la chaîne nptr en un entier long en fonction de l'argument base, qui doit être dans l'intervalle 2 à 36 (bornes comprises), ou avoir la valeur spéciale 0.La chaîne peut commencer par un nombre quelconque d'espaces ou de caractères interprétés comme tels par isspace(3) . Un signe éventuel `+' ou `-' peut suivre. Si base vaut 0 ou 16, la chaîne peut inclure un préfixe `0x' et le nombre sera interprété en base 16. Sinon, une base valant zéro est interprétée comme 10 (décimale) sauf si le caractère suivant est `0', auquel cas la base est 8 (octale).
Le reste de la chaîne est converti en une valeur entière longue, en s'arrêtant au premier caractère qui ne soit pas un chiffre valide. Dans les bases supérieures a 10, la lettre `A' (majuscule ou minuscule) représente 10, `B' représente 11, et ainsi de suite jusqu'à `Z' représentant 35.
Si endptr n'est pas NULL, strtoul() stocke l'adresse du premier caractère invalide dans *endptr. S'il n'y avait aucun chiffre valide, strtoul() stocke la valeur originale de nptr dans *endptr. (Donc, si *nptr n'est pas `\0' et si **endptr vaut `\0' en retour, la chaîne entière est valide.)
Valeur Renvoyée
La fonction strtoul() renvoie soit le résultat de la conversion, soit, s'il y avait un signe moins, l'inverse du résultat de la conversion à moins que la valeur originale provoque un débordement, auquel cas strtoul() renvoie ULONG_MAX et errno contient le code d'erreur ERANGE.Erreurs
- ERANGE
- La chaîne donnée est hors limites. La valeur a été arrondie.
Conformité
SVID 3, BSD 4.3, ISO 9899Voir Aussi
atof(3) , atoi(3) , atol(3) , strtod(3) , strtol(3)Bogues
La fonction strtoul() ignore la localisation.
Traduction
Christophe Blaess, 1997.