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.