std::span<T,Extent>::at
来自 cppreference.com
| constexpr reference at( size_type pos ) const; |
(自 C++26 起) | |
返回指定位置 pos 的元素的引用，并进行边界检查。
如果 pos 不在跨度的范围内，则会抛出类型为 std::out_of_range 的异常。
内容 |
[编辑] 参数
| pos | - | 要返回的元素的位置 |
[编辑] 返回值
对所请求元素的引用，即 *(data() + pos).
[编辑] 异常
如果 pos >= size()，则为 std::out_of_range。
[编辑] 复杂度
常数。
注释
| 特性测试 宏 | 值 | Std | 特性 |
|---|---|---|---|
__cpp_lib_span |
202311L | (C++26) | std::span::at
|
[编辑] 示例
运行此代码
#include <chrono> #include <cstddef> #include <iostream> #include <span> #include <stdexcept> int main() { int x[]{1, 2, 4, 5, 5, 6}; std::span data(x); // Set element 1 data.at(1) = 88; // Read element 2 std::cout << "Element at index 2 has value " << data.at(2) << '\n'; std::cout << "data size = " << data.size() << '\n'; try { // Try to set an element at random position >= 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'; } // Print final values std::cout << "data:"; for (int elem : data) std::cout << ' ' << elem; std::cout << '\n'; }
可能的输出
Element at index 2 has value 4 data size = 6 std::out_of_range: pos (which is 8) >= size() (which is 6) data: 1 88 4 5 5 6
[编辑] 另请参阅
| 访问指定元素 (公有成员函数) |
