Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti