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

void resize( size_type count );	(1)	(constexpr 自 C++20 起)
void resize( size_type count, CharT ch );	(2)	(constexpr 自 C++20 起)

将字符串大小调整为包含 count 个字符。

如果当前大小小于 count，则附加字符。

1) 将附加字符初始化为 CharT() ('\0' 如果 CharT 是 char).

2) 将附加字符初始化为 ch.

如果当前大小大于 count，则字符串将缩减到其前 count 个元素。

[编辑] 参数

count	-	字符串的新大小
ch	-	用于初始化新字符的字符

[编辑] 返回值

(无)

[编辑] 异常

std::length_error 如果 count > max_size()。Allocator 抛出的任何异常。

如果由于任何原因抛出异常，此函数将不起作用 (强异常安全保证).

[编辑] 示例

运行此代码

#include <iomanip>
#include <iostream>
#include <stdexcept>
 
int main()
{
    const unsigned desired_length{8};
    std::string long_string("Where is the end?");
    std::string short_string("H");
 
    std::cout << "Basic functionality:\n"
              << "Shorten:\n"
              << "1. Before: " << std::quoted(long_string) << '\n';
    long_string.resize(desired_length);
    std::cout << "2. After:  " << std::quoted(long_string) << '\n';
 
    std::cout << "Lengthen with a given value 'a':\n"
              << "3. Before: " << std::quoted(short_string) << '\n';
    short_string.resize(desired_length, 'a');
    std::cout << "4. After:  " << std::quoted(short_string) << '\n';
 
    std::cout << "Lengthen with char() == " << static_cast<int>(char()) << '\n'
              << "5. Before: " << std::quoted(short_string) << '\n';
    short_string.resize(desired_length + 3);
    std::cout << "6. After:  \"";
    for (char c : short_string)
        std::cout << (c == char() ? '@' : c);
    std::cout << "\"\n\n";
 
    std::cout << "Errors:\n";
    std::string s;
 
    try
    {
        // size is OK, no length_error
        // (may throw bad_alloc)
        s.resize(s.max_size() - 1, 'x');
    }
    catch (const std::bad_alloc& ex)
    {
        std::cout << "1. Exception: " << ex.what() << '\n';
    }
 
    try
    {
        // size is OK, no length_error
        // (may throw bad_alloc)
        s.resize(s.max_size(), 'x');
    }
    catch (const std::bad_alloc& ex)
    {
        std::cout << "2. Exception: " << ex.what() << '\n';
    }
 
    try
    {
        // size is BAD, throw length_error
        s.resize(s.max_size() + 1, 'x');
    }
    catch (const std::length_error& ex)
    {
        std::cout << "3. Length error: " << ex.what() << '\n';
    }
}

可能的输出

Basic functionality:
Shorten:
1. Before: "Where is the end?"
2. After:  "Where is"
Lengthen with a given value 'a':
3. Before: "H"
4. After:  "Haaaaaaa"
Lengthen with char() == 0
5. Before: "Haaaaaaa"
6. After:  "Haaaaaaa@@@"
 
Errors:
1. Exception: std::bad_alloc
2. Exception: std::bad_alloc
3. Length error: basic_string::_M_replace_aux

[编辑] 缺陷报告

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

DR	应用于	发布的行为	正确行为
LWG 847	C++98	没有异常安全保证	添加了强异常安全保证

[编辑] 另请参阅

sizelength	返回字符数 (公共成员函数) [编辑]
reserve	保留存储空间 (公共成员函数) [编辑]
shrink_to_fit (DR*)	通过释放未使用的内存来减少内存使用量 (公共成员函数) [编辑]

编译器支持
独立和宿主
语言
标准库
标准库头文件
命名需求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

以 null 结尾的字符串
字节字符串
多字节字符串
宽字符串
类
basic_string
basic_string_view (C++17)
char_traits

cppreference.com

命名空间

变体

视图

操作