KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen