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

来自cppreference.com
< cpp‎ | string‎ | basic string
 
C++
 
字符串库
 
std::basic_string
成员函数
元素访问
(C++17)
迭代器
容量
操作
basic_string::push_back
(C++20)
(C++20)
(C++23)
(C++23)  
搜索
常量
推导指引 (C++17)
非成员函数
(C++14)
(C++20)(C++20)
I/O
比较
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
数值转换
(C++11)(C++11)(C++11)
(C++11)(C++11)    
(C++11)(C++11)(C++11)
(C++11)
(C++11)
辅助类
(C++11)  (C++11)(C++11)(C++11)(C++20)
(C++17)(C++17)(C++17)(C++17)(C++20)
 
void push_back( CharT ch );
 (C++20 前)
constexpr void push_back( CharT ch );
 (C++20 起)

后附给定字符 ch 到字符串尾。

参数

ch - 要后附的字符

返回值

（无）

复杂度

均摊常数。

异常

如果操作会导致 size() > max_size()，那么就会抛出 std::length_error。

如果因为任何原因抛出了异常，那么此函数无效果（强异常安全保证）。

示例

运行此代码
#include <iomanip>
#include <iostream>
#include <string>
 
int main()
{
    std::string str{"Short string"};
    std::cout << "1) " << std::quoted(str) << "，大小：" << str.size() << '\n';
 
    str.push_back('!');
    std::cout << "2) " << std::quoted(str) << "，大小：" << str.size() << '\n';
}

输出： 

1) "Short string"，大小：12
2) "Short string!"，大小：13

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 7 C++98 (1) C++ 标准里缺失了相应描述
(2) 形参类型是 const CharT 		(1) 补充相应描述
(2) 改成 CharT
LWG 847 C++98 没有异常安全保证 添加强异常安全保证

参阅

 移除末尾字符
(公开成员函数)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/push_back&oldid=78028”