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 2045 of file basic_string.h.
Referenced by basic_string::substr().
basic_string | ( | const _Alloc & | __a | ) | [explicit] |
basic_string | ( | const basic_string< _CharT, _Traits, _Alloc > & | __str | ) |
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 | |||
) |
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 | |||
) |
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() | |||
) |
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() | |||
) |
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() | |||
) |
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() | |||
) |
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 841 of file basic_string.h.
References basic_string::replace().
basic_string< _CharT, _Traits, _Alloc > & append | ( | size_type | __n, | |
_CharT | __c | |||
) |
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 814 of file basic_string.h.
References basic_string::append().
basic_string< _CharT, _Traits, _Alloc > & append | ( | const _CharT * | __s, | |
size_type | __n | |||
) |
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 | |||
) |
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 | ) |
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 936 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 923 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 907 of file basic_string.h.
References basic_string::assign().
basic_string< _CharT, _Traits, _Alloc > & assign | ( | const _CharT * | __s, | |
size_type | __n | |||
) |
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.
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 879 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 | ) |
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(), basic_stringbuf::setbuf(), 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 737 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 718 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 522 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 511 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 1512 of file basic_string.h.
Referenced by messages::_M_convert_to_char(), 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 631 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 658 of file basic_string.h.
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 949 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 933 of file basic_string.tcc.
References std::min().
int compare | ( | const _CharT * | __s | ) | const |
Compare to a C string.
s | C string to compare against. |
Definition at line 918 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 |
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 900 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 |
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 885 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 1919 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 |
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 696 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 1522 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_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 665 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 541 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 530 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 1146 of file basic_string.h.
Remove one character.
position | Iterator referencing the character to remove. |
Definition at line 1126 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 1110 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 |
Find position of a character.
c | Character to locate. | |
pos | Index of character to search from (default 0). |
Definition at line 729 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 1571 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 1557 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 |
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 710 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 |
Find position of a different character.
c | Character to avoid. | |
pos | Index of character to search from (default 0). |
Definition at line 833 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 1810 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 |
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 821 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 1781 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 1706 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 1687 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 |
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 785 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 1659 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 |
Find last position of a different character.
c | Character to avoid. | |
pos | Index of character to search from (default 0). |
Definition at line 865 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 1869 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 |
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 844 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 1840 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 1767 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 1748 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 |
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 800 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 1720 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 1529 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 1086 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 1069 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 1046 of file basic_string.h.
References basic_string::insert().
basic_string< _CharT, _Traits, _Alloc > & insert | ( | size_type | __pos, | |
const _CharT * | __s, | |||
size_type | __n | |||
) |
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 1005 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 983 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 968 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 952 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] |
null-termination.
Definition at line 591 of file basic_string.h.
Referenced by 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 596 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 770 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 761 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 752 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 499 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 488 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 480 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 697 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 680 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 849 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 559 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 550 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 577 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 568 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 1362 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 1339 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 1318 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 1297 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 1279 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 1261 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 1238 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 | |||
) |
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 1195 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 1173 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 |
) |
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 623 of file basic_string.h.
References basic_string::resize().
void resize | ( | size_type | __n, | |
_CharT | __c | |||
) |
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 613 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 |
Find last position of a character.
c | Character to locate. | |
pos | Index of character to search back from (default 0). |
Definition at line 768 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 0). |
Definition at line 1629 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 |
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 747 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 1601 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] |
null-termination.
Definition at line 585 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::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 1901 of file basic_string.h.
References basic_string::basic_string().
void swap | ( | basic_string< _CharT, _Traits, _Alloc > & | __s | ) |
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 [static] |
Value returned by various member functions when they fail.
Definition at line 262 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().