Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

strtoul, _strtoul_l, wcstoul, _wcstoul_l

Convertit des chaînes en une longue valeur entière non signée.

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
);

nptr

Chaîne terminée par Null à convertir.

endptr

Pointeur vers le caractère qui arrête l'analyse.

base

Base numérique à utiliser.

locale

Paramètres régionaux à utiliser.

strtoul retourne la valeur convertie, le cas échéant, ou ULONG_MAX en cas de dépassement de capacité. strtoul retourne 0 si aucune conversion ne peut être exécutée. wcstoul retourne les valeurs de façon analogue à strtoul. Pour les deux fonctions, errno a la valeur ERANGE en cas de surcapacité ou de sous-capacité.

Consultez _doserrno, errno, _sys_errlist et _sys_nerr pour plus d'informations sur ceci et d'autres codes de retour.

Chacune de ces fonctions convertit la chaîne d'entrée nptr à une valeur entière unsigned long.

La fonction strtoul arrête de lire la chaîne nptr au premier caractère qu'elle ne peut pas reconnaître comme faisant partie d'un nombre. Il peut s'agir du caractère null de fin, ou il peut s'agir du premier caractère numérique supérieur ou égal à base. Le paramètre de la catégorie LC_NUMERIC des paramètres régionaux actuels détermine la reconnaissance des caractères de base dans nptr. Pour plus d'informations, consultez setlocale. strtoul et wcstoul utilisent les paramètres régionaux courants; _strtoul_l et _wcstoul_l sont identiques sauf qu'ils utilisent plutôt les paramètres régionaux qui leurs sont passés. Pour plus d'informations, consultez Paramètres régionaux.

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

wcstoul est une version à caractères larges de strtoul; son argument nptr est une chaîne à caractères larges. Sinon ces fonctions se comportent de façon identique.

Mappages de routines de texte générique

Routine TCHAR.H

_UNICODE & _MBCS non définis

_MBCS défini

_UNICODE défini

_tcstoul

strtoul

strtoul

wcstoul

_tcstoul_l

strtoul_l

_strtoul_l

_wcstoul_l

strtoul attend nptr pour pointer vers une chaîne au format suivant :

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

whitespace peut être composé de caractères espace et tabulation, qui sont ignorés ; digits sont un ou plusieurs chiffres décimaux. Le premier caractère qui ne correspond pas à ce formulaire arrête l'analyse. Si base est compris 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 sont 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. 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 compris entre « 1 » et « 9 », la chaîne est interprétée comme un entier décimal. Les valeurs 10 à 35 sont assignées aux lettres « à » à « z » (ou « À » à « Z ») ; seules les lettres dont les valeurs assignées sont inférieures à base sont autorisées. Le premier caractère en dehors de la plage de la base arrête l'analyse. Par exemple, si base correspond à 0 et le premier caractère analysé est « 0 », un entier octal est supposé et un caractère « 8 » ou « 9 » arrêtera l'analyse. strtoul autorise un préfixe de signe plus (+) ou de signe moins () ; un signe moins indique que la valeur de retour est négative.

Routine

En-tête requis

strtoul

<stdlib.h>

wcstoul

<stdlib.h> ou <wchar.h>

_strtoul_l

<stdlib.h>

_wcstoul_l

<stdlib.h> ou <wchar.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Consultez l'exemple de strtod.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft