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.