CKTIS / C++
std::stoi — tekst omzetten naar int
std::stoi uit <string> zet het begin van tekst om naar int. Je kunt de numerieke basis opgeven en de positie opvragen waar de conversie stopte. De hele tekenreeks hoeft niet te worden verwerkt; fouten worden gemeld met uitzonderingen.
Versie: 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, gedeclareerd in <string>, retourneert een int-waarde die uit tekst is gelezen. Er zijn overloads voor std::string en std::wstring. De parameter base bepaalt het talstelsel en heeft standaard de waarde 10. Alleen 0 (automatische detectie van het grondtal) en gehele getallen van 2 tot en met 36 zijn toegestaan. Andere waarden vallen buiten het geldige domein van de onderliggende conversie. Komt base uit een onbetrouwbare bron, controleer de waarde dan vóór de aanroep: je kunt er niet bij elke implementatie op vertrouwen dat het afvangen van std::invalid_argument en std::out_of_range een ongeldig grondtal detecteert.
De conversie kan stoppen voordat de tekst is afgelopen: "42px" levert 42 op, geen fout. Na een geslaagde aanroep met idx != nullptr slaat de functie in *idx de index van het eerste niet-omgezette element op. De standaardwaarde nullptr laat deze informatie achterwege. Als de hele tekenreeks moet worden verwerkt, controleer dan na een geslaagde conversie pos == text.size().
Als conversie niet mogelijk is, werpt de functie std::invalid_argument. Een resultaat buiten het bereik van int, of een bereikfout bij de onderliggende conversie, veroorzaakt std::out_of_range. Verwerk beide uitzonderingen bij het verwerken van niet-vertrouwde gegevens; beschouw idx na een uitzondering niet als een conversieresultaat.
Het voorbeeld drukt eerst 42 af, daarna index 2 en vervolgens de resterende px. Het laat het verschil zien tussen een beginstuk succesvol omzetten en de volledige invoer valideren. De brondocumentatie is een actuele werkversie, geen vastgezette C++23-editie; het voorbeeld is bedoeld voor lokale controle in C++23-modus, zonder een productieomgeving te garanderen.
Voorbeelden
#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";
}
}
Resultaat
42 2 px
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.