strtoul, strtoull

Interpreta un valor entero sin signo en una cadena de bytes apuntada por str .

Descarta cualquier carácter de espacio en blanco (identificado llamando a isspace ) hasta encontrar el primer carácter que no sea un espacio en blanco, luego toma tantos caracteres como sea posible para formar una representación válida de número entero sin signo en base-n (donde n= base ) y los convierte a un valor entero. El valor entero sin signo válido consta de las siguientes partes:

• (opcional) signo más o menos
• (opcional) prefijo ( 0 ) que indica base octal (solo aplica cuando la base es 8 o ​ 0 ​ )
• (opcional) prefijo ( 0x o 0X ) que indica base hexadecimal (solo aplica cuando la base es 16 o ​ 0 ​ )
• una secuencia de dígitos

El conjunto de valores válidos para base es {0, 2, 3, ..., 36} . El conjunto de dígitos válidos para enteros de base- 2 es {0, 1} , para enteros de base- 3 es {0, 1, 2} , y así sucesivamente. Para bases mayores que 10 , los dígitos válidos incluyen caracteres alfabéticos, comenzando desde Aa para enteros de base- 11 , hasta Zz para enteros de base- 36 . Se ignora la capitalización de los caracteres.

Se pueden aceptar formatos numéricos adicionales según la configuración regional de C actualmente instalada locale .

Si el valor de base es ​ 0 ​ , la base numérica se detecta automáticamente: si el prefijo es 0 , la base es octal, si el prefijo es 0x o 0X , la base es hexadecimal, de lo contrario la base es decimal.

Si el signo menos formaba parte de la secuencia de entrada, el valor numérico calculado a partir de la secuencia de dígitos se niega como si fuera mediante unary minus en el tipo de resultado, lo cual aplica las reglas de wraparound de enteros sin signo.

Las funciones establecen el puntero apuntado por str_end para que apunte al carácter posterior al último carácter interpretado. Si str_end es un puntero nulo, se ignora.

Parámetros

Valor de retorno

Valor entero correspondiente al contenido de str en caso de éxito. Si el valor convertido queda fuera del rango del tipo de retorno correspondiente, ocurre un error de rango ( errno se establece a ERANGE ) y se retorna ULONG_MAX o ULLONG_MAX . Si no se puede realizar ninguna conversión, se retorna ​ 0 ​ .

Ejemplo

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    const char* p = "10 200000000000000000000000000000 30 -40 - 42";
    printf("Parsing '%s':\n", p);
    char* end = NULL;
    for (unsigned long i = strtoul(p, &end, 10);
         p != end;
         i = strtoul(p, &end, 10))
    {
        printf("'%.*s' -> ", (int)(end - p), p);
        p = end;
        if (errno == ERANGE)
        {
            errno = 0;
            printf("range error, got ");
        }
        printf("%lu\n", i);
    }
    printf("After the loop p points to '%s'\n", p);
}

Parsing '10 200000000000000000000000000000 30 -40 - 42':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 18446744073709551615
' 30' -> 30
' -40' -> 18446744073709551576
After the loop p points to ' - 42'

Referencias

Véase también