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.