Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::stoi — konwersja tekstu na int

std::stoi z nagłówka <string> przekształca początkowy fragment tekstu na int. Pozwala wskazać podstawę systemu liczbowego i odczytać pozycję końca konwersji. Nie wymaga zużycia całego tekstu i zgłasza wyjątki przy błędach.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#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, zadeklarowane w <string>, zwraca wartość typu int odczytaną z tekstu. Dostępne są przeciążenia dla std::string oraz std::wstring. Parametr base określa podstawę systemu liczbowego; domyślnie wynosi 10. Dozwolone wartości to 0 (automatyczne wykrywanie podstawy) oraz liczby całkowite od 2 do 36 włącznie. Inne wartości wykraczają poza kontrakt konwersji bazowej. Jeśli base pochodzi z niezaufanego źródła, sprawdź jego wartość przed wywołaniem: przechwytywanie std::invalid_argument i std::out_of_range nie jest przenośnym sposobem sprawdzania podstawy.

Konwersja może zakończyć się przed końcem tekstu: "42px" daje 42, a nie błąd. Po udanym wywołaniu z idx != nullptr funkcja zapisuje w *idx indeks pierwszego nieprzetworzonego elementu. Domyślne nullptr oznacza pominięcie tej informacji. Jeśli wymagane jest zużycie całego tekstu, sprawdź pos == text.size() po udanej konwersji.

Brak możliwej konwersji powoduje std::invalid_argument. Wynik poza zakresem int lub błąd zakresu konwersji bazowej powoduje std::out_of_range. Obsługuj oba wyjątki przy przetwarzaniu niezaufanych danych; po wyjątku nie traktuj idx jako wyniku konwersji.

Przykład wypisuje 42, potem indeks 2, a następnie pozostałe px. Pokazuje różnicę między poprawną konwersją początkowego fragmentu a sprawdzeniem całego wejścia. Dokumentacja źródłowa jest bieżącym szkicem standardu, nie zamrożonym wydaniem C++23; przykład jest przeznaczony do lokalnego sprawdzenia w trybie C++23, bez potwierdzenia środowiska produkcyjnego.

Przykłady

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

Wynik

42
2
px

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła