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< char >::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 846 of file basic_string.h.
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::capacity(), basic_string::reserve(), and basic_string::size().
basic_string& append | ( | const _CharT * | __s | ) | [inline] |
Append a C string.
s | The C string to append. |
Definition at line 819 of file basic_string.h.
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::capacity(), 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(), basic_string::capacity(), basic_string::reserve(), 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(), basic_string::capacity(), basic_string::reserve(), and basic_string::size().
Referenced by basic_string< char >::append(), collate::do_transform(), std::operator+(), basic_string< char >::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 941 of file basic_string.h.
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 928 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 912 of file basic_string.h.
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 884 of file basic_string.h.
Referenced by basic_string< char >::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 basic_string< char >::assign(), money_get::do_get(), basic_string< char >::operator=(), and basic_string< char >::push_back().
reference at | ( | size_type | __n | ) | [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 742 of file basic_string.h.
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 723 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 basic_string< char >::rend().
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 1517 of file basic_string.h.
Referenced by collate::do_compare(), money_get::do_get(), num_get::do_get(), and collate::do_transform().
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 636 of file basic_string.h.
Referenced by basic_string::append(), basic_string< char >::push_back(), and basic_string::reserve().
void clear | ( | ) | [inline] |
Erases the string, making it empty.
Definition at line 663 of file basic_string.h.
int compare | ( | size_type | __pos, | |
size_type | __n1, | |||
const _CharT * | __s, | |||
size_type | __n2 | |||
) | const [inline] |
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().
int compare | ( | size_type | __pos, | |
size_type | __n1, | |||
const _CharT * | __s | |||
) | const [inline] |
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 basic_string::compare(), basic_string::length(), 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::compare(), 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::compare(), 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 1924 of file basic_string.h.
Referenced by basic_string::compare(), basic_string< char >::compare(), 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.
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 1527 of file basic_string.h.
Referenced by basic_string::compare(), basic_string< char >::compare(), collate::do_compare(), collate::do_transform(), basic_string< char >::find(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_of(), and basic_string< char >::rfind().
bool empty | ( | ) | const [inline] |
Returns true if the string is empty. Equivalent to *this == "".
Definition at line 670 of file basic_string.h.
Referenced by 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.
Referenced by basic_string< char >::rbegin().
iterator erase | ( | iterator | __first, | |
iterator | __last | |||
) | [inline] |
Remove a range of characters.
first | Iterator referencing the first character to remove. | |
last | Iterator referencing the end of the range. |
Definition at line 1151 of file basic_string.h.
iterator erase | ( | iterator | __position | ) | [inline] |
Remove one character.
position | Iterator referencing the character to remove. |
Definition at line 1131 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 1115 of file basic_string.h.
Referenced by 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 basic_string::find(), basic_string::npos, and basic_string::size().
size_type find | ( | const _CharT * | __s, | |
size_type | __pos = 0 | |||
) | const [inline] |
Find position of a C string.
s | C string to locate. | |
pos | Index of character to search from (default 0). |
Definition at line 1576 of file basic_string.h.
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 1562 of file basic_string.h.
Referenced by basic_string< char >::find().
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(), basic_string< char >::find(), basic_string::find_first_of(), and basic_string< char >::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().
size_type find_first_not_of | ( | const _CharT * | __s, | |
size_type | __pos = 0 | |||
) | const [inline] |
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 1815 of file basic_string.h.
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 1786 of file basic_string.h.
Referenced by basic_string< char >::find_first_not_of().
size_type find_first_of | ( | _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). |
Note: equivalent to find(c, pos).
Definition at line 1711 of file basic_string.h.
size_type find_first_of | ( | const _CharT * | __s, | |
size_type | __pos = 0 | |||
) | const [inline] |
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 1692 of file basic_string.h.
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 basic_string::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 1664 of file basic_string.h.
Referenced by basic_string< char >::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().
size_type find_last_not_of | ( | const _CharT * | __s, | |
size_type | __pos = npos | |||
) | const [inline] |
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 1874 of file basic_string.h.
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 1845 of file basic_string.h.
Referenced by basic_string< char >::find_last_not_of().
size_type find_last_of | ( | _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 0). |
Note: equivalent to rfind(c, pos).
Definition at line 1772 of file basic_string.h.
size_type find_last_of | ( | const _CharT * | __s, | |
size_type | __pos = npos | |||
) | const [inline] |
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 1753 of file basic_string.h.
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 1725 of file basic_string.h.
Referenced by basic_string< char >::find_last_of().
allocator_type get_allocator | ( | ) | const [inline] |
Return copy of allocator used to construct this string.
Definition at line 1534 of file basic_string.h.
Referenced by basic_string::assign(), basic_string::reserve(), basic_string::swap(), and basic_string< char >::~basic_string().
iterator insert | ( | iterator | __p, | |
_CharT | __c | |||
) | [inline] |
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 1091 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 1074 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 1051 of file basic_string.h.
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 1010 of file basic_string.h.
Referenced by basic_string< char >::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 988 of file basic_string.h.
Referenced by basic_string< char >::insert().
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 973 of file basic_string.h.
void insert | ( | iterator | __p, | |
size_type | __n, | |||
_CharT | __c | |||
) | [inline] |
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 957 of file basic_string.h.
Referenced by basic_string< char >::insert().
size_type length | ( | ) | const [inline] |
Returns the number of characters in the string, not including any null-termination.
Definition at line 596 of file basic_string.h.
Referenced by basic_string::compare(), collate::do_compare(), and collate::do_transform().
size_type max_size | ( | ) | const [inline] |
Returns the size() of the largest possible string.
Definition at line 601 of file basic_string.h.
Referenced by std::getline(), and std::operator>>().
basic_string& operator+= | ( | _CharT | __c | ) | [inline] |
Append a character.
c | The character to append. |
Definition at line 775 of file basic_string.h.
basic_string& operator+= | ( | const _CharT * | __s | ) | [inline] |
Append a C string.
s | The C string to append. |
Definition at line 766 of file basic_string.h.
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 757 of file basic_string.h.
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.
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.
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.
reference operator[] | ( | size_type | __pos | ) | [inline] |
Subscript access to the data contained in the string.
pos | The index of the character to access. |
Definition at line 702 of file basic_string.h.
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 685 of file basic_string.h.
void push_back | ( | _CharT | __c | ) | [inline] |
Append a single character.
c | Character to append. |
Definition at line 854 of file basic_string.h.
Referenced by collate::do_transform(), basic_string< char >::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 1367 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 1344 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 1323 of file basic_string.h.
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 1302 of file basic_string.h.
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 1284 of file basic_string.h.
Referenced by basic_string< char >::replace().
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 1266 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 1243 of file basic_string.h.
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 1200 of file basic_string.h.
Referenced by basic_string< char >::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 1178 of file basic_string.h.
Referenced by basic_string< char >::append(), basic_string< char >::assign(), basic_string< char >::insert(), and basic_string< char >::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::capacity(), basic_string::get_allocator(), and basic_string::size().
Referenced by basic_string::append(), num_get::do_get(), std::operator>>(), and basic_string< char >::push_back().
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 628 of file basic_string.h.
Referenced by basic_string< char >::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().
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().
size_type rfind | ( | const _CharT * | __s, | |
size_type | __pos = npos | |||
) | const [inline] |
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 1634 of file basic_string.h.
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 1606 of file basic_string.h.
Referenced by basic_string< char >::find_last_of(), and basic_string< char >::rfind().
size_type size | ( | ) | const [inline] |
Returns the number of characters in the string, not including any null-termination.
Definition at line 590 of file basic_string.h.
Referenced by basic_string::append(), basic_string::assign(), basic_string< char >::assign(), basic_string< char >::at(), bitset::bitset(), basic_string< char >::clear(), basic_string::compare(), basic_string< char >::compare(), basic_string< char >::empty(), basic_string< char >::end(), basic_string::find(), basic_string< char >::find(), basic_string::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string::find_first_of(), basic_string< char >::find_first_of(), basic_string::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::insert(), std::operator+(), basic_string< char >::operator[](), basic_string< char >::push_back(), basic_string< char >::replace(), basic_string::reserve(), basic_string::resize(), basic_string::rfind(), and basic_string< char >::rfind().
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 1906 of file basic_string.h.
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 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 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().