CKTIS / C
strtoll — Text in long long umwandeln
strtoll liest am Anfang des Textes eine Ganzzahl mit optionalem Vorzeichen als long long ein. Mit endptr und errno lässt sich das Ergebnis überprüfen.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);strtoll überspringt vorangestellte Leerraumzeichen und akzeptiert ein optionales + oder -. base muss 0 oder eine Zahl von 2 bis 36 sein. Bei 0 wird die Basis erkannt: dezimal, oktal (0), hexadezimal (0x) oder binär (0b). C23 akzeptiert außerdem 0b bei Basis 2; die Unterstützung in produktiven Laufzeitumgebungen ist nicht bestätigt.
Wenn endptr nicht NULL ist, speichert die Funktion die Adresse des ersten nicht umgewandelten Zeichens in *endptr. Findet keine Umwandlung statt, liefert die Funktion 0, und bei einem von NULL verschiedenen endptr gilt *endptr == nptr. Bei einem Wert außerhalb des darstellbaren Bereichs liefert die Funktion LLONG_MIN oder LLONG_MAX, und es gilt errno == ERANGE. Setze vor dem Aufruf errno = 0.
Ein Ergebnis von 0 allein bedeutet keinen Fehler. Um alle Zeichen nach der Ganzzahl abzulehnen, übergib für endptr einen von NULL verschiedenen Zeiger. Prüfe der Reihe nach, ob eine Umwandlung stattgefunden hat, ob kein Bereichsfehler vorliegt und ob **endptr == '\0' gilt. Die letzte Prüfung schließt auch nachfolgende Leerraumzeichen aus, die nicht umgewandelt wurden. C23 erlaubt Zifferntrennzeichen (') in Ganzzahlkonstanten im Quellcode, aber für strtoll gelten eigene Umwandlungsregeln. In der Locale C schließen diese Regeln bei base gleich 0 Suffixe und Zifferntrennzeichen in der Schreibweise als Ganzzahlkonstante ausdrücklich aus. Bei Basen von 2 bis 36 enthält die Ziffernfolge keine Trennzeichen, und ein separates Suffix ist nicht vorgesehen. In anderen Locales können zusätzliche locale-spezifische Formen akzeptiert werden. Verlass dich daher nicht darauf, dass Trennzeichen zur Zifferngruppierung immer abgelehnt werden.
Beispiele
#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;
}Ergebnis
-4200
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.