CKTIS / C
strtoul — convertire il testo in unsigned long
Spiega come convertire il testo in unsigned long e controllare il risultato. L’esempio mostra il controllo dell’intervallo e il rifiuto di un suffisso non consumato.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <stdlib.h>
unsigned long int strtoul(const char *restrict nptr, char **restrict endptr, int base);strtoul converte l’inizio della stringa nptr in unsigned long. Ignora gli spazi iniziali e accetta + o -.
base: 2–36 oppure 0 (rilevamento automatico: 0 — ottale, 0x/0X — esadecimale, 0b/0B — binario in C23, altrimenti decimale). C23 accetta il prefisso binario anche quando base == 2.
Se si passa &end, la funzione salva in end l’indirizzo del primo carattere non consumato. Se si passa NULL, l’indirizzo non viene salvato. Se non avviene alcuna conversione, il risultato è 0 e end == nptr. Un overflow produce ULONG_MAX e errno == ERANGE: imposta prima errno = 0. Per una conversione completa è necessario *end == '\0'.
Il segno meno non è automaticamente un errore: "-1" produce ULONG_MAX. Per vietare i numeri negativi, rifiuta il segno meno dopo gli spazi iniziali. Un’opzione del compilatore C23 non attesta il supporto C23 della libreria di runtime.
Esempi
#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;
}
Risultato
value=42
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.