strtoumax, _strtoumax_l, wcstoumax, _wcstoumax_l

 

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

Convierte cadenas en un valor entero de tipo entero sin signo compatible más grande.

uintmax_t strtoumax(  
   const char *nptr,  
   char **endptr,  
   int base   
);  
uintmax_t _strtoumax_l(  
   const char *nptr,  
   char **endptr,  
   int base,  
   _locale_t locale  
);  
uintmax_t wcstoumax(  
   const wchar_t *nptr,  
   wchar_t **endptr,  
   int base   
);  
uintmax_t _wcstoumax_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 análisis.

base
Base numérica que se va a usar.

locale
Configuración regional que se va a usar.

strtoumax devuelve el valor convertido, si existe, o UINTMAX_MAX si se produce un desbordamiento. strtoumax devuelve 0 si no se puede realizar ninguna conversión. wcstoumax devuelve valores de manera parecida a strtoumax. Para ambas funciones, errno se establece en ERANGE si se produce un desbordamiento o subdesbordamiento.

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

Cada una de estas funciones convierte la cadena de entrada nptr a una uintmax_t valor entero.

strtoumax deja de leer la cadena nptr en el primer carácter que no reconoce como parte de un número. Puede tratarse del carácter nulo final, o puede ser el primer carácter numérico que es mayor o igual que base. El LC_NUMERIC valor de la categoría de la configuración regional determina el reconocimiento del carácter base en nptr. Para obtener más información, consulte setlocale, _wsetlocale. strtoumaxy wcstoumax usan la configuración regional actual. _strtoumax_l y _wcstoumax_l son idénticas salvo que usan la configuración regional que se pasa en su lugar. Para obtener más información, vea Locale.

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

La versión con caracteres anchos de strtoumax es wcstoumax; su nptr argumento es una cadena de caracteres anchos. De lo contrario, 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
_tcstoumaxstrtoumaxstrtoumaxwcstoumax
_tcstoumax_lstrtoumax_l_strtoumax_l_wcstoumax_l

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

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

Un whitespace puede constar de caracteres de espacio y tabulación, que se omiten; digits es uno o más dígitos decimales; letters son uno o más de las letras 'a' a 'z' (o '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 que apunta 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 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 que se analiza es '0', se supone un entero octal y dejaría el examen de un carácter '8' o '9'. strtoumaxpermite un signo más (+) o signo menos () prefijo; inicial signo indica que el valor devuelto es el complemento de dos del valor absoluto de la cadena convertida.

RutinaEncabezado necesario
strtoumax<stdlib.h>
wcstoumax<stdlib.h> o <wchar.h>
_strtoumax_l<stdlib.h>
_wcstoumax_l<stdlib.h> o <wchar.h>

Para obtener más información sobre compatibilidad, vea Compatibilidad.

Vea el ejemplo de strtod.

System::Convert::ToUInt64

Conversión de datos
Configuración regional
localeconv
setlocale, _wsetlocale
Cadena de funciones con valores numéricos
strtod, _strtod_l, wcstod, _wcstod_l
strtoimax, _strtoimax_l, wcstoimax, _wcstoimax_l
strtol, wcstol, _strtol_l, _wcstol_l
strtoul, _strtoul_l, wcstoul, _wcstoul_l
strtoll, _strtoll_l, wcstoll, _wcstoll_l
atof, _atof_l, _wtof, _wtof_l

Mostrar: