Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::stoi — pretvorba teksta u int

std::stoi iz <string> pretvara početni dio teksta u int. Omogućuje zadavanje brojčane baze i dohvaćanje položaja na kojem je pretvorba stala. Nije potrebno obraditi cijeli niz, a pogreške se prijavljuju iznimkama.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <string>

/* Overload synopsis (declarations provided by <string>):
namespace std {
    int stoi(const string& str, size_t* idx = nullptr, int base = 10);
    int stoi(const wstring& str, size_t* idx = nullptr, int base = 10);
}
*/

std::stoi, deklarirana u <string>, vraća vrijednost tipa int pročitanu iz teksta. Dostupna su preopterećenja za std::string i std::wstring. Parametar base određuje brojčanu bazu, a zadana mu je vrijednost 10. Dopuštene su samo vrijednost 0 (automatsko prepoznavanje baze) i cijeli brojevi od 2 do 36 uključivo. Ostale vrijednosti nisu u domeni koju dopušta osnovna pretvorba. Ako base dolazi iz nepouzdanog izvora, provjerite njegovu vrijednost prije poziva: hvatanje iznimaka std::invalid_argument i std::out_of_range nije prenosiv način provjere baze.

Pretvorba može stati prije kraja teksta: "42px" daje 42, a ne pogrešku. Nakon uspješnog poziva s idx != nullptr, funkcija u *idx sprema indeks prvog nepretvorenog elementa. Zadana vrijednost nullptr izostavlja tu informaciju. Ako je potrebno obraditi cijeli niz, nakon uspješne pretvorbe provjerite pos == text.size().

Ako pretvorba nije moguća, funkcija izbacuje std::invalid_argument. Rezultat izvan raspona tipa int ili pogreška raspona u osnovnoj pretvorbi uzrokuje std::out_of_range. Pri obradi nepouzdanih podataka obradite obje iznimke; nakon iznimke nemojte smatrati idx rezultatom pretvorbe.

Primjer ispisuje 42, zatim indeks 2 i naposljetku preostali px. Pokazuje razliku između uspješne pretvorbe početnog dijela i provjere cijelog ulaza. Izvorna dokumentacija živi je radni nacrt, a ne zamrznuto izdanje C++23; primjer je namijenjen lokalnoj provjeri u načinu C++23, bez potvrde produkcijskog okruženja.

Primjeri

#include <cstddef>
#include <iostream>
#include <stdexcept>
#include <string>

int main() {
    const std::string text = "42px";
    std::size_t pos = 0;

    try {
        const int value = std::stoi(text, &pos, 10);
        std::cout << value << '\n';
        std::cout << pos << '\n';
        std::cout << text.substr(pos) << '\n';
    } catch (const std::invalid_argument&) {
        std::cout << "invalid_argument\n";
    } catch (const std::out_of_range&) {
        std::cout << "out_of_range\n";
    }
}

Rezultat

42
2
px

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

Izvori