push_back, at, and array access are supported.
Definition at line 110 of file basic_string.h.
| basic_string | ( | ) | [inline] |
Default constructor creates an empty string.
Definition at line 2050 of file basic_string.h.
Referenced by basic_string::substr().
| basic_string | ( | const _Alloc & | __a | ) | [inline, explicit] |
| basic_string | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str | ) | [inline] |
Construct string with copy of value of str.
| str | Source string. |
Definition at line 182 of file basic_string.tcc.
| basic_string | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos, | |||
| size_type | __n = npos | |||
| ) | [inline] |
Construct string as copy of a substring.
| str | Source string. | |
| pos | Index of first character to copy from. | |
| n | Number of characters to copy (default remainder). |
Definition at line 196 of file basic_string.tcc.
| basic_string | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos, | |||
| size_type | __n, | |||
| const _Alloc & | __a | |||
| ) | [inline] |
Construct string as copy of a substring.
| str | Source string. | |
| pos | Index of first character to copy from. | |
| n | Number of characters to copy. | |
| a | Allocator to use. |
Definition at line 206 of file basic_string.tcc.
| basic_string | ( | const _CharT * | __s, | |
| size_type | __n, | |||
| const _Alloc & | __a = _Alloc() | |||
| ) | [inline] |
Construct string initialized by a character array.
| s | Source character array. | |
| n | Number of characters to copy. | |
| a | Allocator to use (default is default allocator). |
Definition at line 218 of file basic_string.tcc.
| basic_string | ( | const _CharT * | __s, | |
| const _Alloc & | __a = _Alloc() | |||
| ) | [inline] |
Construct string as copy of a C string.
| s | Source C string. | |
| a | Allocator to use (default is default allocator). |
Definition at line 225 of file basic_string.tcc.
| basic_string | ( | size_type | __n, | |
| _CharT | __c, | |||
| const _Alloc & | __a = _Alloc() | |||
| ) | [inline] |
Construct string as multiple characters.
| n | Number of characters. | |
| c | Character to use. | |
| a | Allocator to use (default is default allocator). |
Definition at line 232 of file basic_string.tcc.
| basic_string | ( | _InputIterator | __beg, | |
| _InputIterator | __end, | |||
| const _Alloc & | __a = _Alloc() | |||
| ) | [inline] |
Construct string as copy of a range.
| beg | Start of range. | |
| end | End of range. | |
| a | Allocator to use (default is default allocator). |
Definition at line 240 of file basic_string.tcc.
| ~basic_string | ( | ) | [inline] |
| basic_string& append | ( | _InputIterator | __first, | |
| _InputIterator | __last | |||
| ) | [inline] |
Append a range of characters.
| first | Iterator referencing the first character to append. | |
| last | Iterator marking the end of the range. |
Definition at line 844 of file basic_string.h.
References basic_string::replace().
| basic_string< _CharT, _Traits, _Alloc > & append | ( | size_type | __n, | |
| _CharT | __c | |||
| ) | [inline] |
Append multiple characters.
| n | The number of characters to append. | |
| c | The character to use. |
Definition at line 285 of file basic_string.tcc.
References basic_string::size().
| basic_string& append | ( | const _CharT * | __s | ) | [inline] |
Append a C string.
| s | The C string to append. |
Definition at line 817 of file basic_string.h.
References basic_string::append().
| basic_string< _CharT, _Traits, _Alloc > & append | ( | const _CharT * | __s, | |
| size_type | __n | |||
| ) | [inline] |
Append a C substring.
| s | The C string to append. | |
| n | The number of characters to append. |
Definition at line 302 of file basic_string.tcc.
References basic_string::reserve(), and basic_string::size().
| basic_string< _CharT, _Traits, _Alloc > & append | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos, | |||
| size_type | __n | |||
| ) | [inline] |
Append a substring.
| str | The string to append. | |
| pos | Index of the first character of str to append. | |
| n | The number of characters to append. |
| std::out_of_range | if pos is not a valid index. |
Definition at line 346 of file basic_string.tcc.
References basic_string::_M_check(), basic_string::_M_data(), basic_string::_M_limit(), and basic_string::size().
| basic_string< _CharT, _Traits, _Alloc > & append | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str | ) | [inline] |
Append a string to this string.
| str | The string to append. |
Definition at line 329 of file basic_string.tcc.
References basic_string::_M_data(), and basic_string::size().
Referenced by money_put::_M_insert(), basic_string::append(), collate::do_transform(), std::operator+(), basic_string::operator+=(), std::operator>>(), and basic_string::resize().
| basic_string& assign | ( | _InputIterator | __first, | |
| _InputIterator | __last | |||
| ) | [inline] |
Set value to a range of characters.
| first | Iterator referencing the first character to append. | |
| last | Iterator marking the end of the range. |
Definition at line 939 of file basic_string.h.
References basic_string::replace().
| basic_string& assign | ( | size_type | __n, | |
| _CharT | __c | |||
| ) | [inline] |
Set value to multiple characters.
| n | Length of the resulting string. | |
| c | The character to use. |
Definition at line 926 of file basic_string.h.
| basic_string& assign | ( | const _CharT * | __s | ) | [inline] |
Set value to contents of a C string.
| s | The C string to use. |
Definition at line 910 of file basic_string.h.
References basic_string::assign().
| basic_string< _CharT, _Traits, _Alloc > & assign | ( | const _CharT * | __s, | |
| size_type | __n | |||
| ) | [inline] |
Set value to a C substring.
| s | The C string to use. | |
| n | Number of characters to use. |
Definition at line 263 of file basic_string.tcc.
References basic_string::size().
| basic_string& assign | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos, | |||
| size_type | __n | |||
| ) | [inline] |
Set value to a substring of a string.
| str | The string to use. | |
| pos | Index of the first character of str. | |
| n | Number of characters to use. |
| std::out_of_range | if pos is not a valid index. |
Definition at line 882 of file basic_string.h.
References basic_string::_M_check(), basic_string::_M_data(), basic_string::_M_limit(), and basic_string::assign().
| basic_string< _CharT, _Traits, _Alloc > & assign | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str | ) | [inline] |
Set value to contents of another string.
| str | Source string to use. |
Definition at line 247 of file basic_string.tcc.
References basic_string::_M_rep(), and basic_string::get_allocator().
Referenced by money_put::_M_insert(), basic_string::assign(), money_get::do_get(), basic_string::operator=(), basic_stringbuf::overflow(), and basic_stringbuf::str().
Provides access to the data contained in the string.
| n | The index of the character to access. |
| std::out_of_range | If n is an invalid index. |
Definition at line 740 of file basic_string.h.
References basic_string::size().
| const_reference at | ( | size_type | __n | ) | const [inline] |
Provides access to the data contained in the string.
| n | The index of the character to access. |
| std::out_of_range | If n is an invalid index. |
Definition at line 721 of file basic_string.h.
| const_iterator begin | ( | ) | const [inline] |
Returns a read-only (constant) iterator that points to the first character in the string.
Definition at line 527 of file basic_string.h.
| iterator begin | ( | ) | [inline] |
Returns a read/write iterator that points to the first character in the string. Unshares the string.
Definition at line 516 of file basic_string.h.
Referenced by money_get::_M_extract().
| const _CharT* c_str | ( | ) | const [inline] |
Return const pointer to null-terminated contents.
This is a handle to internal data. Do not modify or dire things may happen.
Definition at line 1515 of file basic_string.h.
Referenced by messages::_M_convert_to_char(), collate::do_compare(), money_get::do_get(), num_get::do_get(), collate::do_transform(), and encoding_state::init().
| size_type capacity | ( | ) | const [inline] |
Returns the total number of characters that the string can hold before needing to allocate more memory.
Definition at line 634 of file basic_string.h.
Referenced by basic_stringbuf::_M_sync(), and basic_stringbuf::overflow().
| void clear | ( | ) | [inline] |
Erases the string, making it empty.
Definition at line 661 of file basic_string.h.
Referenced by num_get::_M_extract_float(), and basic_stringbuf::setbuf().
Compare substring against a character array.
| pos1 | Index of first character of substring. | |
| n1 | Number of characters in substring. | |
| s | character array to compare against. | |
| n2 | Number of characters of s. |
NB: s must have at least n2 characters, '' has no special meaning.
Definition at line 957 of file basic_string.tcc.
References std::min().
Compare substring to a C string.
| pos | Index of first character of substring. | |
| n1 | Number of characters in substring. | |
| s | C string to compare against. |
Definition at line 941 of file basic_string.tcc.
References std::min().
| int compare | ( | const _CharT * | __s | ) | const [inline] |
Compare to a C string.
| s | C string to compare against. |
Definition at line 926 of file basic_string.tcc.
References std::min(), and basic_string::size().
| int compare | ( | size_type | __pos1, | |
| size_type | __n1, | |||
| const basic_string< _CharT, _Traits, _Alloc > & | __str, | |||
| size_type | __pos2, | |||
| size_type | __n2 | |||
| ) | const [inline] |
Compare substring to a substring.
| pos1 | Index of first character of substring. | |
| n1 | Number of characters in substring. | |
| str | String to compare against. | |
| pos2 | Index of first character of substring of str. | |
| n2 | Number of characters in substring of str. |
Definition at line 908 of file basic_string.tcc.
References basic_string::_M_check(), basic_string::_M_limit(), basic_string::data(), and std::min().
| int compare | ( | size_type | __pos, | |
| size_type | __n, | |||
| const basic_string< _CharT, _Traits, _Alloc > & | __str | |||
| ) | const [inline] |
Compare substring to a string.
| pos | Index of first character of substring. | |
| n | Number of characters in substring. | |
| str | String to compare against. |
Definition at line 893 of file basic_string.tcc.
References basic_string::data(), std::min(), and basic_string::size().
| int compare | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str | ) | const [inline] |
Compare to a string.
| str | String to compare against. |
Definition at line 1922 of file basic_string.h.
References basic_string::data(), std::min(), and basic_string::size().
Referenced by std::operator!=(), std::operator<(), std::operator<=(), std::operator==(), std::operator>(), and std::operator>=().
| basic_string< _CharT, _Traits, _Alloc >::size_type copy | ( | _CharT * | __s, | |
| size_type | __n, | |||
| size_type | __pos = 0 | |||
| ) | const [inline] |
Copy substring into C string.
| s | C string to copy value into. | |
| n | Number of characters to copy. | |
| pos | Index of first character to copy. |
| std::out_of_range | If pos > size(). |
Definition at line 704 of file basic_string.tcc.
Referenced by __moneypunct_cache::_M_cache(), and __numpunct_cache::_M_cache().
| const _CharT* data | ( | ) | const [inline] |
Return const pointer to contents.
This is a handle to internal data. Do not modify or dire things may happen.
Definition at line 1525 of file basic_string.h.
Referenced by money_put::_M_insert(), basic_stringbuf::_M_stringbuf_init(), basic_stringbuf::_M_sync(), basic_string::compare(), collate::do_compare(), collate::do_transform(), 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(), locale::operator()(), hash< std::wstring >::operator()(), hash< std::string >::operator()(), basic_stringbuf::overflow(), basic_string::rfind(), and basic_stringbuf::str().
| bool empty | ( | ) | const [inline] |
Returns true if the string is empty. Equivalent to *this == "".
Definition at line 668 of file basic_string.h.
References basic_string::size().
Referenced by money_get::_M_extract(), and std::operator>>().
| const_iterator end | ( | ) | const [inline] |
Returns a read-only (constant) iterator that points one past the last character in the string.
Definition at line 546 of file basic_string.h.
| iterator end | ( | ) | [inline] |
Returns a read/write iterator that points one past the last character in the string. Unshares the string.
Definition at line 535 of file basic_string.h.
Remove a range of characters.
| first | Iterator referencing the first character to remove. | |
| last | Iterator referencing the end of the range. |
Definition at line 1149 of file basic_string.h.
Remove one character.
| position | Iterator referencing the character to remove. |
Definition at line 1129 of file basic_string.h.
| basic_string& erase | ( | size_type | __pos = 0, |
|
| size_type | __n = npos | |||
| ) | [inline] |
Remove characters.
| pos | Index of first character to remove (default 0). | |
| n | Number of characters to remove (default remainder). |
| std::out_of_range | If pos is beyond the end of this string. |
Definition at line 1113 of file basic_string.h.
Referenced by money_get::_M_extract(), std::getline(), std::operator>>(), and basic_string::resize().
| basic_string< _CharT, _Traits, _Alloc >::size_type find | ( | _CharT | __c, | |
| size_type | __pos = 0 | |||
| ) | const [inline] |
Find position of a character.
| c | Character to locate. | |
| pos | Index of character to search from (default 0). |
Definition at line 737 of file basic_string.tcc.
References std::find(), basic_string::npos, and basic_string::size().
Find position of a C string.
| s | C string to locate. | |
| pos | Index of character to search from (default 0). |
Definition at line 1574 of file basic_string.h.
References basic_string::find().
| size_type find | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos = 0 | |||
| ) | const [inline] |
Find position of a string.
| str | String to locate. | |
| pos | Index of character to search from (default 0). |
Definition at line 1560 of file basic_string.h.
References basic_string::data(), basic_string::find(), and basic_string::size().
| basic_string< _CharT, _Traits, _Alloc >::size_type find | ( | const _CharT * | __s, | |
| size_type | __pos, | |||
| size_type | __n | |||
| ) | const [inline] |
Find position of a C substring.
| s | C string to locate. | |
| pos | Index of character to search from. | |
| n | Number of characters from s to search for. |
Definition at line 718 of file basic_string.tcc.
References basic_string::npos, std::search(), and basic_string::size().
Referenced by basic_string::find(), and basic_string::find_first_of().
| basic_string< _CharT, _Traits, _Alloc >::size_type find_first_not_of | ( | _CharT | __c, | |
| size_type | __pos = 0 | |||
| ) | const [inline] |
Find position of a different character.
| c | Character to avoid. | |
| pos | Index of character to search from (default 0). |
Definition at line 841 of file basic_string.tcc.
References basic_string::npos, and basic_string::size().
Find position of a character not in C string.
| s | C string containing characters to avoid. | |
| pos | Index of character to search from (default 0). |
Definition at line 1813 of file basic_string.h.
References basic_string::find_first_not_of().
| basic_string< _CharT, _Traits, _Alloc >::size_type find_first_not_of | ( | const _CharT * | __s, | |
| size_type | __pos, | |||
| size_type | __n | |||
| ) | const [inline] |
Find position of a character not in C substring.
| s | C string containing characters to avoid. | |
| pos | Index of character to search from (default 0). | |
| n | Number of characters from s to consider. |
Definition at line 829 of file basic_string.tcc.
References std::find(), basic_string::npos, and basic_string::size().
| size_type find_first_not_of | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos = 0 | |||
| ) | const [inline] |
Find position of a character not in string.
| str | String containing characters to avoid. | |
| pos | Index of character to search from (default 0). |
Definition at line 1784 of file basic_string.h.
References basic_string::data(), and basic_string::size().
Referenced by money_get::_M_extract(), and basic_string::find_first_not_of().
Find position of a character.
| c | Character to locate. | |
| pos | Index of character to search from (default 0). |
Note: equivalent to find(c, pos).
Definition at line 1709 of file basic_string.h.
References basic_string::find().
Find position of a character of C string.
| s | String containing characters to locate. | |
| pos | Index of character to search from (default 0). |
Definition at line 1690 of file basic_string.h.
References basic_string::find_first_of().
| basic_string< _CharT, _Traits, _Alloc >::size_type find_first_of | ( | const _CharT * | __s, | |
| size_type | __pos, | |||
| size_type | __n | |||
| ) | const [inline] |
Find position of a character of C substring.
| s | String containing characters to locate. | |
| pos | Index of character to search from (default 0). | |
| n | Number of characters from s to search for. |
Definition at line 793 of file basic_string.tcc.
References std::find(), basic_string::npos, and basic_string::size().
| size_type find_first_of | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos = 0 | |||
| ) | const [inline] |
Find position of a character of string.
| str | String containing characters to locate. | |
| pos | Index of character to search from (default 0). |
Definition at line 1662 of file basic_string.h.
References basic_string::data(), and basic_string::size().
Referenced by basic_string::find_first_of().
| basic_string< _CharT, _Traits, _Alloc >::size_type find_last_not_of | ( | _CharT | __c, | |
| size_type | __pos = npos | |||
| ) | const [inline] |
Find last position of a different character.
| c | Character to avoid. | |
| pos | Index of character to search from (default 0). |
Definition at line 873 of file basic_string.tcc.
References basic_string::npos, and basic_string::size().
Find position of a character not in C string.
| s | C string containing characters to avoid. | |
| pos | Index of character to search from (default 0). |
Definition at line 1872 of file basic_string.h.
References basic_string::find_last_not_of().
| basic_string< _CharT, _Traits, _Alloc >::size_type find_last_not_of | ( | const _CharT * | __s, | |
| size_type | __pos, | |||
| size_type | __n | |||
| ) | const [inline] |
Find last position of a character not in C substring.
| s | C string containing characters to avoid. | |
| pos | Index of character to search from (default 0). | |
| n | Number of characters from s to consider. |
Definition at line 852 of file basic_string.tcc.
References std::find(), basic_string::npos, and basic_string::size().
| size_type find_last_not_of | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos = npos | |||
| ) | const [inline] |
Find last position of a character not in string.
| str | String containing characters to avoid. | |
| pos | Index of character to search from (default 0). |
Definition at line 1843 of file basic_string.h.
References basic_string::data(), and basic_string::size().
Referenced by basic_string::find_last_not_of().
Find last position of a character.
| c | Character to locate. | |
| pos | Index of character to search back from (default 0). |
Note: equivalent to rfind(c, pos).
Definition at line 1770 of file basic_string.h.
References basic_string::rfind().
Find last position of a character of C string.
| s | C string containing characters to locate. | |
| pos | Index of character to search back from (default end). |
Definition at line 1751 of file basic_string.h.
References basic_string::find_last_of().
| basic_string< _CharT, _Traits, _Alloc >::size_type find_last_of | ( | const _CharT * | __s, | |
| size_type | __pos, | |||
| size_type | __n | |||
| ) | const [inline] |
Find last position of a character of C substring.
| s | C string containing characters to locate. | |
| pos | Index of character to search back from (default end). | |
| n | Number of characters from s to search for. |
Definition at line 808 of file basic_string.tcc.
References std::find(), basic_string::npos, and basic_string::size().
| size_type find_last_of | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos = npos | |||
| ) | const [inline] |
Find last position of a character of string.
| str | String containing characters to locate. | |
| pos | Index of character to search back from (default end). |
Definition at line 1723 of file basic_string.h.
References basic_string::data(), and basic_string::size().
Referenced by basic_string::find_last_of().
| allocator_type get_allocator | ( | ) | const [inline] |
Return copy of allocator used to construct this string.
Definition at line 1532 of file basic_string.h.
Referenced by basic_string::assign(), basic_string::reserve(), and basic_string::swap().
Insert one character.
| p | Iterator referencing position in string to insert at. | |
| c | The character to insert. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1089 of file basic_string.h.
| basic_string& insert | ( | size_type | __pos, | |
| size_type | __n, | |||
| _CharT | __c | |||
| ) | [inline] |
Insert multiple characters.
| pos | Index in string to insert at. | |
| n | Number of characters to insert | |
| c | The character to insert. |
| std::length_error | If new length exceeds max_size(). | |
| std::out_of_range | If pos is beyond the end of this string. |
Definition at line 1072 of file basic_string.h.
| basic_string& insert | ( | size_type | __pos, | |
| const _CharT * | __s | |||
| ) | [inline] |
Insert a C string.
| pos | Iterator referencing location in string to insert at. | |
| s | The C string to insert. |
| std::length_error | If new length exceeds max_size(). | |
| std::out_of_range | If pos is beyond the end of this string. |
Definition at line 1049 of file basic_string.h.
References basic_string::insert().
| basic_string< _CharT, _Traits, _Alloc > & insert | ( | size_type | __pos, | |
| const _CharT * | __s, | |||
| size_type | __n | |||
| ) | [inline] |
Insert a C substring.
| pos | Iterator referencing location in string to insert at. | |
| s | The C string to insert. | |
| n | The number of characters to insert. |
| std::length_error | If new length exceeds max_size(). | |
| std::out_of_range | If pos is beyond the end of this string. |
Definition at line 364 of file basic_string.tcc.
| basic_string& insert | ( | size_type | __pos1, | |
| const basic_string< _CharT, _Traits, _Alloc > & | __str, | |||
| size_type | __pos2, | |||
| size_type | __n | |||
| ) | [inline] |
Insert a substring.
| pos1 | Iterator referencing location in string to insert at. | |
| str | The string to insert. | |
| pos2 | Start of characters in str to insert. | |
| n | Number of characters to insert. |
| std::length_error | If new length exceeds max_size(). | |
| std::out_of_range | If pos1 > size() or pos2 > str.size(). |
Definition at line 1008 of file basic_string.h.
References basic_string::_M_check(), basic_string::_M_data(), basic_string::_M_limit(), and basic_string::insert().
| basic_string& insert | ( | size_type | __pos1, | |
| const basic_string< _CharT, _Traits, _Alloc > & | __str | |||
| ) | [inline] |
Insert value of a string.
| pos1 | Iterator referencing location in string to insert at. | |
| str | The string to insert. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 986 of file basic_string.h.
References basic_string::insert(), and basic_string::size().
| void insert | ( | iterator | __p, | |
| _InputIterator | __beg, | |||
| _InputIterator | __end | |||
| ) | [inline] |
Insert a range of characters.
| p | Iterator referencing location in string to insert at. | |
| beg | Start of range. | |
| end | End of range. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 971 of file basic_string.h.
References basic_string::replace().
Insert multiple characters.
| p | Iterator referencing location in string to insert at. | |
| n | Number of characters to insert | |
| c | The character to insert. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 955 of file basic_string.h.
References basic_string::replace().
Referenced by money_get::_M_extract(), money_put::_M_insert(), and basic_string::insert().
| size_type length | ( | ) | const [inline] |
Returns the number of characters in the string, not including any null-termination.
Definition at line 594 of file basic_string.h.
Referenced by collate::do_compare(), collate::do_transform(), locale::operator()(), hash< std::wstring >::operator()(), and hash< std::string >::operator()().
| size_type max_size | ( | ) | const [inline] |
Returns the size() of the largest possible string.
Definition at line 599 of file basic_string.h.
Referenced by std::getline(), std::operator>>(), and basic_stringbuf::overflow().
| basic_string& operator+= | ( | _CharT | __c | ) | [inline] |
Append a character.
| c | The character to append. |
Definition at line 773 of file basic_string.h.
References basic_string::push_back().
| basic_string& operator+= | ( | const _CharT * | __s | ) | [inline] |
Append a C string.
| s | The C string to append. |
Definition at line 764 of file basic_string.h.
References basic_string::append().
| basic_string& operator+= | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str | ) | [inline] |
Append a string to this string.
| str | The string to append. |
Definition at line 755 of file basic_string.h.
References basic_string::append().
| basic_string& operator= | ( | _CharT | __c | ) | [inline] |
Set value to string of length 1.
| c | Source character. |
Definition at line 504 of file basic_string.h.
References basic_string::assign().
| basic_string& operator= | ( | const _CharT * | __s | ) | [inline] |
Copy contents of s into this string.
| s | Source null-terminated string. |
Definition at line 493 of file basic_string.h.
References basic_string::assign().
| basic_string& operator= | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str | ) | [inline] |
Assign the value of str to this string.
| str | Source string. |
Definition at line 485 of file basic_string.h.
References basic_string::assign().
Subscript access to the data contained in the string.
| pos | The index of the character to access. |
Definition at line 700 of file basic_string.h.
References basic_string::size().
| const_reference operator[] | ( | size_type | __pos | ) | const [inline] |
Subscript access to the data contained in the string.
| pos | The index of the character to access. |
Definition at line 683 of file basic_string.h.
References basic_string::size().
| void push_back | ( | _CharT | __c | ) | [inline] |
Append a single character.
| c | Character to append. |
Definition at line 852 of file basic_string.h.
References basic_string::size().
Referenced by collate::do_transform(), basic_string::operator+=(), and std::operator>>().
| const_reverse_iterator rbegin | ( | ) | const [inline] |
Returns a read-only (constant) reverse iterator that points to the last character in the string. Iteration is done in reverse element order.
Definition at line 564 of file basic_string.h.
| reverse_iterator rbegin | ( | ) | [inline] |
Returns a read/write reverse iterator that points to the last character in the string. Iteration is done in reverse element order. Unshares the string.
Definition at line 555 of file basic_string.h.
| const_reverse_iterator rend | ( | ) | const [inline] |
Returns a read-only (constant) reverse iterator that points to one before the first character in the string. Iteration is done in reverse element order.
Definition at line 582 of file basic_string.h.
| reverse_iterator rend | ( | ) | [inline] |
Returns a read/write reverse iterator that points to one before the first character in the string. Iteration is done in reverse element order. Unshares the string.
Definition at line 573 of file basic_string.h.
| basic_string& replace | ( | iterator | __i1, | |
| iterator | __i2, | |||
| _InputIterator | __k1, | |||
| _InputIterator | __k2 | |||
| ) | [inline] |
Replace range of characters with range.
| i1 | Iterator referencing start of range to replace. | |
| i2 | Iterator referencing end of range to replace. | |
| k1 | Iterator referencing start of range to insert. | |
| k2 | Iterator referencing end of range to insert. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1365 of file basic_string.h.
| basic_string& replace | ( | iterator | __i1, | |
| iterator | __i2, | |||
| size_type | __n, | |||
| _CharT | __c | |||
| ) | [inline] |
Replace range of characters with multiple characters.
| i1 | Iterator referencing start of range to replace. | |
| i2 | Iterator referencing end of range to replace. | |
| n | Number of characters to insert. | |
| c | Character to insert. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1342 of file basic_string.h.
| basic_string& replace | ( | iterator | __i1, | |
| iterator | __i2, | |||
| const _CharT * | __s | |||
| ) | [inline] |
Replace range of characters with C string.
| i1 | Iterator referencing start of range to replace. | |
| i2 | Iterator referencing end of range to replace. | |
| s | C string value to insert. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1321 of file basic_string.h.
References basic_string::replace().
| basic_string& replace | ( | iterator | __i1, | |
| iterator | __i2, | |||
| const _CharT * | __s, | |||
| size_type | __n | |||
| ) | [inline] |
Replace range of characters with C substring.
| i1 | Iterator referencing start of range to replace. | |
| i2 | Iterator referencing end of range to replace. | |
| s | C string value to insert. | |
| n | Number of characters from s to insert. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1300 of file basic_string.h.
References basic_string::replace().
| basic_string& replace | ( | iterator | __i1, | |
| iterator | __i2, | |||
| const basic_string< _CharT, _Traits, _Alloc > & | __str | |||
| ) | [inline] |
Replace range of characters with string.
| i1 | Iterator referencing start of range to replace. | |
| i2 | Iterator referencing end of range to replace. | |
| str | String value to insert. |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1282 of file basic_string.h.
References basic_string::_M_data(), basic_string::replace(), and basic_string::size().
| basic_string& replace | ( | size_type | __pos, | |
| size_type | __n1, | |||
| size_type | __n2, | |||
| _CharT | __c | |||
| ) | [inline] |
Replace characters with multiple characters.
| pos | Index of first character to replace. | |
| n1 | Number of characters to be replaced. | |
| n2 | Number of characters to insert. | |
| c | Character to insert. |
| std::out_of_range | If pos > size(). | |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1264 of file basic_string.h.
| basic_string& replace | ( | size_type | __pos, | |
| size_type | __n1, | |||
| const _CharT * | __s | |||
| ) | [inline] |
Replace characters with value of a C string.
| pos | Index of first character to replace. | |
| n1 | Number of characters to be replaced. | |
| s | C string to insert. |
| std::out_of_range | If pos > size(). | |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1241 of file basic_string.h.
References basic_string::replace().
| basic_string< _CharT, _Traits, _Alloc > & replace | ( | size_type | __pos, | |
| size_type | __n1, | |||
| const _CharT * | __s, | |||
| size_type | __n2 | |||
| ) | [inline] |
Replace characters with value of a C substring.
| pos | Index of first character to replace. | |
| n1 | Number of characters to be replaced. | |
| s | C string to insert. | |
| n2 | Number of characters from s to use. |
| std::out_of_range | If pos1 > size(). | |
| std::length_error | If new length exceeds max_size(). |
Definition at line 395 of file basic_string.tcc.
References basic_string::_M_data().
| basic_string& replace | ( | size_type | __pos1, | |
| size_type | __n1, | |||
| const basic_string< _CharT, _Traits, _Alloc > & | __str, | |||
| size_type | __pos2, | |||
| size_type | __n2 | |||
| ) | [inline] |
Replace characters with value from another string.
| pos1 | Index of first character to replace. | |
| n1 | Number of characters to be replaced. | |
| str | String to insert. | |
| pos2 | Index of first character of str to use. | |
| n2 | Number of characters from str to use. |
| std::out_of_range | If pos1 > size() or pos2 > str.size(). | |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1198 of file basic_string.h.
References basic_string::_M_check(), basic_string::_M_data(), basic_string::_M_limit(), and basic_string::replace().
| basic_string& replace | ( | size_type | __pos, | |
| size_type | __n, | |||
| const basic_string< _CharT, _Traits, _Alloc > & | __str | |||
| ) | [inline] |
Replace characters with value from another string.
| pos | Index of first character to replace. | |
| n | Number of characters to be replaced. | |
| str | String to insert. |
| std::out_of_range | If pos is beyond the end of this string. | |
| std::length_error | If new length exceeds max_size(). |
Definition at line 1176 of file basic_string.h.
References basic_string::_M_data(), and basic_string::size().
Referenced by basic_string::append(), basic_string::assign(), basic_string::insert(), and basic_string::replace().
| void reserve | ( | size_type | __res_arg = 0 |
) | [inline] |
Attempt to preallocate enough memory for specified number of characters.
| res_arg | Number of characters required. |
| std::length_error | If res_arg exceeds max_size(). |
The advantage of this function is that if optimal code is a necessity and the user can determine the string length that will be required, the user can reserve the memory in advance, and thus prevent a possible reallocation of memory and copying of string data.
Definition at line 483 of file basic_string.tcc.
References basic_string::get_allocator(), and basic_string::size().
Referenced by money_get::_M_extract(), num_get::_M_extract_float(), num_get::_M_extract_int(), money_put::_M_insert(), basic_string::append(), num_get::do_get(), std::operator>>(), and basic_stringbuf::overflow().
| void resize | ( | size_type | __n | ) | [inline] |
Resizes the string to the specified number of characters.
| n | Number of characters the string should contain. |
Definition at line 626 of file basic_string.h.
References basic_string::resize().
| void resize | ( | size_type | __n, | |
| _CharT | __c | |||
| ) | [inline] |
Resizes the string to the specified number of characters.
| n | Number of characters the string should contain. | |
| c | Character to fill any new elements. |
Definition at line 621 of file basic_string.tcc.
References basic_string::append(), basic_string::erase(), and basic_string::size().
Referenced by basic_string::resize().
| basic_string< _CharT, _Traits, _Alloc >::size_type rfind | ( | _CharT | __c, | |
| size_type | __pos = npos | |||
| ) | const [inline] |
Find last position of a character.
| c | Character to locate. | |
| pos | Index of character to search back from (default end). |
Definition at line 776 of file basic_string.tcc.
References basic_string::npos, and basic_string::size().
Find last position of a C string.
| s | C string to locate. | |
| pos | Index of character to start search at (default end). |
Definition at line 1632 of file basic_string.h.
References basic_string::rfind().
| basic_string< _CharT, _Traits, _Alloc >::size_type rfind | ( | const _CharT * | __s, | |
| size_type | __pos, | |||
| size_type | __n | |||
| ) | const [inline] |
Find last position of a C substring.
| s | C string to locate. | |
| pos | Index of character to search back from. | |
| n | Number of characters from s to search for. |
Definition at line 755 of file basic_string.tcc.
References std::min(), basic_string::npos, and basic_string::size().
| size_type rfind | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str, | |
| size_type | __pos = npos | |||
| ) | const [inline] |
Find last position of a string.
| str | String to locate. | |
| pos | Index of character to search back from (default end). |
Definition at line 1604 of file basic_string.h.
References basic_string::data(), and basic_string::size().
Referenced by basic_string::find_last_of(), and basic_string::rfind().
| size_type size | ( | ) | const [inline] |
Returns the number of characters in the string, not including any null-termination.
Definition at line 589 of file basic_string.h.
Referenced by __moneypunct_cache::_M_cache(), __numpunct_cache::_M_cache(), money_get::_M_extract(), num_get::_M_extract_float(), num_get::_M_extract_int(), money_put::_M_insert(), basic_stringbuf::_M_stringbuf_init(), basic_stringbuf::_M_sync(), basic_string::append(), basic_string::assign(), basic_string::at(), bitset::bitset(), basic_string::compare(), basic_string::empty(), 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(), encoding_state::init(), basic_string::insert(), std::operator+(), basic_string::operator[](), basic_string::push_back(), basic_string::replace(), basic_string::reserve(), basic_string::resize(), basic_string::rfind(), and basic_stringbuf::str().
| basic_string substr | ( | size_type | __pos = 0, |
|
| size_type | __n = npos | |||
| ) | const [inline] |
Get a substring.
| pos | Index of first character (default 0). | |
| n | Number of characters in substring (default remainder). |
| std::out_of_range | If pos > size(). |
Definition at line 1904 of file basic_string.h.
References basic_string::basic_string().
| void swap | ( | basic_string< _CharT, _Traits, _Alloc > & | __s | ) | [inline] |
Swap contents with another string.
| s | String to swap with. |
Definition at line 500 of file basic_string.tcc.
References basic_string::_M_data(), basic_string::_M_ibegin(), basic_string::_M_iend(), basic_string::_M_rep(), and basic_string::get_allocator().
Referenced by money_get::_M_extract(), basic_stringbuf::overflow(), and std::swap().
const basic_string< _CharT, _Traits, _Alloc >::size_type npos [inline, static] |
Value returned by various member functions when they fail.
Definition at line 267 of file basic_string.h.
Referenced by money_get::_M_extract(), 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(), and basic_string::rfind().
1.5.3