C++ <vector> at 関数
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;
}
#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
コードの解説:
numbers.at(0)最初の要素を返します10(インデックスは0から始まります)。numbers.at(4)最後の要素を返します50(なぜならsize()は5なので、有効なインデックスは0-4です)。- ループと
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;
}
#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;
}
#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;
}
#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>