strtoul, _strtoul_l, wcstoul, _wcstoul_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Convertir des chaînes en une valeur entière de type long 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  
);  

Paramètres

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.

strtoulRetourne la valeur convertie, si une, ou ULONG_MAX de dépassement de capacité. strtoulretourne 0 si aucune conversion ne peut être effectuée. wcstoulRetourne des valeurs de manière similaire à strtoul. Pour les deux fonctions, errno est défini sur ERANGE cas de dépassement de capacité positif ou négatif.

Pour plus d’informations sur ce code de retour et sur les autres codes, consultez _doserrno, errno, _sys_errlist, and _sys_nerr .

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

strtoularrête la lecture de la chaîne nptr au premier caractère qu’il ne peut pas identifier comme partie d’un nombre. Cela peut être le caractère null de fin, ou il peut être le premier caractère numérique supérieur ou égale à base. Le LC_NUMERIC catégorie de paramètres régionaux détermine la reconnaissance du caractère de base nptr; pour plus d’informations, consultez setlocale. strtoulet wcstoul utilisent les paramètres régionaux en cours ; _strtoul_l et _wcstoul_l sont identiques, sauf qu’ils utilisent les paramètres régionaux passé à la place. Pour plus d’informations, consultez Locale.

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

wcstoulest une version à caractère élargi de strtoul; son nptr argument 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 et _MBCS non définis_MBCS défini_UNICODE défini
_tcstoulstrtoulstrtoulwcstoul
_tcstoul_lstrtoul_l_strtoul_l_wcstoul_l

strtoulattend nptr pour pointer vers une chaîne sous la forme suivante :

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

Un whitespace peut contenir les caractères espace et la 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 comprise entre 2 et 36, il est utilisé comme base du nombre. Si base est 0, les premiers caractères de la chaîne pointée par nptr servent à déterminer la base. Si le premier caractère est 0 et que 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 « 1 « à « 9 », la chaîne est interprétée comme un entier décimal. Les lettres « a » à « z » (ou « A » à « Z ») est affecté les valeurs 10 à 35 ; Seuls les lettres dont les valeurs affectées sont moins base sont autorisées. Le premier caractère en dehors de la plage de la base de l’arrête. Par exemple, si base est 0 et le premier caractère analysé est « 0 », entier octal est supposé et un caractère '8' ou '9' arrête l’analyse. strtoulpermet à un signe plus (+) ou moins () préfixe ; un signe moins indique que la valeur de retour est inversée.

RoutineEn-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é, voir Compatibilité dans l'introduction.

Consultez l’exemple de strtod.

System::Convert::ToUInt64

Conversion de données
Paramètres régionaux
localeconv
SetLocale, _wsetlocale
Chaîne à des fonctions de valeur numérique
strtod, _strtod_l, wcstod, _wcstod_l
strtol, wcstol, _strtol_l, _wcstol_l
atof, _atof_l, _wtof, _wtof_l

Afficher: