Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

strtoimax, _strtoimax_l, wcstoimax, _wcstoimax_l

Visual Studio 2013

Convierte una cadena a un valor entero de tipo entero con signo con mayor valor admitido.

intmax_t strtoimax(
   const char *nptr,
   char **endptr,
   int base 
);
intmax_t wcstoimax(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
intmax_t _strtoimax_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
intmax_t _wcstoimax_l(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base,
   _locale_t locale
);

nptr

Cadena terminada en NULL que se va a convertir.

endptr

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

base

Base numérica que se va a usar.

locale

Configuración regional que se va a usar.

strtoimax devuelve el valor que se representa en la cadena nptr, excepto cuando la representación produciría desbordamiento, en cuyo caso, devuelve INTMAX_MAX o INTMAX_MIN, y errno está establecido en ERANGE. La función devuelve 0 si no se puede realizar ninguna conversión. wcstoimax devuelve valores de manera parecida a strtoimax.

INTMAX_MAX e INTMAX_MIN se definen en stdint.h.

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

Para obtener más información sobre los códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.

La función strtoimax convierte nptr en intmax_t. La versión de caracteres anchos de strtoimax es wcstoimax; su argumento nptr es una cadena de caracteres anchos. De lo contrario, estas tres funciones se comportan exactamente igual. Ambas funciones dejan de leer la cadena nptr en el primer carácter que no reconocen como parte de un número. Este puede ser el carácter nulo final o bien, o puede ser el primer carácter numérico mayor o igual que base.

El valor de la categoría LC_NUMERIC de la configuración regional determina el reconocimiento de caracteres de base en nptr; para obtener más información, vea setlocale, _wsetlocale. Las funciones que no tienen el sufijo _l usan la configuración regional actual; _strtoimax_l y _wcstoimax_l son idénticas a las funciones correspondientes que no tienen el sufijo _l salvo que usan en su lugar la configuración regional que se pasa. Para obtener más información, vea Configuración regional.

Si endptr no es NULL, un puntero al carácter que detuvo el análisis se almacena en la ubicación a la que se señala por 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 señala por endptr.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcstoimax

strtoimax

strtoimax

wcstoimax

_tcstoimax_l

strtoimax_l

_strtoimax_l

_wcstoimax_l

strtoimax espera que nptr señale a una cadena con el formato siguiente:

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

Un whitespace puede constar de caracteres de espacio y de tabulación, que se ignoran; digits son uno o varios dígitos decimales; letters son una o varias letras de la 'a' a la 'z' (o de la 'A' a la 'Z'). 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' o '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ían el análisis.

Rutina

Encabezado necesario

strtoimax , _strtoimax_l, wcstoimax, _wcstoimax_l

<inttypes.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft