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.