std::span<T,Extent>::at
来自cppreference.com
| constexpr reference at( size_type pos ) const; |
(C++26 起) | |
返回位于指定位置 pos 的元素的引用，有边界检查。
若 pos 不在span范围内，则抛出 std::out_of_range 类型的异常。
参数
| pos | - | 要返回的元素的位置 |
返回值
到所需元素的引用，即 *(a.begin() + pos)。
异常
若 pos >= size()) 则抛出 std::out_of_range。
复杂度
常数。
注解
| 功能特性测试宏 | 值 | 标准 | 功能特性 |
|---|---|---|---|
__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); // 设置第 1 元素 data.at(1) = 88; // 读取第 2 元素 std::cout << "索引为 2 的元素的值为 " << data.at(2) << '\n'; std::cout << "数据大小 = " << 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 << "数据:"; for (int elem : data) std::cout << " " << elem; std::cout << '\n'; }
可能的输出：
索引为 2 的元素的值为 4 数据大小 = 6 std::out_of_range: pos (which is 8) >= size() (which is 6) 数据: 1 88 4 5 5 6
参阅
| 访问指定的元素 (公开成员函数) |