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

CKTIS / C

strtoull — texto para unsigned long long

strtoull converte o início de uma cadeia para unsigned long long; endptr permite detetar a ausência de conversão e a existência de texto restante.

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

Sintaxe

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

strtoull, de <stdlib.h>, ignora os espaços em branco iniciais e aceita + ou -. base pode ser de 2 a 36 ou 0, para deteção automática da base. C23 inclui os prefixos 0b/0B; o suporte pelo ambiente de execução não está confirmado.

Se endptr não for nulo, *endptr indica o primeiro caráter não consumido. Se não ocorrer uma conversão, é devolvido 0 e verifica-se *endptr == nptr. Defina errno como zero antes da chamada: em caso de overflow, é devolvido ULLONG_MAX com ERANGE. O resultado, por si só, não permite validar a entrada.

O sinal menos não é rejeitado: "-1" produz ULLONG_MAX. Se os valores negativos forem proibidos, verifique o sinal separadamente. Uma validação completa também exige verificar o fim da cadeia.

Exemplos

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

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

    if (end == text || errno == ERANGE || *end != '\0') {
        puts("invalid");
        return 1;
    }
    printf("%llu\n", value);
    return 0;
}

Resultado

12345

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