Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

strtoul — convertir texto a unsigned long

Explica cómo convertir texto a unsigned long y comprobar el resultado. El ejemplo muestra la comprobación del rango y el rechazo de un sufijo no consumido.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <stdlib.h>
unsigned long int strtoul(const char *restrict nptr, char **restrict endptr, int base);

strtoul convierte el comienzo de la cadena nptr a unsigned long. Omite los espacios en blanco iniciales y acepta + o -.

base: 2–36 o 0 (detección automática: 0 — octal, 0x/0X — hexadecimal, 0b/0B — binario en C23; decimal en los demás casos). C23 también acepta el prefijo binario cuando base == 2.

Al pasar &end, la función guarda en end la dirección del primer carácter no consumido. Si se pasa NULL, no se guarda esa dirección. Si no hay conversión, el resultado es 0 y end == nptr. Un desbordamiento produce ULONG_MAX y errno == ERANGE: establece primero errno = 0. Para que la conversión sea completa, se requiere *end == '\0'.

El signo menos no es automáticamente un error: "-1" produce ULONG_MAX. Para prohibir los números negativos, rechaza el signo menos después de los espacios en blanco iniciales. Una opción del compilador para C23 no acredita que la biblioteca de ejecución admita C23.

Ejemplos

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "42";
    char *end;
    errno = 0;
    unsigned long value = strtoul(text, &end, 10);

    if (end == text || errno == ERANGE || *end != '\0') {
        puts("invalid");
        return EXIT_FAILURE;
    }

    printf("value=%lu\n", value);
    return EXIT_SUCCESS;
}

Resultado

value=42

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes