_strtoi64, _wcstoi64, _strtoi64_l, _wcstoi64_l

Artículo
02/19/2013

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
);

Parámetros

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.

Valor devuelto

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

Comentarios

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.

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