Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

strtol — converter texto para long

strtol lê um inteiro long a partir do início de um texto. Verifique endptr e errno para detetar erros e qualquer sufixo não consumido.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

strtol, declarada em <stdlib.h>, ignora os espaços em branco iniciais, aceita um sinal + ou - opcional e converte os algarismos para long.

base tem de ser 0 ou estar entre 2 e 36. O valor 0 deteta as notações decimal, octal (0), hexadecimal (0x) e, em C23, binária (0b). As bases explícitas 16 e 2 permitem os respetivos prefixos. Uma opção do compilador C23 não comprova o suporte da biblioteca de execução.

Se endptr != NULL, *endptr aponta para o primeiro carácter não consumido. Se não houver conversão, é devolvido 0 e *endptr == nptr; o valor 0, por si só, não indica um erro.

Antes de chamar a função, defina errno = 0. Um valor fora do intervalo devolve LONG_MIN ou LONG_MAX e define ERANGE. Se endptr != NULL e for necessário consumir todo o texto, verifique também **endptr == '\0': compare o carácter para o qual *endptr aponta com o terminador da cadeia, não o próprio ponteiro. Com a configuração regional C, os espaços em branco finais ficam por consumir. Com outras configurações regionais, a função pode aceitar formatos de entrada adicionais específicos da configuração em uso. Chegar ao terminador confirma que toda a cadeia foi consumida, mas não que a entrada respeita a sintaxe da configuração regional C.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes