Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::stoi — pretvorba besedila v int

std::stoi iz <string> pretvori začetni del besedila v int. Omogoča določitev številskega sistema in pridobitev položaja, kjer se je pretvorba ustavila. Ni treba porabiti celotnega niza; napake sporoča z izjemami.

Različica: 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 v <string>, vrne vrednost tipa int, prebrano iz besedila. Na voljo so preobremenitve za std::string in std::wstring. Parameter base določa številski sistem, privzeta vrednost pa je 10. Dovoljeni so le 0 (samodejno zaznavanje osnove) in cela števila od 2 do vključno 36. Druge vrednosti so zunaj območja, ki ga dopušča osnovna pretvorba. Če base prihaja iz nezaupanja vrednega vira, preverite njegovo vrednost pred klicem: prestrezanje izjem std::invalid_argument in std::out_of_range ni prenosljiv način preverjanja osnove.

Pretvorba se lahko konča pred koncem besedila: "42px" vrne 42, ne napake. Po uspešnem klicu z idx != nullptr funkcija v *idx shrani indeks prvega nepretvorjenega elementa. Privzeta vrednost nullptr to informacijo izpusti. Če je treba porabiti celoten niz, po uspešni pretvorbi preverite pos == text.size().

Če pretvorba ni mogoča, funkcija sproži std::invalid_argument. Rezultat zunaj območja tipa int ali napaka obsega pri osnovni pretvorbi povzroči std::out_of_range. Pri obdelavi nezaupanja vrednih podatkov obravnavajte obe izjemi; po izjemi vrednosti idx ne obravnavajte kot rezultat pretvorbe.

Primer izpiše 42, nato indeks 2 in nazadnje preostali px. Prikazuje razliko med uspešno pretvorbo začetnega dela in preverjanjem celotnega vnosa. Izvorna dokumentacija je sproti posodabljan delovni osnutek, ne nespremenjena izdaja C++23; primer je namenjen lokalnemu preverjanju v načinu C++23, ne da bi potrjeval produkcijsko okolje.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri