Se recomienda usar Visual Studio 2017

_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

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

Parámetros

nptr
Cadena terminada en NULL que se va a convertir.

endptr
Puntero al carácter que detiene el examen.

base
Base numérica que se va a usar.

locale
Configuración regional que se va a usar.

_strtoi64 devuelve el valor que se representa en la cadena nptr, excepto cuando la representación produciría desbordamiento, en cuyo caso devuelve _I64_MAX o _I64_MIN. La función devuelve 0 si no se puede realizar ninguna conversión. _wcstoi64 devuelve valores de manera parecida a strtoi64.

Los objetos _I64_MAX y _I64_MIN se definen 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.

Consulte _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros, códigos de retorno.

El _strtoi64función convierte nptr a una __int64. Ambas funciones dejan de leer la cadena nptr en el primer carácter que no reconocen como parte de un número. Puede tratarse del carácter nulo final o del primer carácter numérico mayor o igual que base. _wcstoi64 es una versión con caracteres anchos de _strtoi64; su argumento nptr es una cadena de caracteres anchos. Por lo demás, estas funciones se comportan exactamente igual.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tcstoi64_strtoi64_strtoi64_wcstoi64
_tcstoi64_l_strtoi64_l_strtoi64_l_wcstoi64_l

La configuración regional LC_NUMERIC valor de la categoría determina el reconocimiento del carácter base en nptr ; para obtener más información, consulte setlocale. Las funciones sin el sufijo _l usan la configuración regional actual. _strtoi64_l y_wcstoi64_l son idénticas a la función correspondiente sin el _l sufijo salvo que usan la configuración regional que se pasa en su lugar. Para obtener más información, vea Locale.

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

_strtoi64espera nptr para que apunte a una cadena de la forma siguiente:

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

whitespace puede estar formado por caracteres de espacio y tabulación, que se omiten; digits es uno o varios dígitos decimales. El primer carácter que no se ajusta a este formato detiene el análisis. Si base está entre 2 y 36, se usa como base del número. Si base es 0, los caracteres iniciales de la cadena a la que apunta nptr se usan para determinar la base. Si el primer carácter es 0 y el segundo carácter no es 'x' ni 'X', la cadena se interpreta como entero octal. 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 está entre&1; y&9;, la cadena se interpreta como entero decimal. A las letras de la 'a' a la 'z' (o de la 'A' a la 'Z') se les asignan los valores del 10 al 35. Solo se admiten las letras cuyos valores asignados son menores que base. El primer carácter que está fuera del intervalo de la base detiene el análisis. Por ejemplo, si base es 0 y el primer carácter examinado es "0", se supone un entero octal y los caracteres "8" o "9 detendrán el análisis.

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

Conversión de datos
Configuración regional
localeconv
setlocale, _wsetlocale
Cadena de funciones con valores numéricos
strtod, _strtod_l, wcstod, _wcstod_l
strtoul, _strtoul_l, wcstoul, _wcstoul_l
atof, _atof_l, _wtof, _wtof_l

Mostrar: