Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés
Se recomienda usar Visual Studio 2017
Esta documentación está archivada y no tiene mantenimiento.

_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Convierte una cadena en un valor de __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
);

nptr

Cadena terminada en null a convertir.

endptr

Puntero al carácter que detiene el análisis.

base

base de número a utilizar.

locale

la configuración regional a utilizar.

_strtoi64 devuelve el valor representado en la cadena nptr, excepto cuando la representación provocaría un desbordamiento, en cuyo caso devuelve _I64_MAX o _I64_MIN. La función devolverá 0 si ninguna conversión puede realizar. _wcstoi64 devuelve valores análogo a strtoi64.

_I64_MAX y _I64_MIN son definidas en LIMITS.H.

Si nptr es NULL o base es distinto de cero y menor que 2 o mayor que 36, errno se establece en EINVAL.

Vea _doserrno, errno, _sys_errlist, y _sys_nerr para obtener más información al respecto, y otro, códigos de retorno.

la funciónde _strtoi64convierte nptr a __int64. Deje de funciones que lee la cadena nptr en el primer carácter que no reconocen como parte de un número. Puede ser el carácter null de terminación, o puede ser el primer carácter numérico mayor o igual base. _wcstoi64 es una versión con caracteres anchos de _strtoi64; el argumento de nptr es una cadena de caracteres. Estas funciones se comportan exactamente igual de otra manera.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H

_UNICODE y _MBCS no definido

_MBCS definido

_UNICODE definido

_tcstoi64

_strtoi64

_strtoi64

_wcstoi64

_tcstoi64_l

_strtoi64_l

_strtoi64_l

_wcstoi64_l

El valor de categoría de LC_NUMERIC de la configuración regional determina el reconocimiento de carácter de la base de nptr; para obtener más información, vea setlocale. Las funciones sin el sufijo _l utilizan la configuración regional actual; _strtoi64_l y_wcstoi64_l son idénticos a la función correspondiente sin el sufijo de _l salvo que utilizan la configuración regional pasado en su lugar. Para obtener más información, vea Configuración regional.

Si endptr no es NULL, un puntero al carácter que se detuvo el análisis se almacena en la ubicación a la que endptr. Si ninguna conversión se puede realizar (no se encontraron dígitos válidos o base no válida se especificó), el valor de nptr se almacena en la ubicación a la que endptr.

_strtoi64 espera que nptr apunta a una cadena con el formato siguiente:

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

whitespace puede ser el espacio y los caracteres de tabulación, se omiten que; digits es uno o más dígitos decimales. El primer carácter que no encaja en este formulario detiene el análisis. Si base está entre 2 y 36, se utiliza como base del número. Si base es 0, los caracteres iniciales de la cadena indicada por a nptr se utilizan para determinar la base. si el primer carácter es 0 y el segundo carácter no es “x” o “X”, la cadena se interpreta como entero octal; si no, se interpreta como un número decimal. si el primer carácter es “0" y el segundo carácter es “x” o “X”, la cadena se interpreta como entero hexadecimal. si el primer carácter es “1" con “9", la cadena se interpreta como entero decimal. Las letras” a la “z” (o “A” a la “z ") se asignan los valores 10 a 35; sólo las letras cuyo asignaban valores son menos que base permitidos.

rutina

Encabezado necesario

_strtoi64 , _strtoi64_l

<stdlib.h>

_wcstoi64 , _wcstoi64_l

<stdlib.h> o <wchar.h>

Para obtener información adicional de compatibilidad, vea compatibilidad en la Introducción.

Mostrar: