std::vector<T,Allocator>::at

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

容器库

node-handle (C++17)

序列容器

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

关联容器

set

multiset

map

multimap

无序关联容器

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

容器适配器

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

视图

span (C++20)

mdspan (C++23)

表格

迭代器失效

成员函数表格

非成员函数表格

 

std::vector

成员类型
成员函数
vector::vector vector::~vector vector::operator= vector::assign vector::assign_range (C++23)   vector::get_allocator 元素访问 vector::operator[] vector::at vector::data vector::front vector::back 迭代器 vector::beginvector::cbegin (C++11) vector::endvector::cend (C++11) vector::rbeginvector::crbegin (C++11) vector::rendvector::crend (C++11)	容量 vector::empty vector::size vector::max_size vector::reserve vector::capacity vector::shrink_to_fit (DR*) 修改器 vector::clear vector::erase vector::insert vector::insert_range (C++23) vector::append_range (C++23) vector::emplace (C++11) vector::emplace_back (C++11) vector::push_back vector::pop_back vector::resize vector::swap
非成员函数
operator==operator<=> (C++20) swap(std::vector) erase(std::vector)erase_if(std::vector) (C++20)(C++20)	operator!=operator<operator>operator<=operator>= (C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)
推导指引(C++17)

 

reference at( size_type pos );	(1)	(C++20 起为 constexpr)
const_reference at( size_type pos )const;	(2)	(C++20 起为 constexpr)

返回位于指定位置 pos 的元素的引用，有边界检查。

如果 pos 不在容器范围内，那么就会抛出 std::out_of_range 类型的异常。

参数

pos

-

要返回的元素的位置

返回值

到所需元素的引用。

异常

pos >= size()) 时抛出 std::out_of_range。

复杂度

常数。

示例

运行此代码

#include <chrono>#include <cstddef>#include <iostream>#include <vector>#include <stdexcept>   int main(){std::vector<int> data{1, 2, 4, 5, 5, 6};   // 设置第 1 元素 data.at(1)=88;   // 读取第 2 元素std::cout<<"索引为 2 的元素的值为 "<< data.at(2)<<'\n';   std::cout<<"数据大小 = "<< data.size()<<'\n';   try{// 尝试设置位于 >= size() 的随机位置的元素auto moon_phase =[]{returnstd::chrono::system_clock::now().time_since_epoch().count()%8;}; data.at(data.size()+ moon_phase())=13;}catch(conststd::out_of_range& ex){std::cout<< ex.what()<<'\n';}   // 打印最终值std::cout<<"数据：";for(int elem : data)std::cout<<' '<< elem;std::cout<<'\n';}

可能的输出：

索引为 2 的元素的值为 4 数据大小 = 6 vector::_M_range_check: __n (which is 8) >= this->size() (which is 6) 数据： 1 88 4 5 5 6

参阅

operator[]

访问指定的元素 (公开成员函数)