CKTIS / C
strtoul — pretvorba besedila v unsigned long
Pojasnjuje pretvorbo besedila v unsigned long in preverjanje rezultata. Primer prikazuje preverjanje obsega in zavrnitev neobdelane končnice.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdlib.h>
unsigned long int strtoul(const char *restrict nptr, char **restrict endptr, int base);strtoul pretvori začetek niza nptr v unsigned long. Začetne presledke prezre ter sprejme + ali -.
base: 2–36 ali 0 (samodejno zaznavanje: 0 — osmiško, 0x/0X — šestnajstiško, 0b/0B — dvojiško v C23, sicer desetiško). C23 sprejema dvojiško predpono tudi pri base == 2.
Če podaš &end, funkcija v end shrani naslov prvega neobdelanega znaka. Če podaš NULL, se ta naslov ne shrani. Če do pretvorbe ne pride, je rezultat 0 in velja end == nptr. Ob prekoračitvi obsega je rezultat ULONG_MAX in errno == ERANGE: najprej nastavi errno = 0. Za popolno pretvorbo mora veljati *end == '\0'.
Znak minus ni samodejno napaka: "-1" da ULONG_MAX. Če želiš prepovedati negativna števila, zavrni minus za začetnimi presledki. Zastavica prevajalnika za C23 ne potrjuje podpore C23 v izvajalni knjižnici.
Primeri
#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;
}
Rezultat
value=42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.