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

CKTIS / C

strtoul — converter texto para unsigned long

Explica como converter texto para unsigned long e verificar o resultado. O exemplo demonstra a verificação do intervalo e a rejeição de um sufixo não consumido.

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

Sintaxe

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

strtoul converte o início da cadeia nptr para unsigned long. Ignora os espaços em branco iniciais e aceita + ou -.

base: 2–36 ou 0 (deteção automática: 0 — octal, 0x/0X — hexadecimal, 0b/0B — binário em C23; decimal nos restantes casos). C23 também aceita o prefixo binário quando base == 2.

Se passares &end, a função guarda em end o endereço do primeiro carácter não consumido. Se passares NULL, esse endereço não é guardado. Se não ocorrer conversão, o resultado é 0 e end == nptr. Se o valor exceder o limite do tipo, a função devolve ULONG_MAX e verifica-se errno == ERANGE. Para detetar este erro, define errno = 0 antes da chamada. Uma conversão completa exige *end == '\0'.

O sinal de menos não é automaticamente um erro: "-1" produz ULONG_MAX. Para proibir números negativos, rejeita o sinal de menos após os espaços em branco iniciais. Uma opção do compilador C23 não atesta o suporte de C23 pela biblioteca de execução.

Exemplos

#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

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