CKTIS / C++
std::stoi — convertire testo in int
std::stoi di <string> converte la parte iniziale di un testo in int. Consente di specificare la base numerica e di ottenere la posizione in cui si è fermata la conversione. Non è necessario consumare l’intera stringa e gli errori vengono segnalati con eccezioni.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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, dichiarata in <string>, restituisce un valore int letto da un testo. Sono disponibili overload che accettano std::string e std::wstring. Il parametro base specifica la base numerica e, per impostazione predefinita, vale 10. Gli unici valori ammessi sono 0 (rilevamento automatico della base) e gli interi da 2 a 36 inclusi. Gli altri valori non rientrano nel dominio previsto dalla conversione sottostante. Se base proviene da una fonte non attendibile, verificane il valore prima della chiamata: intercettare std::invalid_argument e std::out_of_range non è un modo portabile per convalidare la base.
La conversione può fermarsi prima della fine del testo: "42px" produce 42, non un errore. Dopo una chiamata riuscita con idx != nullptr, la funzione memorizza in *idx l’indice del primo elemento non convertito. Il valore predefinito nullptr ignora questa informazione. Se è necessario consumare l’intera stringa, verifica pos == text.size() dopo una conversione riuscita.
Se non è possibile effettuare alcuna conversione, la funzione lancia std::invalid_argument. Un risultato fuori dall’intervallo di int, oppure un errore di intervallo nella conversione sottostante, causa std::out_of_range. Gestisci entrambe le eccezioni quando elabori dati non attendibili; dopo un’eccezione, non considerare idx come un risultato della conversione.
L’esempio stampa 42, poi l’indice 2 e infine il resto px. Mostra la differenza tra convertire correttamente una parte iniziale e convalidare l’intero input. La documentazione sorgente è una bozza di lavoro in evoluzione, non un’edizione C++23 congelata; l’esempio è pensato per una verifica locale in modalità C++23, senza attestare un ambiente di produzione.
Esempi
#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";
}
}
Risultato
42 2 px
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.