std::basic_string<CharT,Traits,Allocator>:: push_back
From cppreference.net
<
cpp
|
string
|
basic string
C++
Strings library
| Classes | ||||
|
(C++17)
|
||||
std::basic_string
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
void
push_back
(
CharT ch
)
;
|
(C++20以降 constexpr) | |
指定された文字 ch を文字列の末尾に追加します。
目次 |
パラメータ
| ch | - | 追加する文字 |
戻り値
(なし)
計算量
償却定数時間。
例外
操作によって
size()
が
max_size()
を超える場合、
std::length_error
をスローします。
何らかの理由で例外がスローされた場合、この関数は何も効果を持ちません( strong exception safety guarantee )。
例
このコードを実行
#include <iomanip> #include <iostream> #include <string> int main() { std::string str{"Short string"}; std::cout << "1) " << std::quoted(str) << ", size: " << str.size() << '\n'; str.push_back('!'); std::cout << "2) " << std::quoted(str) << ", size: " << str.size() << '\n'; }
出力:
1) "Short string", size: 12 2) "Short string!", size: 13
不具合報告
以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。
| DR | 適用対象 | 公開時の動作 | 正しい動作 |
|---|---|---|---|
| LWG 7 | C++98 |
1) C++標準で説明が欠落していた
2) パラメータ型は const CharT |
1) 説明を追加
2)
CharT
に変更
|
| LWG 847 | C++98 | 例外安全性保証がなかった | 強い例外安全性保証を追加 |
関連項目
|
(
DR*
)
|
最後の文字を削除する
(公開メンバ関数) |