Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::out_of_range — argumento fora do intervalo esperado

std::out_of_range, declarado em <stdexcept>, assinala um valor de argumento fora do intervalo esperado. Transporta uma mensagem acessível através de what() e deriva de std::logic_error.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <stdexcept>
throw std::out_of_range("message");
// Handler:
catch (const std::out_of_range& e) { /* use e.what() */ }

std::out_of_range é uma classe de exceção declarada em <stdexcept> para assinalar um valor de argumento fora do intervalo esperado. Deriva publicamente de std::logic_error e, indiretamente, de std::exception.

Os seus construtores aceitam uma mensagem como const std::string& ou const char*. O membro what() expõe texto correspondente à mensagem fornecida. Capture a exceção através de const std::out_of_range&. Não a confunda com std::range_error, que descreve erros de intervalo em cálculos internos e deriva de std::runtime_error.

No exemplo, checked_score verifica explicitamente o intervalo [0, 100] e rejeita 101. A existência desta classe de exceção não acrescenta verificações de intervalo às operações. O exemplo destina-se a C++23; o atual projeto de norma também inclui alterações posteriores, pelo que os construtores constexpr aí apresentados não são uma garantia de C++23.

Exemplos

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

Resultado

score must be in [0, 100]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes