Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

strtol — pretvorba besedila v long

strtol prebere celo število long z začetka besedila. Preverite endptr in errno, da zaznate napake in morebitni neobdelani preostanek.

Različica: 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> preskoči začetne presledke, sprejme neobvezen znak + ali - in pretvori števke v long.

base mora biti 0 ali med 2 in 36. Vrednost 0 prepozna decimalni, osmiški (0), šestnajstiški (0x) in v C23 tudi dvojiški zapis (0b). Izrecni osnovi 16 in 2 dovoljujeta ustrezni predponi. Zastavica prevajalnika C23 ne potrjuje podpore izvajalne knjižnice.

Če velja endptr != NULL, *endptr kaže na prvi neobdelani znak. Če do pretvorbe ne pride, se vrne 0 in velja *endptr == nptr; sama vrednost 0 ne pomeni napake.

Pred klicem nastavite errno = 0. Vrednost zunaj obsega vrne LONG_MIN ali LONG_MAX in nastavi ERANGE. Če velja endptr != NULL in mora biti obdelano celotno besedilo, preverite tudi **endptr == '\0': z zaključnim znakom niza primerjajte znak, na katerega kaže *endptr, ne kazalca samega. Pri območnih nastavitvah C končni beli znaki ostanejo neobdelani. Pri drugih območnih nastavitvah lahko funkcija sprejme tudi dodatne oblike zapisa, značilne za te nastavitve. Če je dosežen zaključni znak, je bil obdelan celoten niz, vendar to ne pomeni, da je vnos skladen s pravili zapisa za območne nastavitve C.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri