strtoll, _strtoll_l, wcstoll, _wcstoll_l

Convertit une chaîne en valeur long long.

Syntaxe

long long strtoll(
   const char *strSource,
   char **endptr,
   int base
);
long long wcstoll(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base
);
long long _strtoll_l(
   const char *strSource,
   char **endptr,
   int base,
   _locale_t locale
);
long long _wcstoll_l(
   const wchar_t *strSource,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

Paramètres

strSource
Chaîne se terminant par un caractère Null à convertir.

endptr
Pointeur désignant le caractère qui arrête l’analyse.

base
Base numérique à utiliser.

locale
Paramètres régionaux à utiliser.

Valeur retournée

La fonction strtoll retourne la valeur représentée dans la chaîne strSource, sauf dans le cas où la représentation entraînerait un dépassement de capacité positif (dans ce cas, elle retourne LLONG_MAX ou LLONG_MIN). La fonction retourne 0 si aucune conversion ne peut être effectuée. wcstoll retourne des valeurs de façon analogue à strtoll.

LLONG_MAX et LLONG_MIN sont définis dans LIMITS.H.

Si strSource a la valeur NULL ou que base est différent de zéro et inférieur à 2 ou supérieur à 36, errno prend la valeur EINVAL.

Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

La fonction strtoll convertit strSource en long long. Les deux fonctions arrêtent de lire la chaîne strSource au premier caractère qu’elles ne peuvent pas reconnaître dans le cadre 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. wcstoll est une version à caractères larges de strtoll ; son argument strSource est une chaîne de caractères larges. Sinon, ces fonctions se comportent de façon identique.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routine de texte générique

Routine TCHAR.H	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tcstoll	strtoll	strtoll	wcstoll
_tcstoll_l	_strtoll_l	_strtoll_l	_wcstoll_l

Le paramètre de catégorie des LC_NUMERIC paramètres régionaux détermine la reconnaissance du caractère radix dans strSource; pour plus d’informations, voir setlocale, _wsetlocale. Les fonctions sans suffixe _l utilisent les paramètres régionaux actifs ; _strtoll_l et _wcstoll_l sont identiques aux fonctions correspondantes qui n’ont pas le suffixe, sauf qu’elles utilisent à la place les paramètres régionaux transmis. Pour plus d’informations, consultez Locale.

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

strtoll s’attend à ce que strSource pointe vers une chaîne au format suivant :

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

whitespace peut être constitué d’espaces et de tabulations, qui sont ignorés ; digits se compose d’un ou plusieurs chiffres décimaux ; letters comprend une ou plusieurs lettres, de « a » à « z » (ou de « A » à « Z »). Le premier caractère qui ne correspond pas à ce formulaire arrête l’analyse. Si base la valeur est comprise entre 2 et 36, elle est utilisée comme base du nombre. Si base a la valeur 0, les premiers caractères de la chaîne désignée par strSource 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 que le deuxième est « x » ou « X », la chaîne est interprétée comme étant un entier hexadécimal. Si le premier caractère est un chiffre compris entre « 1 » et « 9 », la chaîne est interprétée comme étant un entier décimal. Les lettres de « a » à « z » (ou de « A » à « Z ») se voient affecter des valeurs comprises entre 10 et 35 ; seules sont autorisées les lettres dont les valeurs affectées sont inférieures à base. Le premier caractère situé en dehors de la plage de la base a pour effet d’arrêter l’analyse. Par exemple, si base est égal à 0 et que le premier caractère analysé est « 0 », il est supposé qu’il s’agit d’un entier octal et un caractère « 8 » ou « 9 » a pour effet de stopper l’analyse.

Spécifications

Routine	En-tête requis
strtoll, _strtoll_l	<stdlib.h>
wcstoll, _wcstoll_l	<stdlib.h> ou <wchar.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

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