std::basic_string<CharT,Traits,Allocator>::push_back - cppreference.com (original) (raw)

| void push_back( CharT ch ); | | (constexpr since C++20) | | ---------------------------- | | ----------------------- |

Appends the given character ch to the end of the string.

Contents

• 1 Parameters
• 2 Return value
• 3 Complexity
• 4 Exceptions
• 5 Example
• 6 Defect reports
• 7 See also

[edit] Parameters

[edit] Return value

(none)

[edit] Complexity

Amortized constant.

[edit] Exceptions

If the operation would cause size() to exceed max_size(), throws std::length_error.

If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).

[edit] Example

#include #include #include   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'; }

Output:

1. "Short string", size: 12
2. "Short string!", size: 13

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit] See also

| | removes the last character (public member function) [edit] | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |