The class template basic_string
stores and manipulates sequences of character-like objects, which are non-array objects of TrivialType and StandardLayoutType. The class is dependent neither on the character type nor on the nature of operations on that type. The definitions of the operations are supplied via the Traits
template parameter - a specialization of std::char_traits or a compatible traits class.
The elements of a basic_string
are stored contiguously, that is, for a basic_string
s, &*(s.begin() + n) == &*s.begin() + n for any n in [
â0â,
s.size())
, and *(s.begin() + s.size()) has value CharT() (a null terminator)(since C++11); or, equivalently, a pointer to s[0] can be passed to functions that expect a pointer to the first element of an array(until C++11)a null-terminated array(since C++11) of CharT
.
std::basic_string
satisfies the requirements of AllocatorAwareContainer (except that customized construct
/destroy
are not used for construction/destruction of elements), SequenceContainer and ContiguousContainer(since C++17).
If any of Traits::char_type
and Allocator::value_type
is different from CharT
, the program is ill-formed.
std::basic_string
are constexpr: it is possible to create and use std::basic_string
objects in the evaluation of a constant expression.
However, std::basic_string
objects generally cannot be constexpr, because any dynamically allocated storage must be released in the same evaluation of constant expression.
Several typedefs for common character types are provided:
Type Definitionstd::string
std::basic_string<char> std::wstring
std::basic_string<wchar_t> std::u8string
(C++20) std::basic_string<char8_t> std::u16string
(C++11) std::basic_string<char16_t> std::u32string
(C++11) std::basic_string<char32_t> std::pmr::string
(C++17) std::pmr::basic_string<char> std::pmr::wstring
(C++17) std::pmr::basic_string<wchar_t> std::pmr::u8string
(C++20) std::pmr::basic_string<char8_t> std::pmr::u16string
(C++17) std::pmr::basic_string<char16_t> std::pmr::u32string
(C++17) std::pmr::basic_string<char32_t> [edit] Template parameters CharT - character type Traits - traits class specifying the operations on the character type Allocator - Allocator type used to allocate internal storage [edit] Nested types [edit] Data members constexpr size_type npos
[static] the special value size_type(-1), its exact meaning depends on the context [edit] Member functions constructs a basic_string
basic_string_view
into the entire string
basic_string
References, pointers, and iterators referring to the elements of a basic_string
may be invalidated by any standard library function taking a reference to non-const basic_string
as an argument, such as std::getline, std::swap, or operator>>, and by calling non-const member functions, except operator[], at
, data
, front
, back
, begin
, rbegin
, end
, and rend
.
Although it is required that customized construct
or destroy
is used when constructing or destroying elements of std::basic_string
until C++23, all implementations only used the default mechanism. The requirement is corrected by P1072R10 to match existing practice.
#include <iostream> #include <string> int main() { using namespace std::literals; // Creating a string from const char* std::string str1 = "hello"; // Creating a string using string literal auto str2 = "world"s; // Concatenating strings std::string str3 = str1 + " " + str2; // Print out the result std::cout << str3 << '\n'; std::string::size_type pos = str3.find(" "); str1 = str3.substr(pos + 1); // the part after the space str2 = str3.substr(0, pos); // the part till the space std::cout << str1 << ' ' << str2 << '\n'; // Accessing an element using subscript operator[] std::cout << str1[0] << '\n'; str1[0] = 'W'; std::cout << str1 << '\n'; }
Output:
hello world world hello w World[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR Applied to Behavior as published Correct behavior LWG 530 C++98 contiguity of the storage for elements ofbasic_string
value_type
was Traits::char_type
changed to CharT
LWG 2994
Traits::char_type
[1]
Allocator::char_type
is different from CharT
the program is
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4