HOWTO · C++

C++ で範囲外例外をスローする

この記事では、C++ で範囲外の例外をスローする方法について説明します。 また、C++ で範囲外の例外をスローする際に発生する可能性のあるエラーについても説明します。

このページの内容

C++ には、有効な範囲を外れたインデックスを知らせる標準例外型 std::out_of_range があります。この例外は自分で生成してスローすることも、std::vector::at のような範囲チェック付きの操作にスローさせることもできます。プログラムで問題から復旧したり、問題を報告したりできる場合は、try/catch ブロックで捕捉します。以下の例では、この例外型を使うために <stdexcept> をインクルードします。

std::out_of_range とは

std::out_of_range は <stdexcept> で宣言されており、さらに std::exception を基底クラスとする std::logic_error を継承しています。許容範囲外の引数を受け取った操作を表す例外型です。型そのものは例外オブジェクトではありません。throw 式にはオブジェクトが必要で、通常はメッセージを指定してオブジェクトを生成します。ハンドラーは what() でそのメッセージを確認できます。

サイズが n のシーケンスでは、インデックスが0以上かつ n 未満なら有効です。したがって、シーケンスが空でなければ、最後の有効なインデックスは n - 1 です。サイズとインデックスの型にも注意してください。チェック前に負の符号付きインデックスを符号なし型へ変換すると、大きな正の値になることがあります。

std::out_of_range を手動でスローする

自分で行った検証で不正な引数が見つかったときは、メッセージ付きのオブジェクトを生成してスローします。この方法は、インデックスを受け取り、使用するストレージの種類にかかわらず同じ標準例外を報告したい関数で役立ちます。

このセクションのコードと表示されるラベルや出力は英語のままです。

#include <iostream>
#include <stdexcept>

int readValue(int index) {
    const int values[] = {10, 20, 30};
    const int size = 3;
    if (index < 0 || index >= size) {
        throw std::out_of_range("index must be between 0 and 2");
    }
    return values[index];
}

int main() {
    try {
        std::cout << readValue(3) << '\n';
    } catch (const std::out_of_range& error) {
        std::cout << error.what() << '\n';
    }
}

この関数は配列を読み取る前にチェックするため、インデックスが無効な場合に values[index] を評価することはありません。呼び出し元は例外を捕捉してメッセージを報告するか、別の方法で復旧できます。拒否した引数や期待される範囲が分かるメッセージを選び、標準ライブラリの例外が返す特定の文言には依存しないでください。

範囲チェック付きアクセスに std::vector::at を使う

vector の at() はインデックスをチェックし、vector のサイズ以上なら std::out_of_range をスローします。operator[] はこのチェックを行わないため、コード内ですでにインデックスの有効性を確認できている場合にだけ使ってください。

次の例を実行します。

このセクションのコードと表示されるラベルや出力は英語のままです。

#include <iostream>
#include <vector>

int main() {
    const std::vector<int> numbers = {10, 20, 30};
    std::cout << numbers.at(1) << '\n';
}

検索に失敗した場合に処理できるよう、例外をスローする可能性のある操作を囲んで捕捉します。

#include <iostream>
#include <stdexcept>
#include <vector>

int main() {
    const std::vector<int> numbers = {10, 20, 30};
    try {
        std::cout << numbers.at(5) << '\n';
    } catch (const std::out_of_range& error) {
        std::cout << "Lookup failed: " << error.what() << '\n';
    }
}

ライブラリが生成する例外で what() が返す文言は実装によって異なるため、診断メッセージの正確な文字列に依存しないでください。無効な operator[] アクセスが起こり得る場合は、at() に切り替えることで、チェックなしのアクセスに頼らず、例外として捕捉できるようになります。

生配列にアクセスする前にチェックする

組み込み配列には at() メンバー関数がなく、配列自身による範囲チェックもありません。符号付きインデックスを使う場合は、使用前にチェックし、条件を満たした後でのみ要素にアクセスします。たとえば、ポインターと長さを受け取る関数では、同じように明示的な検証を行えます。

このセクションのコードと表示されるラベルや出力は英語のままです。

#include <iostream>
#include <stdexcept>

int getElement(const int* values, int size, int index) {
    if (index < 0 || index >= size) {
        throw std::out_of_range("array index is outside the valid range");
    }
    return values[index];
}

int main() {
    const int values[] = {4, 8, 12};
    try {
        std::cout << getElement(values, 3, 1) << '\n';
    } catch (const std::out_of_range& error) {
        std::cout << error.what() << '\n';
    }
}

呼び出し元は、実際の配列の長さを表す値を渡す必要があり、ポインターはアクセス可能な記憶域を指していなければなりません。このチェックで確認できるのは、渡された長さを基準にしたインデックスの範囲です。ポインターや長さが正しいかどうかまでは確認できません。負の値を符号なしインデックスに変換する前に拒否できるよう、符号の扱いを一貫させてください。

std::out_of_range を捕捉して処理する

例外のコピーを避け、動的型を保つため、const 参照で捕捉します。error.what() を呼び出すと、ログへの記録や表示に使える診断文字列を取得できます。プログラムが適切に復旧できるエラーだけを処理し、それ以外は上位のハンドラーへ伝播させてください。

スローされた例外に一致するハンドラーがない場合、C++ は std::terminate を呼び出します。その際の診断表示やプロセスの動作は実行環境によって異なるため、決まったメッセージが出るとは限りません。処理できると分かっている操作だけを、できるだけ小さな範囲で try ブロックに入れてください。また、読み取りに失敗したデータを使って処理を続けないようにします。

よくある間違い:オブジェクトではなく型をスローする

throw std::out_of_range; は無効です。std::out_of_range は型の名前であり、生成済みのオブジェクトではないためです。次のように、throw 式の中でメッセージを指定してインスタンスを生成してください。throw std::out_of_range("index is too large");。この型を使う場所では <stdexcept> をインクルードする必要があります。catch 節では型を指定しますが、throw 式ではオブジェクトを渡します。この2つは構文も役割も異なります。

適切な方法を選ぶ

vector の各アクセスをチェックし、その結果発生する例外を処理できる場合は std::vector::at() を使います。インデックスが有効だとすでに保証され、チェックなしのアクセスがコードに適している場合は operator[] を使います。生配列や独自の範囲規則を持つ関数では、符号付きインデックスを明示的に検証し、記憶域にアクセスする前に std::out_of_range をスローしてください。

例外処理は、状況を補足したり、復旧したり、エラーを報告したりできる層で行います。at() を使って vector にアクセスする場合、std::out_of_range を手動で生成する必要はありません。インデックスが無効なら、ライブラリが例外を生成します。どの方法を選ぶ場合も、有効な範囲を明確にし、必要なチェックを終えてからアクセスしてください。