Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje