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

< cpp‎ | container‎ | vector

 
C++
 
容器库
 
std::vector
成员函数
元素访问
vector::at
(C++11)
迭代器
(C++11)
(C++11)
(C++11)
(C++11)
容量
(C++11)
修改器
(C++11)
(C++11)
非成员函数
(C++20)(C++20)
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
推导指引(C++17)
 
reference at( size_type pos );
 (C++20 前)
constexpr reference at( size_type pos );
 (C++20 起)
const_reference at( size_type pos ) const;
 (C++20 前)
constexpr const_reference at( size_type pos ) const;
 (C++20 起)

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

若 pos 不在容器范围内，则抛出 std::out_of_range 类型的异常。

参数

pos - 要返回的元素的位置

返回值

到所需元素的引用。

异常

若 !(pos < size()) 则抛出 std::out_of_range

复杂度

常数。

示例

运行此代码
#include <iostream>
#include <vector>
 
int main()
{
    std::vector<int> data = { 1, 2, 4, 5, 5, 6 };
 
    // 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 {
        // Set element 6
        data.at(6) = 666;
    } catch (std::out_of_range const& exc) {
        std::cout << exc.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
vector::_M_range_check: __n (which is 6) >= this->size() (which is 6)
data: 1 88 4 5 5 6

参阅

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