Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje