_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Article
06/09/2015

Convertit une chaîne en valeur __int64.

__int64 _strtoi64(
   const char *nptr,
   char **endptr,
   int base 
);
__int64 _wcstoi64(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
__int64 _strtoi64_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
__int64 _wcstoi64_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.

Valeur de retour

_strtoi64retourne la valeur représentée dans la chaîne nptr, sauf quand la représentation causerait un dépassement de capacité, auquel cas il renvoie _I64_MAX or _I64_MIN. La fonction retournera 0 si aucune conversion ne peut être effectuée. _wcstoi64 retourne les valeurs de façon analogue à strtoi64.

_I64_MAX et _I64_MIN sont définis dans LIMITS.H.

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

Consultez _doserrno, errno, _sys_errlist et _sys_nerr pour plus d'informations sur ces éléments et autres codes de retour.

Notes

La fonction _strtoi64convertit nptr en __int64. Les deux fonctions cessent de lire la chaîne nptr au premier caractère qu'elles ne peuvent 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. _wcstoi64 est une version à caractères larges de _strtoi64; son argument nptr est une chaîne à caractères larges. Ces fonctions se comportent sinon 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
_tcstoi64	_strtoi64	_strtoi64	_wcstoi64
_tcstoi64_l	_strtoi64_l	_strtoi64_l	_wcstoi64_l

Le paramètre de la catégorie LC_NUMERIC des paramètres régionaux détermine la reconnaissance des caractères de base dans nptr*;* . Pour plus d'informations, consultez setlocale. Les fonctions qui ne disposent pas du suffixe _l utilisent les paramètres régionaux actuels _strtoi64_let les suffixes_wcstoi64_lsont identiques à la fonction correspondante qui ne dispose pas du suffixe _l, sauf qu'elle utilise à la place les paramètres régionaux 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.

_strtoi64attend nptrpour 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.