---
title: small_vector
description: "本章接口为预留接口，后续有可能变更或废弃，不建议开发者使用，开发者无需关注。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/aolapi/atlasascendc_api_07_1149.html
sourcePath: /source/zh/canncommercial/900/API/aolapi/atlasascendc_api_07_1149.html
indexId: 84fe41db6c1d9c7a87aea7ce8d976c412a8672b3ed9bc046db34dcd48e5cbbef70
---
# small_vector

本章接口为预留接口，后续有可能变更或废弃，不建议开发者使用，开发者无需关注。


**表1 接口列表**

| 接口定义 | 功能说明 |
| --- | --- |
| PtrToValue(const void \*const ptr) | 将void\*型数据转换为uint64\_t型。 |
| ValueToPtr(const uint64\_t value) | 将uint64\_t型数据转换为void\*型。 |
| VPtrToValue(const std::vector<void \*> v\_ptr) | 将vector容器中void\*型元素转换为uint64\_t型元素。 |
| PtrToPtr(TI \*const ptr) | 任意类型指针变量（指针地址不可修改）转换为另一任意类型的指针变量。 |
| PtrToPtr(const TI \*const ptr) | 任意类型指针变量（指针地址和所指的值不可修改）转换为另一任意类型的指针变量（指针所指的值不可修改）。 |
| PtrAdd(T \*const ptr, const size\_t max\_buf\_len, const size\_t idx) | 当指针变量ptr不为空且idx小于max\_buf\_len，返回指针地址ptr增加idx长度后的指针，否则返回null。 |
| SmallVector(const allocator\_type &alloc = Alloc()) | SmallVector默认构造函数。 |
| SmallVector(const size\_type count, const T &value, const allocator\_type &alloc = Alloc()) | SmallVector构造函数，初始化count个元素值为相同value。 |
| SmallVector(const size\_type count, const allocator\_type &alloc = Alloc()) | SmallVector构造函数，带有count个初始元素。 |
| SmallVector(InputIt first, const InputIt last, const allocator\_type &alloc = Alloc()) | SmallVector构造函数，利用迭代器范围初始化元素。 |
| SmallVector(const SmallVector &other) | SmallVector拷贝构造函数，深拷贝，复制other中元素并存储在新的内存中。 |
| SmallVector(SmallVector &&other) | SmallVector移动构造函数，将已存在的vector对象资源移动到新创建的vector中。 |
| SmallVector(const std::initializer\_list<T> init, const allocator\_type &alloc = Alloc()) | SmallVector构造函数。 |
| clear() | 清空整个SmallVector。 |
| ClearElements() | 清空整个SmallVector，并返回迭代器初始地址。 |
| FreeStorage() | 清空内存。 |
| at(const size\_type index) | 返回SmallVector中index位置的元素的引用。 |
| front() | 返回SmallVector中第一个位置元素的引用。 |
| begin() | 返回一个迭代器，指向SmallVector容器中第一个元素。 |
| back() | 返回SmallVector中最后一个位置元素的引用。 |
| rbegin() | 返回一个反向迭代器，指向SmallVector容器中的最后一个元素。 |
| data() | 返回指向第一个元素的指针。 |
| GetPointer() | 返回指向第一个元素的指针。 |
| cbegin() | 返回一个const\_iterator，指向SmallVector容器第一个元素。 |
| cend() | 返回一个const\_iterator，指向SmallVector容器最后一个元素的下一个元素。 |
| crbegin() | 返回一个const\_iterator，指向SmallVector容器中最后一个元素。 |
| rend() | 返回一个反向迭代器，指向SmallVector容器中第一个元素之前的元素，该元素被视为其反向结束。 |
| crend() | 返回一个const反向迭代器，指向SmallVector容器中第一个元素之前的元素，该元素被视为其反向结束。 |
| size() | 返回SmallVector容器中元素的个数。 |
| reserve(const size\_type new\_cap) | 当new\_cap大于已分配容量，需更改容器容量，要求为SmallVector容器元素分配的存储空间容量至少容纳返回已分配存储容量的大小个元素。 |
| capacity() | 返回已分配存储容量的大小。 |
| insert(const\_iterator const pos, const T &value) | 在SmallVector容器指定位置前插入元素。 |
| insert(const\_iterator const pos, T &&value) | 在SmallVector容器指定位置前插入value元素，value是浅拷贝。 |
| insert(const\_iterator const pos, const size\_type count, const T &value) | 在SmallVector容器指定位置前插入count个值为value的元素。 |
| insert(const\_iterator const pos, const InputIt first, const InputIt last) | 将指定元素范围[first, last)中的元素复制并插入到SmallVector容器指定位置前。 |
| insert(const\_iterator const pos, const std::initializer\_list<T> value\_list) | 在SmallVector容器指定位置前插入T类型对象数组的所有元素。 |
| emplace(const\_iterator const pos, Args &&...args) | 将一个新元素直接插入到SmallVector容器中的pos之前，该元素是通过args参数直接构造出来的。 |
| erase(const\_iterator const pos) | 删除SmallVector容器指定位置的一个元素。 |
| erase(const\_iterator const first, const\_iterator const last) | 删除SmallVector容器指定范围[first, last)的元素。 |
| push\_back(const T &value) | 在SmallVector容器末尾加上一个元素。 |
| push\_back(T &&value) | 在SmallVector容器末尾加上元素value元素，value元素是浅拷贝。 |
| emplace\_back(Args &&...args) | 在SmallVector容器末尾插入一个元素，该元素是通过args参数直接构造出来的。 |
| pop\_back() | 删除SmallVector容器最后一个元素。 |
| resize(const size\_type count) | 调整SmallVector容器大小为count。如果count小于当前容器大小，则取前count个元素，否则在容器后面使用默认构造函数增加相应的元素。 |
| resize(const size\_type count, const T &value) | 调整SmallVector容器大小为count。如果count小于当前容器大小，则取前count个元素，否则将value复制到增加的元素中。 |
| swap(SmallVector &other) | 将SmallVector容器的内容与other SmallVector容器的内容交换。 |
| GetPointer(const size\_type idx = 0UL) | 返回指定位置的地址。 |
| InitStorage(const size\_type size) | 初始化整个容器内存，若size小于当前容量，初始化当前容量大小的内存，若size大于当前容量，resize容器到size的大小，在初始化内存。 |
| CopyRange(T \*iter, InputIt first, const InputIt last) | 拷贝[first, last)范围内存到迭代器iter位置。 |
| MoveFrom(SmallVector &other) | 从other容器拷贝内存到当前容器。 |
| CheckOutOfRange(const size\_type index) | 检查index是否超出容器范围。 |
| ExpandCap(const size\_type range\_begin, const size\_type range\_len) | 先申请一块新的内存，大小为原容器容量加上range\_len大小，新容量不足原容量2倍则按2倍扩容。在原SmallVector容器range\_begin的位置拓展range\_len大小的内存，并拷贝到新内存中，释放原容器内存。 |
| ExpandSize(const size\_type range\_begin, const size\_type range\_len) | 在SmallVector容器中，range\_begin的位置，拓展range\_len大小的内存。 |
| Expand(const size\_type range\_begin, const size\_type range\_len) | 拓展SmallVector容器内存，若拓展后大于容器最大容量，按ExpandCap方式拓展，否则按ExpandSize方式拓展。 |
| Shrink(const size\_type range\_begin, const size\_type range\_end) | 在SmallVector容器中，删掉从range\_begin到range\_end之间的内存。 |
| swap(op::internal::SmallVector<T, N, Alloc> &sv1, op::internal::SmallVector<T, N, Alloc> &sv2) | 交换两个SmallVector容器sv1和sv2的元素。 |