strtoul, _strtoul_l, wcstoul, _wcstoul_l

Artículo
02/19/2013

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.