WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::stoi — Text in int umwandeln

std::stoi aus <string> wandelt den Anfang eines Textes in int um. Die Zahlenbasis lässt sich angeben und die Position des Konversionsendes abrufen. Der gesamte String muss nicht verarbeitet werden; Fehler werden durch Ausnahmen gemeldet.

Version: 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, deklariert in <string>, gibt einen aus Text gelesenen Wert vom Typ int zurück. Es gibt Überladungen für std::string und std::wstring. Der Parameter base legt die Zahlenbasis fest und hat standardmäßig den Wert 10. Zulässig sind nur 0 (automatische Erkennung der Basis) und ganze Zahlen von 2 bis einschließlich 36. Andere Werte liegen außerhalb der Spezifikation der zugrunde liegenden Konversion. Stammt base aus einer nicht vertrauenswürdigen Quelle, prüfe den Wert vor dem Aufruf: Das Abfangen von std::invalid_argument und std::out_of_range ist keine portable Methode zur Prüfung der Basis.

Die Konversion kann vor dem Textende stoppen: "42px" ergibt 42 und keinen Fehler. Bei einem erfolgreichen Aufruf mit idx != nullptr speichert die Funktion in *idx den Index des ersten nicht konvertierten Elements. Der Standardwert nullptr lässt diese Information unberücksichtigt. Muss der gesamte String verarbeitet werden, prüfe nach erfolgreicher Konversion pos == text.size().

Ist keine Konversion möglich, wirft die Funktion std::invalid_argument. Ein Ergebnis außerhalb des int-Wertebereichs oder ein Bereichsfehler bei der zugrunde liegenden Konversion führt zu std::out_of_range. Behandle beide Ausnahmen beim Verarbeiten nicht vertrauenswürdiger Daten; betrachte idx nach einer Ausnahme nicht als Konversionsergebnis.

Das Beispiel gibt zuerst 42, dann den Index 2 und anschließend das verbleibende px aus. Es zeigt den Unterschied zwischen der erfolgreichen Konversion eines Anfangsteils und der Prüfung der gesamten Eingabe. Die Quelldokumentation ist ein laufender Arbeitsentwurf und keine eingefrorene C++23-Ausgabe; das Beispiel ist zur lokalen Prüfung im C++23-Modus gedacht, ohne eine Produktionslaufzeit zu bestätigen.

Beispiele

#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";
    }
}

Ergebnis

42
2
px

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen