CKTIS / C
strtoll — convertire testo in long long
strtoll legge un intero con segno all’inizio del testo e lo converte in long long. endptr ed errno consentono di controllare il risultato della conversione.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);strtoll ignora gli spazi bianchi iniziali e accetta un + o un - facoltativo. base deve essere 0 oppure un valore compreso tra 2 e 36. Con 0 viene rilevata la base: decimale, ottale (0), esadecimale (0x) o binaria (0b). C23 accetta anche 0b con base 2; il supporto negli ambienti di esecuzione di produzione non è attestato.
Se endptr è diverso da NULL, la funzione memorizza in *endptr l’indirizzo del primo carattere non convertito. Se non avviene alcuna conversione, la funzione restituisce 0 e, quando endptr è diverso da NULL, vale *endptr == nptr. Per un valore fuori intervallo, la funzione restituisce LLONG_MIN o LLONG_MAX e vale errno == ERANGE. Imposta errno = 0 prima della chiamata.
Un risultato pari a 0 da solo non indica un errore. Per rifiutare qualsiasi carattere dopo l’intero, passa un endptr diverso da NULL e verifica, nell’ordine, che la conversione sia avvenuta, che non ci siano errori di intervallo e che valga **endptr == '\0'. Quest’ultimo controllo esclude anche gli spazi bianchi finali rimasti non convertiti. C23 ammette i separatori di cifre (') nelle costanti intere del codice sorgente, ma strtoll applica regole di conversione distinte. Nelle impostazioni locali C, quando base è 0, queste regole escludono esplicitamente i suffissi e i separatori di cifre dalla forma delle costanti intere. Per le basi da 2 a 36, la sequenza di cifre non contiene separatori e non è previsto un suffisso distinto. Altre impostazioni locali possono ammettere forme aggiuntive ad esse specifiche, quindi non dare per scontato che i separatori usati per raggruppare le cifre vengano sempre rifiutati.
Esempi
#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;
}Risultato
-4200
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.