Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti