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

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

容器庫

序列

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)

 

void shrink_to_fit();		(C++20 起為 constexpr)

請求移除未使用的容量。

這是一個非強制性的請求，要求將 capacity() 減小到 size()。該請求是否被實現取決於具體實現。

如果發生重新分配，所有迭代器（包括 end() 迭代器）以及所有元素引用都將失效。如果未發生重新分配，則沒有迭代器或引用失效。

如果 T 不能 可移動插入 到 std::vector<T, Allocator> 中，則行為是未定義的。

(C++11 起)

複雜度

最多與容器大小呈線性關係。

異常 如果丟擲異常，而不是由非 可複製插入 T 的移動建構函式丟擲，則無任何影響。

(C++11 起)

注意

在 libstdc++ 中，C++98 模式下不可用 shrink_to_fit()。

示例

執行此程式碼

#include <iostream>
#include <vector>
 
int main()
{
    std::vector<int> v;
    std::cout << "Default-constructed capacity is " << v.capacity() << '\n';
    v.resize(100);
    std::cout << "Capacity of a 100-element vector is " << v.capacity() << '\n';
    v.resize(50);
    std::cout << "Capacity after resize(50) is " << v.capacity() << '\n';
    v.shrink_to_fit();
    std::cout << "Capacity after shrink_to_fit() is " << v.capacity() << '\n';
    v.clear();
    std::cout << "Capacity after clear() is " << v.capacity() << '\n';
    v.shrink_to_fit();
    std::cout << "Capacity after shrink_to_fit() is " << v.capacity() << '\n';
    for (int i = 1000; i < 1300; ++i)
        v.push_back(i);
    std::cout << "Capacity after adding 300 elements is " << v.capacity() << '\n';
    v.shrink_to_fit();
    std::cout << "Capacity after shrink_to_fit() is " << v.capacity() << '\n';
}

可能的輸出

Default-constructed capacity is 0
Capacity of a 100-element vector is 100
Capacity after resize(50) is 100
Capacity after shrink_to_fit() is 50
Capacity after clear() is 50
Capacity after shrink_to_fit() is 0
Capacity after adding 300 elements is 512
Capacity after shrink_to_fit() is 300

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 755	C++98	std::vector 缺少顯式的 shrink-to-fit 操作	已提供
LWG 2033	C++98 C++11	1. 缺少複雜度要求 (C++98) 2. T 不需要是 可移動插入 的 (C++11)	1. 新增 2. 要求
LWG 2223	C++98 C++11	1. 引用、指標和迭代器未失效 (C++98) 2. 沒有異常安全保證 (C++11)	1. 它們可能失效 2. 新增

參閱

size	返回元素數量 (公共成員函式)
capacity	返回當前已分配儲存空間中可容納的元素數量 (公共成員函式)