CKTIS / C++
std::out_of_range — argomento fuori dall’intervallo previsto
std::out_of_range, dichiarato in <stdexcept>, segnala un valore di argomento fuori dall’intervallo previsto. Contiene un messaggio accessibile tramite what() e deriva da std::logic_error.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <stdexcept>
throw std::out_of_range("message");
// Handler:
catch (const std::out_of_range& e) { /* use e.what() */ }std::out_of_range è una classe di eccezione dichiarata in <stdexcept> per segnalare un valore di argomento fuori dall’intervallo previsto. Deriva pubblicamente da std::logic_error e indirettamente da std::exception.
I suoi costruttori accettano un messaggio come const std::string& oppure const char*. Il membro what() espone un testo corrispondente al messaggio fornito. Cattura l’eccezione tramite const std::out_of_range&. Non confonderla con std::range_error, che descrive errori di intervallo nei calcoli interni e deriva da std::runtime_error.
Nell’esempio, checked_score controlla esplicitamente l’intervallo [0, 100] e rifiuta 101. L’esistenza di questa classe di eccezione non aggiunge controlli dell’intervallo alle operazioni. L’esempio è destinato a C++23; l’attuale bozza di lavoro include anche modifiche successive, quindi i costruttori constexpr mostrati non sono garantiti da C++23.
Esempi
#include <iostream>
#include <stdexcept>
int checked_score(int score) {
if (score < 0 || score > 100) {
throw std::out_of_range("score must be in [0, 100]");
}
return score;
}
int main() {
try {
std::cout << checked_score(101) << '\n';
} catch (const std::out_of_range& e) {
std::cout << e.what() << '\n';
}
}
Risultato
score must be in [0, 100]
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.