std::basic_string<CharT,Traits,Allocator>:: reserve

参数

返回值

(无)

异常

若 new_cap 大于 max_size() ，则抛出 std::length_error 。

可能抛出由 std:: allocator_traits < Allocator > :: allocate ( ) 抛出的任何异常，例如 std::bad_alloc 。

若因任何原因抛出异常，此函数不产生任何效果（ 强异常安全保证 ）。

复杂度

最多与字符串的 size() 呈线性关系。

示例

#include <cassert>
#include <iostream>
#include <string>
int main()
{
    std::string s;
    std::cout << "1) 初始状态: " << s.capacity() << '\n';
    const std::string::size_type new_cap{101u};
    s.reserve(new_cap);
    assert(s.capacity() >= new_cap);
    std::cout << "2) 调用 reserve(" << new_cap << ") 后: " << s.capacity() << '\n';
    // 观察容量增长因子
    auto cap{s.capacity()};
    for (int check{}; check != 4; ++check)
    {
        while (cap == s.capacity())
            s += '$';
        cap = s.capacity();
        std::cout << (3) + check << ") 容量: " << cap << '\n';
    }
//  s.reserve(); // C++20/26 中已弃用/移除，改用：
    s.shrink_to_fit();
    std::cout << "7) 调用 shrink_to_fit 后: " << s.capacity() << '\n';
}

1) 初始状态: 15
2) 调用 reserve(101) 后: 101
3) 容量: 202
4) 容量: 404
5) 容量: 808
6) 容量: 1616
7) 调用 shrink_to_fit 后: 809

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

参见