Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::out_of_range — argument zunaj pričakovanega obsega

std::out_of_range, deklariran v <stdexcept>, sporoča vrednost argumenta zunaj pričakovanega obsega. Vsebuje sporočilo, dostopno prek what(), in izhaja iz std::logic_error.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

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

std::out_of_range je razred izjem, deklariran v <stdexcept>, namenjen sporočanju vrednosti argumenta zunaj pričakovanega obsega. Javno izhaja iz std::logic_error in posredno iz std::exception.

Njegovi konstruktorji sprejmejo sporočilo kot const std::string& ali const char*. Član what() omogoča dostop do besedila, ki ustreza podanemu sporočilu. Izjemo ujemite kot const std::out_of_range&. Ne zamenjujte je z std::range_error, ki opisuje napake obsega pri notranjih izračunih in izhaja iz std::runtime_error.

V primeru checked_score izrecno preveri interval [0, 100] in zavrne 101. Obstoj tega razreda izjem operacijam ne doda preverjanja obsega. Primer je namenjen za C++23; trenutni delovni osnutek vključuje tudi poznejše spremembe, zato konstruktorji constexpr, prikazani v njem, niso zagotovljeni v C++23.

Primeri

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

Rezultat

score must be in [0, 100]

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri