CKTIS / C++
std::stoi — prevod textu na int
std::stoi z <string> prevádza počiatočnú časť textu na int. Umožňuje určiť číselnú sústavu a získať pozíciu, na ktorej sa prevod zastavil. Nie je potrebné spracovať celý reťazec; chyby oznamuje pomocou výnimiek.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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>, vracia hodnotu typu int načítanú z textu. Existujú preťaženia pre std::string a std::wstring. Parameter base určuje číselnú sústavu a predvolená hodnota je 10. Povolené sú len hodnoty 0 (automatické rozpoznanie základu) a celé čísla od 2 do 36 vrátane. Ostatné hodnoty sú mimo oboru povoleného podkladovým prevodom. Ak base pochádza z nedôveryhodného zdroja, skontrolujte jeho hodnotu pred volaním: zachytávanie výnimiek std::invalid_argument a std::out_of_range nie je prenosný spôsob overenia základu.
Prevod sa môže skončiť pred koncom textu: "42px" vráti 42, nie chybu. Po úspešnom volaní s idx != nullptr funkcia uloží do *idx index prvého neprevedeného prvku. Predvolená hodnota nullptr túto informáciu vynechá. Ak treba spracovať celý reťazec, po úspešnom prevode skontrolujte pos == text.size().
Ak nie je možný žiadny prevod, funkcia vyhodí std::invalid_argument. Výsledok mimo rozsahu typu int alebo chyba rozsahu pri podkladovom prevode spôsobí std::out_of_range. Pri spracovaní nedôveryhodných údajov ošetrite obe výnimky; po výnimke nepovažujte idx za výsledok prevodu.
Príklad vypíše 42, potom index 2 a napokon zostávajúce px. Ukazuje rozdiel medzi úspešným prevodom počiatočnej časti a overením celého vstupu. Zdrojová dokumentácia je priebežne aktualizovaný pracovný návrh, nie nemenné vydanie C++23; príklad je určený na miestne overenie v režime C++23 bez potvrdenia produkčného prostredia.
Prí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ýsledok
42 2 px
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.