5. at

最終更新日時(UTC):
が更新

履歴 編集

function
<string>

std::basic_string::at

const_reference at(size_type pos) const;           // (1) C++03
constexpr const_reference at(size_type pos) const; // (1) C++20

reference at(size_type pos);                       // (2) C++03
constexpr reference at(size_type pos);             // (2) C++20

概要

pos 番目の要素への参照を取得する。

戻り値

operator[](pos) の結果。

例外

pos >= size() の時、out_of_range 例外を投げる。

例

#include <iostream>
#include <string>
#include <stdexcept>

int main()
{
  std::string s = "hello";

  char& c = s.at(1);
  std::cout << c << std::endl;

  try {
    s.at(5);
  }
  catch (std::out_of_range&) {
    std::cout << "access error" << std::endl;
  }
}

出力

e
access error

参照