Partager via


_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Convertit une chaîne en valeur d' __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 le caractère NULL à convertir.

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

  • base
    Base numérique à utiliser.

  • locale
    Les paramètres régionaux à utiliser.

Valeur de retour

_strtoi64retourne la valeur représentée dans la chaîne nptr, sauf lorsque la représentation peut provoquer un dépassement de capacité, auquel cas il retourne _I64_MAX ou _I64_MIN.La fonction retourne 0 si aucune conversion ne peut être exécutée.retourne des valeurs d'_wcstoi64 de façon similaire aux 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érieur à 2 ou supérieure à 36, errno est défini à EINVAL.

Consultez _doserrno, errno, _sys_errlist, et _sys_nerr pour plus d'informations sur ce point, ainsi que d'autres, les codes de retour.

Notes

la fonctiond' _strtoi64convertit nptr à __int64.Arrêt de les deux fonctions lisant la chaîne nptr au premier caractère qu'ils ne peuvent pas identifier 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._wcstoi64 est une version à caractère élargi d' _strtoi64; son argument d' nptr est une chaîne à caractères larges.Ces fonctions se comportent de sinon.

mappages de routines de texte générique

routine de TCHAR.H

_MBCS & de _UNICODE non défini

_MBCS défini

_UNICODE défini

_tcstoi64

_strtoi64

_strtoi64

_wcstoi64

_tcstoi64_l

_strtoi64_l

_strtoi64_l

_wcstoi64_l

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.Les fonctions sans le suffixe de _l utilisent les paramètres régionaux ; _strtoi64_l et_wcstoi64_l sont identiques à la fonctionnalité correspondante sans le suffixe d' _l à 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.

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

Configuration requise

routine

en-tête requis

_strtoi64, _strtoi64_l

<stdlib.h>

_wcstoi64, _wcstoi64_l

<stdlib.h> ou <wchar.h>

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

Voir aussi

Référence

Conversion de données

Paramètres régionaux

localeconv

setlocale, _wsetlocale

Chaîne aux fonctions de valeur numérique

strtod, _strtod_l, wcstod, _wcstod_l

strtoul, _strtoul_l, wcstoul, _wcstoul_l

atof, _atof_l, _wtof, _wtof_l