WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen