最終更新日時(UTC): 2025年10月20日 07時28分41秒
Raclamusi が更新

履歴 編集

function
<vector>

# std::vector::at

    reference at(size_type n);                       // (1) C++03
    constexpr reference at(size_type n);             // (1) C++20

    const_reference at(size_type n) const;           // (2) C++03
    constexpr const_reference at(size_type n) const; // (2) C++20

## 概要

要素アクセス

## 戻り値

`n`番目の要素への参照を返す。

## 計算量

定数時間

## 例外

`n >= size()`の場合、`out_of_range` 例外を送出する。

## 備考

`at(n)` は `*(begin() + n)` と同じ結果となるが、イテレータを使用したランダムアクセスや`operator[]`と違い、コンテナの要素数に対して境界チェックを行う。

## 例

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

    int main()
    {
      std::vector<int> v = {3, 1, 4};

      // 2番目の要素を参照する
      int& x = v.at(2);
      std::cout << x << std::endl;

      // 範囲外アクセスした場合、例外が投げられる
      try {
        int& y = v.at(3);
      }
      catch (std::out_of_range& ex) {
        std::cout << "out of range" << std::endl;
      }
    }

### 出力

    4
    out of range

## 参照

- P1004R2 Making `std::vector` constexpr