C++ <vector> at 関数

C++ 容器类 <vector>C++ コンテナクラス <vector>


vector の要素にアクセスするすべての方法の中で、atは最も安全な方法の一つであり、それは次のものを提供するためです:境界チェック。

atはコンテナクラスのメンバ関数であり、次の目的で使用されます:指定された位置の要素を返す、同時に境界チェックを行います。インデックスが範囲外の場合は、スローされますstd::out_of_range例外。

at安全な要素アクセスを実現し、実行時に範囲外エラーを捕捉して処理できるようにします。

単語の意味: at「...の位置に」を意味し、指定された位置の要素を取得します。


基本構文とパラメータ

atはコンテナクラスのメンバ関数であるため、最初にコンテナオブジェクトが必要で、次にドット演算子を使用して.それを呼び出します。

構文形式

reference at(size_type pos);
const_reference at(size_type pos) const;

パラメータの説明

  • パラメータ: pos
    • 型:size_type(符号なし整数型、通常はsize_t)
    • 説明: アクセスする要素の位置(インデックス)。インデックスは0から始まり、最大有効インデックスはsize() - 1。

関数の説明

  • 戻り値: 指定された位置の要素の参照。コンテナがconstコンテナの場合は、const参照を返します。
  • 効果: 指定された位置の要素を返します。インデックスが有効範囲を超えている場合(pos >= size())、スローされますstd::out_of_range例外。
  • operator[] との違い: atは境界チェックを行いますが、operator[]は境界チェックを行いません(範囲外の動作は未定義です)。

例

簡単なものから複雑なものまでの一連の例を通して、徹底的にatの使い方をマスターしましょう。

例1:基本用法 - 要素へのアクセス

例

#include <iostream>
#include <vector>
#include <stdexcept> // 例外処理ヘッダーを含める

int main() {
    // 1. vectorを作成し、いくつかの要素を追加する
    std::vector<int> numbers = {10, 20, 30, 40, 50};

    std::cout << "vectorのサイズは: " << numbers.size() << std::endl;

    // 2. at を使用して要素にアクセスする
    std::cout << "最初の要素 (at(0)): " << numbers.at(0) << std::endl;
    std::cout << "2番目の要素 (at(1)): " << numbers.at(1) << std::endl;
    std::cout << "3番目の要素 (at(2)): " << numbers.at(2) << std::endl;
    std::cout << "最後の要素 (at(4)): " << numbers.at(4) << std::endl;

    // 3. ループを使用してすべての要素にアクセスする
    std::cout << "すべての要素: ";
    for(size_t i = 0; i < numbers.size(); ++i) {
        std::cout << numbers.at(i) << " ";
    }
    std::cout << std::endl;

    return 0;
}

期待される実行結果:

vector的大小是: 5
第一个元素 (at(0)): 10
第二个元素 (at(1)): 20
第三个元素 (at(2)): 30
最后一个元素 (at(4)): 50
所有元素: 10 20 30 40 50

コードの解説:

  1. numbers.at(0)最初の要素を返します10(インデックスは0から始まります)。
  2. numbers.at(4)最後の要素を返します50(なぜならsize()は5なので、有効なインデックスは0-4です)。
  3. ループとatを使用すると、すべての要素を安全に反復処理できます。

例2:範囲外例外の捕捉

atの主な利点は、例外をスローでき、範囲外エラーを処理できるようにすることです。

例

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

int main() {
    std::vector<int> numbers = {10, 20, 30};

    // 範囲外の位置へのアクセスを試みる
    try {
        std::cout << "at(10) へのアクセスを試みています..." << std::endl;
        int value = numbers.at(10); // これは例外をスローします
        std::cout << "値: " << value << std::endl;
    }
    catch(const std::out_of_range& e) {
        std::cout << "例外を捕捉しました: " << e.what() << std::endl;
    }

    // 正常なアクセス
    try {
        std::cout << "at(2) へのアクセス: " << numbers.at(2) << std::endl;
    }
    catch(const std::out_of_range& e) {
        std::cout << "例外を捕捉しました: " << e.what() << std::endl;
    }

    return 0;
}

期待される実行結果:

尝试访问 at(10)...
捕获到异常: vector::_M_range_check: __pos (which is 10) >= this->size() (which is 3)
访问 at(2): 30

コードの解説:

  • アクセスするとat(10)、インデックスが範囲外のため、スローされましたstd::out_of_range例外。
  • catch(const std::out_of_range& e)例外を捕捉し、e.what()例外の説明情報を返します。
  • 正常なインデックスアクセスでは例外はスローされません。

例3:at と operator[] の比較

比較atとoperator[]の動作の違い。

例

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

int main() {
    std::vector<int> numbers = {10, 20, 30};

    std::cout << "at() を使用して要素にアクセス:" << std::endl;
    // at() は境界チェックを行います
    for(size_t i = 0; i <= numbers.size(); ++i) {
        try {
            std::cout << "at(" << i << ") = " << numbers.at(i) << std::endl;
        }
        catch(const std::out_of_range& e) {
            std::cout << "at(" << i << ") 範囲外!" << std::endl;
        }
    }

    std::cout << "\noperator[] を使用して要素にアクセス:" << std::endl;
    // operator[] は境界チェックを行わず、範囲外の動作は未定義です
    for(size_t i = 0; i <= numbers.size(); ++i) {
        std::cout << "numbers[" << i << "] = " << numbers[i] << std::endl;
    }

    return 0;
}

コードの解説:

  • at()は範囲外のときに例外をスローするため、捕捉して処理することを選択できます。
  • operator[]は範囲外のときの動作が未定義であり、ゴミ値を返したり、クラッシュしたり、その他の予測不能な結果になる可能性があります。
  • 本番コードでは、安全のために、次を使用することをお勧めしますat()の代わりにoperator[]、特にインデックスがユーザー入力や外部データから来る場合です。

例4:要素の値の変更

atは参照を返すため、要素の値を変更するために使用できます。

例

#include <iostream>
#include <vector>

int main() {
    std::vector<int> numbers = {10, 20, 30};

    std::cout << "変更前: ";
    for(size_t i = 0; i < numbers.size(); ++i) {
        std::cout << numbers.at(i) << " ";
    }
    std::cout << std::endl;

    // at() を使用して参照を取得し、要素を変更する
    numbers.at(0) = 100;
    numbers.at(1) = 200;
    numbers.at(2) = 300;

    std::cout << "変更後: ";
    for(size_t i = 0; i < numbers.size(); ++i) {
        std::cout << numbers.at(i) << " ";
    }
    std::cout << std::endl;

    return 0;
}

期待される実行結果:

修改前: 10 20 30
修改后: 100 200 300

コードの解説:

  • numbers.at(0) = 100;参照を通じて最初の要素の値を変更しました。
  • これは次のことを示しています:at()は変更可能な左辺値参照を返すこと。

C++ 容器类 <vector>C++ コンテナクラス <vector>

その他の拡張