std::shared_ptr<T>::operator[] - cppreference.com

std::shared_ptr<T>::operator[]

来自cppreference.com
 
 
内存管理库
(仅用于阐述*)
分配器
未初始化内存算法
受约束的未初始化内存算法
内存资源
未初始化存储 (C++20 前)
(C++17 弃用)
(C++17 弃用)

垃圾收集器支持 (C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
 
 
element_type& operator[]( std::ptrdiff_t idx ) const;
(C++17 起)

对存储的指针所指向的数组进行索引。

如果存储的指针为空,那么行为未定义。

如果 idx 为负,或者 T 是数组类型 U[N]idx 大于或等于 N,那么行为未定义。

(C++26 前)

如果 idx 为负,或者 T 是数组类型 U[N]idx 大于或等于 N,那么:

  • 如果实现是硬化实现,那么就会发生契约违背
  • 如果实现不是硬化实现,那么行为未定义。
(C++26 起)

参数

idx - 数组索引

返回值

到数组第 idx 元素的引用,即 get()[idx]

异常

不抛出。

提醒

T 不是数组类型时,是否声明此函数是未指定的。如果声明了此函数,那么它的返回类型是未指定的,但函数声明保证合法,函数定义未必合法。

示例

#include <cstddef>
#include <iostream>
#include <memory>

int main()
{
    const std::size_t arr_size = 10;
    std::shared_ptr<int[]> pis(new int[10]{0, 1, 2, 3, 4, 5, 6, 7, 8, 9});
    for (std::size_t i = 0; i < arr_size; ++i)
        std::cout << pis[i] << ' ';
    std::cout << '\n';
}

输出:

0 1 2 3 4 5 6 7 8 9

参阅