Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori