CKTIS / C
strtoull — Text zu unsigned long long
strtoull wandelt den Anfang eines Strings in unsigned long long um; mit endptr lassen sich eine fehlende Umwandlung und verbleibender Text erkennen.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
unsigned long long int strtoull(const char *restrict nptr, char **restrict endptr, int base);strtoull aus <stdlib.h> überspringt führende Leerzeichen und akzeptiert + oder -. base ist 2–36 oder 0 für die automatische Erkennung der Basis. C23 berücksichtigt die Präfixe 0b/0B; die Unterstützung durch die Laufzeitumgebung ist nicht bestätigt.
Wenn endptr nicht null ist, zeigt *endptr auf das erste nicht verarbeitete Zeichen. Ohne Umwandlung wird 0 zurückgegeben und es gilt *endptr == nptr. Setze errno vorher auf 0: Bei einem Überlauf wird ULLONG_MAX mit ERANGE zurückgegeben. Der Ergebniswert allein reicht nicht aus, um die Eingabe zu validieren.
Ein Minuszeichen wird nicht abgelehnt: "-1" ergibt ULLONG_MAX. Wenn negative Eingaben unzulässig sind, prüfe das Vorzeichen separat. Für eine vollständige Validierung muss außerdem das Ende des Strings geprüft werden.
Beispiele
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "12345";
char *end;
errno = 0;
unsigned long long value = strtoull(text, &end, 10);
if (end == text || errno == ERANGE || *end != '\0') {
puts("invalid");
return 1;
}
printf("%llu\n", value);
return 0;
}
Ergebnis
12345
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.