| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Thu, 24 Jul 2025 03:13:13 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/string/basic_string/push_back/
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 24 Jul 2025 03:13:13 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"9a55-ULT5MVF/krwNMzVTDd2+ztDwlsA"
Content-Encoding: gzip
Appends character c to the end of the basic_string, increasing its length by one.
This example reads an entire file character by character, appending each character to a string object using push_back.
If the resulting string length would exceed the max_size, a length_error exception is thrown.
If the type uses the default allocator, a bad_alloc exception is thrown if the function needs to allocate storage and fails.
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
basic_string
- basic_string::~basic_string
- basic_string::basic_string
member functions
- basic_string::append
- basic_string::assign
- basic_string::at
-
basic_string::backC++11
- basic_string::begin
- basic_string::c_str
- basic_string::capacity
-
basic_string::cbeginC++11
-
basic_string::cendC++11
- basic_string::clear
- basic_string::compare
- basic_string::copy
-
basic_string::crbeginC++11
-
basic_string::crendC++11
- basic_string::data
- basic_string::empty
- basic_string::end
- basic_string::erase
- basic_string::find
- basic_string::find_first_not_of
- basic_string::find_first_of
- basic_string::find_last_not_of
- basic_string::find_last_of
-
basic_string::frontC++11
- basic_string::get_allocator
- basic_string::insert
- basic_string::length
- basic_string::max_size
- basic_string::operator[]
- basic_string::operator+=
- basic_string::operator=
-
basic_string::pop_backC++11
- basic_string::push_back
- basic_string::rbegin
- basic_string::rend
- basic_string::replace
- basic_string::reserve
- basic_string::resize
- basic_string::rfind
-
basic_string::shrink_to_fitC++11
- basic_string::size
- basic_string::substr
- basic_string::swap
member constants
non-member overloads
- Reference
- <string>
- basic_string
- push_back
public member function
<string>
std::basic_string::push_back
void push_back (charT c);
Append character to string
Parameters
- c
- Character added to the basic_string.
charT is basic_string's character type (i.e., its first template parameter).
Return value
noneExample
|
|
This example reads an entire file character by character, appending each character to a string object using push_back.
Complexity
Unspecified; Generally amortized constant, but up to linear in the new string length.Iterator validity
Any iterators, pointers and references related to this object may be invalidated.Data races
The object is modified.Exception safety
Strong guarantee: if an exception is thrown, there are no changes in the basic_string.If the resulting string length would exceed the max_size, a length_error exception is thrown.
If the type uses the default allocator, a bad_alloc exception is thrown if the function needs to allocate storage and fails.
See also
- basic_string::back
- Access last character (public member function)
- basic_string::pop_back
- Delete last character (public member function)
- basic_string::append
- Append to string (public member function)
- basic_string::insert
- Insert into string (public member function)
- basic_string::end
- Return iterator to end (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us