CKTIS / C
strtoll — converter texto para long long
strtoll lê um número inteiro com sinal no início do texto e converte-o para long long. endptr e errno permitem verificar o resultado da conversão.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);strtoll ignora os espaços em branco iniciais e aceita um + ou - opcional. base tem de ser 0 ou estar entre 2 e 36. Com 0, a base é detetada: decimal, octal (0), hexadecimal (0x) ou binária (0b). C23 também aceita 0b com base 2; o suporte em ambientes de execução de produção não está confirmado.
Se endptr for diferente de NULL, a função guarda em *endptr o endereço do primeiro caráter não convertido. Se não ocorrer nenhuma conversão, a função devolve 0 e, quando endptr é diferente de NULL, verifica-se *endptr == nptr. Um valor fora do intervalo produz LLONG_MIN ou LLONG_MAX e errno == ERANGE. Define errno = 0 antes da chamada.
Um resultado igual a 0, por si só, não indica uma falha. Para rejeitar qualquer caráter depois do número inteiro, passa um endptr diferente de NULL e verifica, por esta ordem, se a conversão ocorreu, se não houve um erro de intervalo e se **endptr == '\0'. Esta última verificação também rejeita os espaços em branco finais que não tenham sido convertidos. C23 permite separadores de algarismos (') nas constantes inteiras do código-fonte, mas strtoll aplica regras de conversão distintas. Na configuração regional C, quando base é 0, essas regras excluem explicitamente os sufixos e os separadores de algarismos da forma das constantes inteiras. Para bases de 2 a 36, a sequência de algarismos não inclui separadores e não está previsto um sufixo separado. Outras configurações regionais podem aceitar formas adicionais que lhes são próprias, pelo que não deves presumir que os separadores de grupos de algarismos são sempre rejeitados.
Exemplos
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "-4200";
char *end;
errno = 0;
long long value = strtoll(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("%lld\n", value);
return EXIT_SUCCESS;
}Resultado
-4200
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.