Namespaces
Variants

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

From cppreference.net
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* )
最後の文字を削除する
(公開メンバ関数)