CKTIS / C
strtoul — Text in unsigned long umwandeln
Erklärt, wie Text in unsigned long umgewandelt und das Ergebnis geprüft wird. Das Beispiel zeigt die Bereichsprüfung und weist nicht verarbeitete Zeichen am Ende zurück.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
unsigned long int strtoul(const char *restrict nptr, char **restrict endptr, int base);strtoul wandelt den Anfang der Zeichenkette nptr in unsigned long um. Führende Leerzeichen werden übersprungen; ein + oder - wird akzeptiert.
base: 2–36 oder 0 (automatische Erkennung: 0 — oktal, 0x/0X — hexadezimal, 0b/0B — binär in C23, sonst dezimal). C23 akzeptiert das Binärpräfix auch bei base == 2.
Wird &end übergeben, speichert die Funktion die Adresse des ersten nicht verarbeiteten Zeichens in end. Bei NULL wird diese Adresse nicht gespeichert. Erfolgt keine Umwandlung, ist das Ergebnis 0 und end == nptr. Bei Überlauf gibt die Funktion ULONG_MAX zurück und es gilt errno == ERANGE: Setze errno vorher auf 0. Für eine vollständige Umwandlung muss *end == '\0' gelten.
Ein Minuszeichen ist nicht automatisch ein Fehler: "-1" ergibt ULONG_MAX. Wenn negative Zahlen verboten sein sollen, weise ein Minuszeichen nach den führenden Leerzeichen zurück. Ein C23-Compiler-Flag bestätigt nicht, dass die Laufzeitbibliothek C23 unterstützt.
Beispiele
#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;
}
Ergebnis
value=42
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.