strtoul, _strtoul_l, wcstoul, _wcstoul_l

Article
03/04/2013

Chaînes de converti en une valeur non signée de long-entier.

unsigned long strtoul(
   const char *nptr,
   char **endptr,
   int base 
);
unsigned long _strtoul_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long wcstoul(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
unsigned long _wcstoul_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

Paramètres

nptr
Chaîne terminée par le caractère NULL à convertir.
endptr
Pointeur vers le caractère qui arrête l'analyse.
base
Base numérique à utiliser.
locale
Paramètres régionaux à utiliser.

Valeur de retour

strtoul retourne la valeur convertie, le cas échéant, ou ULONG_MAX sur le dépassement de capacité.strtoul retourne 0 si aucune conversion ne peut être exécutée.retourne des valeurs d'wcstoul de façon similaire aux strtoul.Pour les deux fonctions, errno est défini à ERANGE si le dépassement de capacité ou le dépassement de capacité se produit.

Consultez _doserrno, errno, _sys_errlist, et _sys_nerr pour plus d'informations sur cette opération, ainsi que d'autres, les codes de retour.

Notes

Chacune de ces fonctions convertit la chaîne d'entrée nptr à unsigned long.

strtoul arrête de lire la chaîne nptr au premier caractère qu'il ne peut pas reconnaître dans le cadre d'un nombre.Cela peut être le caractère NULL de fin, ou peut être le premier chiffre supérieur ou égal à base.le paramètre de catégorie d' LC_NUMERIC des paramètres régionaux détermine la reconnaissance du caractère de base dans nptr; pour plus d'informations, consultez setlocale.strtoul etwcstoul utilisent les paramètres régionaux ; _strtoul_l et_wcstoul_l sont identiques à la différence qu'ils utilisent les paramètres régionaux passés à la place.Pour plus d'informations, consultez Paramètres régionaux.

Si endptr n'est pas NULL, un pointeur vers le caractère qui a arrêté l'analyse est stocké dans l'emplacement pointé par endptr.Si aucune conversion ne peut être exécutée (aucun chiffre valide n'a été trouvé ou une base non valide a été spécifiée), la valeur d' nptr est enregistrée à l'emplacement pointé par endptr.

wcstoul est une version à caractère élargi d' strtoul; son argument d' nptr est une chaîne à caractères larges.Sinon ces fonctions ont un comportement identique.

mappages de routines de texte générique

routine de TCHAR.H	_MBCS & de _UNICODE non défini	_MBCS défini	_UNICODE défini
_tcstoul	strtoul	strtoul	wcstoul
_tcstoul_l	strtoul_l	_strtoul_l	_wcstoul_l

strtoul attend nptr indique une chaîne au format suivant :

[whitespace] [{+ | –}] [0 [{ x | X }]] [digits]

whitespace peut se composer d'espaces et des tabulations, qui sont ignorés ; digits sont un ou plusieurs chiffres décimaux.Le premier caractère qui ne rentre pas les arrêts de ce formulaire l'analyse.Si base est comprise entre 2 et 36, il est utilisé comme base du nombre.Si base est 0, les caractères initiaux de la chaîne désignée par nptr utilisés pour déterminer la base.Si le premier caractère est 0 et le deuxième caractère n'est pas « x » ou « X », la chaîne est interprétée comme un entier octal ; sinon, il est interprète comme un nombre décimal.Si le premier caractère est « 0 " et le deuxième caractère est « x » ou « X », la chaîne est interprétée comme un entier hexadécimal.Si le premier caractère est « 1 " à « 9 ", la chaîne est interprétée comme un entier décimal.Les lettres » à « z » (ou « A » à « Z ") sont assignées les valeurs 10 et 35 ; seuls les lettres dont les valeurs attribuées sont moins qu' base sont autorisées.strtoul permet de mettre plus (+) ou moins le préfixe de signature (d'–) ; un signe moins indique que la valeur de retour est négative.