CKTIS / C
strtol — pretvorba teksta u long
strtol čita cijeli broj tipa long s početka teksta. Provjerite endptr i errno kako biste otkrili pogreške i eventualni neobrađeni ostatak.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdlib.h>
long int strtol(const char *restrict nptr, char **restrict endptr, int base);strtol iz <stdlib.h> preskače početne bjeline, prihvaća neobvezni znak + ili - i pretvara znamenke u long.
base mora biti 0 ili u rasponu 2–36. Vrijednost 0 prepoznaje decimalni, oktalni (0), heksadekadski (0x) i, u C23, binarni zapis (0b). Izričito zadane baze 16 i 2 dopuštaju odgovarajuće prefikse. Zastavica prevoditelja C23 ne potvrđuje podršku izvršne biblioteke.
Ako je endptr != NULL, *endptr pokazuje na prvi neobrađeni znak. Ako se ne dogodi pretvorba, vraća se 0 i vrijedi *endptr == nptr; sama vrijednost 0 ne označava pogrešku.
Prije poziva postavite errno = 0. Vrijednost izvan raspona vraća LONG_MIN ili LONG_MAX i postavlja ERANGE. Ako vrijedi endptr != NULL i potrebno je obraditi cijeli tekst, provjerite i **endptr == '\0': sa završnim znakom niza usporedite znak na koji pokazuje *endptr, a ne sam pokazivač. Uz regionalne postavke C završne bjeline ostaju neobrađene. Uz druge regionalne postavke funkcija može prihvatiti dodatne oblike zapisa specifične za te postavke. Dolazak do završnog znaka potvrđuje da je obrađen cijeli niz, ali ne i da je unos u skladu s pravilima zapisa za regionalne postavke C.
Primjeri
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "123";
char *end;
errno = 0;
long value = strtol(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("value=%ld\n", value);
return EXIT_SUCCESS;
}Rezultat
value=123
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.