std::deque<T,Allocator>:: at
From cppreference.net
C++
Containers library
|
(C++17)
|
||||
| Sequence | ||||
|
(C++11)
|
||||
|
(C++26)
|
||||
|
(C++26)
|
||||
|
(C++11)
|
||||
| Associative | ||||
| Unordered associative | ||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
| Adaptors | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
| Views | ||||
|
(C++20)
|
||||
|
(C++23)
|
||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
std::deque
| Member types | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Non-member functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Deduction guides (C++17) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
reference at
(
size_type pos
)
;
|
(1) | (自 C++26 起为 constexpr) |
|
const_reference at
(
size_type pos
)
const
;
|
(2) | (自 C++26 起为 constexpr) |
返回指定位置 pos 处元素的引用,并进行边界检查。
如果 pos 不在容器范围内,将抛出 std::out_of_range 类型的异常。
目录 |
参数
| pos | - | 要返回元素的位置 |
返回值
对所请求元素的引用。
异常
若 pos >= size ( ) 则抛出 std::out_of_range 异常。
复杂度
常量。
示例
运行此代码
#include <chrono> #include <cstddef> #include <iostream> #include <deque> #include <stdexcept> int main() { std::deque<int> data{1, 2, 4, 5, 5, 6}; // 设置元素 1 data.at(1) = 88; // 读取元素 2 std::cout << "索引 2 处的元素值为 " << data.at(2) << '\n'; std::cout << "data 大小 = " << data.size() << '\n'; try { // 尝试在随机位置 >= size() 处设置元素 auto moon_phase = [] { return std::chrono::system_clock::now().time_since_epoch().count() % 8; }; data.at(data.size() + moon_phase()) = 13; } catch(const std::out_of_range& ex) { std::cout << ex.what() << '\n'; } // 打印最终值 std::cout << "data:"; for (int elem : data) std::cout << ' ' << elem; std::cout << '\n'; }
可能的输出:
索引 2 处的元素值为 4 data 大小 = 6 deque::_M_range_check: __n (值为 8) >= this->size() (值为 6) data: 1 88 4 5 5 6
参见
|
访问指定元素
(公开成员函数) |