explicit basic_string(const Allocator& a = Allocator());
Effects: Constructs an object of class basic_string. The postconditions of this function are indicated in Table [tab:strings.ctr.1].
| Element | Value |
| data() | a non-null pointer that is copyable and can have 0 added to it |
| size() | 0 |
| capacity() | an unspecified value |
basic_string(const basic_string<charT,traits,Allocator>& str);
basic_string(basic_string<charT,traits,Allocator>&& str) noexcept;
Effects: Constructs an object of class basic_string as indicated in Table [tab:strings.ctr.cpy]. In the second form, str is left in a valid state with an unspecified value.
Throws: The second form throws nothing if the allocator's move constructor throws nothing.
| Element | Value |
| data() | points at the first element of an allocated copy of the array whose first element is pointed at by str.data() |
| size() | str.size() |
| capacity() | a value at least as large as size() |
basic_string(const basic_string<charT,traits,Allocator>& str,
size_type pos, size_type n = npos,
const Allocator& a = Allocator());
Requires: pos <= str.size()
Throws: out_of_range if pos > str.size().
Effects: Constructs an object of class basic_string and determines the effective length rlen of the initial string value as the smaller of n and str.size() - pos, as indicated in Table [tab:strings.ctr.2].
| Element | Value |
| data() | points at the first element of an allocated copy of rlen consecutive elements of the string controlled by str beginning at position pos |
| size() | rlen |
| capacity() | a value at least as large as size() |
basic_string(const charT* s, size_type n,
const Allocator& a = Allocator());
Requires: s shall not be a null pointer and n < npos.
Effects: Constructs an object of class basic_string and determines its initial string value from the array of charT of length n whose first element is designated by s, as indicated in Table [tab:strings.ctr.3].
| Element | Value |
| data() | points at the first element of an allocated copy of the array whose first element is pointed at by s |
| size() | n |
| capacity() | a value at least as large as size() |
basic_string(const charT* s, const Allocator& a = Allocator());
Requires: s shall not be a null pointer.
Effects: Constructs an object of class basic_string and determines its initial string value from the array of charT of length traits::length(s) whose first element is designated by s, as indicated in Table [tab:strings.ctr.4].
| Element | Value |
| data() | points at the first element of an allocated copy of the array whose first element is pointed at by s |
| size() | traits::length(s) |
| capacity() | a value at least as large as size() |
basic_string(size_type n, charT c, const Allocator& a = Allocator());
Requires: n < npos
Effects: Constructs an object of class basic_string and determines its initial string value by repeating the char-like object c for all n elements, as indicated in Table [tab:strings.ctr.5].
| Element | Value |
| data() | points at the first element of an allocated array of n elements, each storing the initial value c |
| size() | n |
| capacity() | a value at least as large as size() |
template<class InputIterator>
basic_string(InputIterator begin, InputIterator end,
const Allocator& a = Allocator());
Effects: If InputIterator is an integral type, equivalent to
basic_string(static_cast<size_type>(begin), static_cast<value_type>(end), a)
Otherwise constructs a string from the values in the range [begin, end), as indicated in the Sequence Requirements table (see [sequence.reqmts]).
basic_string(initializer_list<charT> il, const Allocator& a = Allocator());
Effects: Same as basic_string(il.begin(), il.end(), a).
basic_string(const basic_string& str, const Allocator& alloc);
basic_string(basic_string&& str, const Allocator& alloc);
Effects: Constructs an object of class basic_string as indicated in Table [tab:strings.ctr.6]. The stored allocator is constructed from alloc. In the second form, str is left in a valid state with an unspecified value.
| Element | Value |
| data() | points at the first element of an allocated copy of the array whose first element is pointed at by the original value of str.data(). |
| size() | the original value of str.size() |
| capacity() | a value at least as large as size() |
| get_allocator() | alloc |
Throws: The second form throws nothing if alloc == str.get_allocator() unless the copy constructor for Allocator throws.
basic_string<charT,traits,Allocator>&
operator=(const basic_string<charT,traits,Allocator>& str);
Effects: If *this and str are not the same object, modifies *this as shown in Table [tab:strings.op=].
If *this and str are the same object, the member has no effect.
Returns: *this
| Element | Value |
| data() | points at the first element of an allocated copy of the array whose first element is pointed at by str.data() |
| size() | str.size() |
| capacity() | a value at least as large as size() |
basic_string<charT,traits,Allocator>&
operator=(basic_string<charT,traits,Allocator>&& str) noexcept;
Effects: If *this and str are not the same object, modifies *this as shown in Table [tab:strings.op=rv]. [ Note: A valid implementation is swap(str). — end note ]
If *this and str are the same object, the member has no effect.
Returns: *this
| Element | Value |
| data() | points at the array whose first element was pointed at by str.data() |
| size() | previous value of str.size() |
| capacity() | a value at least as large as size() |
basic_string<charT,traits,Allocator>&
operator=(const charT* s);
Returns: *this = basic_string<charT,traits,Allocator>(s).
basic_string<charT,traits,Allocator>& operator=(charT c);
Returns: *this = basic_string<charT,traits,Allocator>(1,c).
basic_string& operator=(initializer_list<charT> il);
Effects: *this = basic_string(il).
Returns: *this.