CKTIS / C++
std::stoi — převod textu na int
std::stoi z <string> převádí počáteční část textu na int. Umožňuje určit číselnou soustavu a získat pozici, na které se převod zastavil. Není nutné zpracovat celý řetězec; chyby se oznamují výjimkami.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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, deklarovaná v <string>, vrací hodnotu typu int načtenou z textu. Existují přetížení pro std::string a std::wstring. Parametr base určuje číselnou soustavu a výchozí hodnota je 10. Přípustné hodnoty jsou pouze 0 (automatické rozpoznání základu) a celá čísla od 2 do 36 včetně. Jiné hodnoty jsou mimo obor povolený podkladovým převodem. Pokud base pochází z nedůvěryhodného zdroje, ověřte jeho hodnotu před voláním: zachycení výjimek std::invalid_argument a std::out_of_range není přenositelný způsob ověření základu.
Převod může skončit před koncem textu: "42px" vrátí 42, nikoli chybu. Po úspěšném volání s idx != nullptr funkce uloží do *idx index prvního nepřevedeného prvku. Výchozí hodnota nullptr tuto informaci vynechá. Pokud je třeba zpracovat celý řetězec, po úspěšném převodu ověřte pos == text.size().
Pokud není možný žádný převod, funkce vyhodí std::invalid_argument. Výsledek mimo rozsah typu int nebo chyba rozsahu při podkladovém převodu způsobí std::out_of_range. Při zpracování nedůvěryhodných dat ošetřete obě výjimky; po výjimce nepovažujte idx za výsledek převodu.
Příklad vypíše 42, potom index 2 a nakonec zbývající px. Ukazuje rozdíl mezi úspěšným převodem počáteční části a ověřením celého vstupu. Zdrojová dokumentace je průběžně aktualizovaný pracovní návrh, nikoli neměnné vydání C++23; příklad je určen k místnímu ověření v režimu C++23, aniž by potvrzoval produkční prostředí.
Příklady
#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";
}
}
Výsledek
42 2 px
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.