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

CKTIS / C

strtol — convertir texto a long

strtol lee un entero long desde el principio de un texto. Comprueba endptr y errno para detectar errores y cualquier sufijo sin consumir.

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

Sintaxis

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

strtol, de <stdlib.h>, omite los espacios en blanco iniciales, acepta un signo + o - opcional y convierte los dígitos a long.

base debe ser 0 o estar entre 2 y 36. El valor 0 detecta las notaciones decimal, octal (0), hexadecimal (0x) y, en C23, binaria (0b). Las bases explícitas 16 y 2 permiten sus prefijos correspondientes. Una opción del compilador C23 no acredita que la biblioteca de ejecución ofrezca compatibilidad.

Si endptr != NULL, *endptr apunta al primer carácter no consumido. Si no se realiza ninguna conversión, devuelve 0 y *endptr == nptr; el valor 0 por sí solo no indica un error.

Antes de llamar a la función, asigna errno = 0. Un valor fuera de rango devuelve LONG_MIN o LONG_MAX y establece ERANGE. Si endptr != NULL y se requiere consumir todo el texto, comprueba también **endptr == '\0': compara el carácter al que apunta *endptr con el terminador de la cadena, no el puntero en sí. Con la configuración regional C, los espacios en blanco finales quedan sin consumir. Con otras configuraciones regionales, la función puede aceptar formatos de entrada adicionales propios de cada configuración. Llegar al terminador confirma que se ha consumido toda la cadena, no que la entrada se ajuste a la sintaxis de la configuración regional C.

Ejemplos

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

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

    if (end == text) {
        puts("no digits");
        return EXIT_FAILURE;
    }
    if (errno == ERANGE) {
        puts("out of range");
        return EXIT_FAILURE;
    }
    if (*end != '\0') {
        puts("trailing characters");
        return EXIT_FAILURE;
    }
    printf("value=%ld\n", value);
    return EXIT_SUCCESS;
}

Resultado

value=123

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