strtoul, _strtoul_l, wcstoul, _wcstoul_l

Cadenas de convertir un valor sin signo de largo-entero.

unsigned long strtoul(
   const char *nptr,
   char **endptr,
   int base 
);
unsigned long _strtoul_l(
   const char *nptr,
   char **endptr,
   int base,
   _locale_t locale
);
unsigned long wcstoul(
   const wchar_t *nptr,
   wchar_t **endptr,
   int base 
);
unsigned long _wcstoul_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
    configuración regional a utilizar.

Valor devuelto

strtoul devuelve el valor convertido, si existe, o ULONG_MAX de desbordamiento.strtoul devuelve 0 si ninguna conversión puede realizar.wcstoul devuelve valores análogo a strtoul.Para ambas funciones, errno se establece en ERANGE si el desbordamiento o subdesbordamiento aparece.

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

Comentarios

Cada una de estas funciones convierte la cadena de entrada nptr a  unsignedlong.

strtoul finaliza la lectura de la cadena nptr en el primer carácter que no puede reconocer 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.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.strtoul ywcstoul utilizan la configuración regional actual; _strtoul_l y_wcstoul_l son idénticos 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.

wcstoul es una versión con caracteres anchos de strtoul; el argumento de nptr es una cadena de caracteres.Si no estas funciones se comportan exactamente igual.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H

_UNICODE y _MBCS no definido

_MBCS definido

_UNICODE definido

_tcstoul

strtoul

strtoul

wcstoul

_tcstoul_l

strtoul_l

_strtoul_l

_wcstoul_l

strtoul 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.strtoul permite que varios (+) o menos prefijo de signo (de–); un signo menos principal indica que el valor devuelto se negado.

Requisitos

rutina

Encabezado necesario

strtoul

<stdlib.h>

wcstoul

<stdlib.h> o <wchar.h>

_strtoul_l

<stdlib.h>

_wcstoul_l

<stdlib.h> o <wchar.h>

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

Ejemplo

Vea el ejemplo para strtod.

Equivalente en .NET Framework

System:: Convierte:: ToUInt64

Vea también

Referencia

Conversión de datos

Configuración regional

localeconv

setlocale, _wsetlocale

Cadena a las funciones de valor numérico

strtod, _strtod_l, wcstod, _wcstod_l

strtol, wcstol, _strtol_l, _wcstol_l

atof, _atof_l, _wtof, _wtof_l