Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

strtoll — pretvorba teksta u long long

strtoll na početku teksta čita cijeli broj s neobveznim predznakom i pretvara ga u long long. Rezultat možete provjeriti pomoću endptr i errno.

Verzija: C23; repository compiler flag, production runtime not attested

Sintaksa

#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);

strtoll preskače početne bjeline i prihvaća neobvezni + ili -. base mora biti 0 ili u rasponu od 2 do 36. Ako je vrijednost 0, funkcija prepoznaje bazu: decimalnu, oktalnu (0), heksadekadsku (0x) ili binarnu (0b). C23 prihvaća i 0b uz bazu 2; podrška u produkcijskim okruženjima izvođenja nije potvrđena.

Ako endptr nije NULL, funkcija u *endptr sprema adresu prvog nepretvorenog znaka. Ako ne dođe do pretvorbe, funkcija vraća 0, a ako endptr nije NULL, vrijedi *endptr == nptr. Za vrijednost izvan raspona funkcija vraća LLONG_MIN ili LLONG_MAX i vrijedi errno == ERANGE. Prije poziva postavite errno = 0.

Sam rezultat 0 ne znači da je došlo do pogreške. Da biste odbacili sve znakove iza cijelog broja, proslijedite endptr različit od NULL i redom provjerite je li došlo do pretvorbe, je li pretvorba prošla bez pogreške zbog vrijednosti izvan raspona (errno != ERANGE) i vrijedi li **endptr == '\0'. Posljednja provjera odbacuje i završne bjeline koje su ostale nepretvorene. C23 dopušta razdjelnike znamenki (') u cjelobrojnim konstantama u izvornom kôdu, ali strtoll primjenjuje zasebna pravila pretvorbe. Uz lokalne postavke C, kad je base jednak 0, ta pravila izričito isključuju sufikse i razdjelnike znamenki iz zapisa u obliku cjelobrojne konstante. Za baze od 2 do 36 niz znamenki ne sadržava razdjelnike, a zapis ne predviđa zaseban sufiks. Uz druge lokalne postavke mogu se prihvatiti dodatni oblici svojstveni tim postavkama, pa ne treba pretpostaviti da će se razdjelnici skupina znamenki uvijek odbaciti.

Primjeri

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "-4200";
    char *end;
    errno = 0;
    long long value = strtoll(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("%lld\n", value);
    return EXIT_SUCCESS;
}

Rezultat

-4200

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori