Inherits _Base< _CharT, _Traits, _Alloc >.
Definition at line 53 of file vstring.h.
__versa_string | ( | ) | [inline] |
Default constructor creates an empty string.
Definition at line 133 of file vstring.h.
Referenced by __versa_string::substr().
__versa_string | ( | const _Alloc & | __a | ) | [inline, explicit] |
__versa_string | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __str | ) | [inline] |
__versa_string | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __str, | |
size_type | __pos, | |||
size_type | __n = npos | |||
) | [inline] |
__versa_string | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __str, | |
size_type | __pos, | |||
size_type | __n, | |||
const _Alloc & | __a | |||
) | [inline] |
__versa_string | ( | const _CharT * | __s, | |
size_type | __n, | |||
const _Alloc & | __a = _Alloc() | |||
) | [inline] |
__versa_string | ( | const _CharT * | __s, | |
const _Alloc & | __a = _Alloc() | |||
) | [inline] |
__versa_string | ( | size_type | __n, | |
_CharT | __c, | |||
const _Alloc & | __a = _Alloc() | |||
) | [inline] |
__versa_string | ( | _InputIterator | __beg, | |
_InputIterator | __end, | |||
const _Alloc & | __a = _Alloc() | |||
) | [inline] |
~__versa_string | ( | ) | [inline] |
__versa_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 606 of file vstring.h.
References __versa_string::replace().
__versa_string& 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 593 of file vstring.h.
References __versa_string::size().
__versa_string& append | ( | const _CharT * | __s | ) | [inline] |
Append a C string.
s | The C string to append. |
Definition at line 576 of file vstring.h.
References __versa_string::length().
__versa_string& append | ( | const _CharT * | __s, | |
size_type | __n | |||
) | [inline] |
__versa_string& append | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 551 of file vstring.h.
References __versa_string::_M_check(), and __versa_string::_M_limit().
__versa_string& append | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __str | ) | [inline] |
Append a string to this string.
str | The string to append. |
Definition at line 535 of file vstring.h.
References __versa_string::size().
Referenced by std::getline(), __gnu_cxx::operator+(), __versa_string::operator+=(), and __versa_string::resize().
__versa_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 710 of file vstring.h.
References __versa_string::replace().
__versa_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 697 of file vstring.h.
References __versa_string::size().
__versa_string& assign | ( | const _CharT * | __s | ) | [inline] |
Set value to contents of a C string.
s | The C string to use. |
Definition at line 680 of file vstring.h.
References __versa_string::size().
__versa_string& 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 664 of file vstring.h.
References __versa_string::size().
__versa_string& assign | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 648 of file vstring.h.
References __versa_string::_M_check(), __versa_string::_M_limit(), and __versa_string::size().
__versa_string& assign | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __str | ) | [inline] |
Set value to contents of another string.
str | Source string to use. |
Definition at line 629 of file vstring.h.
Referenced by __versa_string::operator=(), and __versa_string::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 490 of file vstring.h.
References __versa_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 471 of file vstring.h.
References __versa_string::size().
const_iterator begin | ( | ) | const [inline] |
iterator begin | ( | ) | [inline] |
Returns a read/write iterator that points to the first character in the string. Unshares the string.
Definition at line 263 of file vstring.h.
Referenced by __versa_string::rend().
const _CharT* c_str | ( | ) | const [inline] |
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 383 of file vstring.h.
Referenced by __versa_string::push_back().
void clear | ( | ) | [inline] |
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 526 of file vstring.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 509 of file vstring.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 493 of file vstring.tcc.
References __versa_string::compare(), __versa_string::length(), std::min(), and __versa_string::size().
int compare | ( | size_type | __pos1, | |
size_type | __n1, | |||
const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 474 of file vstring.tcc.
References __versa_string::_M_check(), __versa_string::_M_limit(), __versa_string::compare(), __versa_string::data(), and std::min().
int compare | ( | size_type | __pos, | |
size_type | __n, | |||
const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 457 of file vstring.tcc.
References __versa_string::compare(), __versa_string::data(), std::min(), and __versa_string::size().
int compare | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __str | ) | const [inline] |
Compare to a string.
str | String to compare against. |
Definition at line 1669 of file vstring.h.
References __versa_string::data(), std::min(), and __versa_string::size().
Referenced by __versa_string::compare(), __gnu_cxx::operator!=(), __gnu_cxx::operator<(), __gnu_cxx::operator<=(), __gnu_cxx::operator==(), __gnu_cxx::operator>(), and __gnu_cxx::operator>=().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 256 of file vstring.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 1269 of file vstring.h.
Referenced by __versa_string::compare(), __versa_string::find(), __versa_string::find_first_not_of(), __versa_string::find_first_of(), __versa_string::find_last_not_of(), __versa_string::find_last_of(), and __versa_string::rfind().
bool empty | ( | ) | const [inline] |
Returns true if the string is empty. Equivalent to *this == "".
Definition at line 418 of file vstring.h.
References __versa_string::size().
const_iterator end | ( | ) | const [inline] |
Returns a read-only (constant) iterator that points one past the last character in the string.
Definition at line 293 of file vstring.h.
References __versa_string::size().
iterator end | ( | ) | [inline] |
Returns a read/write iterator that points one past the last character in the string. Unshares the string.
Definition at line 282 of file vstring.h.
References __versa_string::size().
Referenced by __versa_string::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. |
iterator erase | ( | iterator | __position | ) | [inline] |
__versa_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 887 of file vstring.h.
Referenced by std::getline().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 291 of file vstring.tcc.
References __versa_string::find(), __versa_string::npos, and __versa_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 1318 of file vstring.h.
References __versa_string::find().
size_type find | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 1304 of file vstring.h.
References __versa_string::data(), __versa_string::find(), and __versa_string::size().
Referenced by __versa_string::find().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 271 of file vstring.tcc.
References __versa_string::npos, std::search(), and __versa_string::size().
Referenced by __versa_string::find(), and __versa_string::find_first_of().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 402 of file vstring.tcc.
References __versa_string::npos, and __versa_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 1557 of file vstring.h.
References __versa_string::find_first_not_of().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 389 of file vstring.tcc.
References std::find(), __versa_string::npos, and __versa_string::size().
size_type find_first_not_of | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 1528 of file vstring.h.
References __versa_string::data(), __versa_string::find_first_not_of(), and __versa_string::size().
Referenced by __versa_string::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 1453 of file vstring.h.
References __versa_string::find().
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 1434 of file vstring.h.
References __versa_string::find_first_of().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 350 of file vstring.tcc.
References __versa_string::find(), __versa_string::npos, and __versa_string::size().
size_type find_first_of | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 1406 of file vstring.h.
References __versa_string::data(), __versa_string::find_first_of(), and __versa_string::size().
Referenced by __versa_string::find_first_of().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 436 of file vstring.tcc.
References __versa_string::npos, and __versa_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 1617 of file vstring.h.
References __versa_string::find_last_not_of().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 414 of file vstring.tcc.
References std::find(), __versa_string::npos, and __versa_string::size().
size_type find_last_not_of | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 1587 of file vstring.h.
References __versa_string::data(), __versa_string::find_last_not_of(), and __versa_string::size().
Referenced by __versa_string::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 1514 of file vstring.h.
References __versa_string::rfind().
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 1495 of file vstring.h.
References __versa_string::find_last_of().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 367 of file vstring.tcc.
References std::find(), __versa_string::npos, and __versa_string::size().
size_type find_last_of | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 1467 of file vstring.h.
References __versa_string::data(), __versa_string::find_last_of(), and __versa_string::size().
Referenced by __versa_string::find_last_of().
allocator_type get_allocator | ( | ) | const [inline] |
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() . |
__versa_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. |
__versa_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 822 of file vstring.h.
References __versa_string::replace().
__versa_string& 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 803 of file vstring.h.
References __versa_string::replace().
__versa_string& insert | ( | size_type | __pos1, | |
const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 780 of file vstring.h.
References __versa_string::_M_check(), __versa_string::_M_limit(), and __versa_string::replace().
__versa_string& insert | ( | size_type | __pos1, | |
const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 757 of file vstring.h.
References __versa_string::replace(), and __versa_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 742 of file vstring.h.
References __versa_string::replace().
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 726 of file vstring.h.
References __versa_string::replace().
size_type length | ( | ) | const [inline] |
Returns the number of characters in the string, not including any null-termination.
Definition at line 343 of file vstring.h.
Referenced by __versa_string::append(), and __versa_string::compare().
size_type max_size | ( | ) | const [inline] |
Returns the size() of the largest possible string.
Definition at line 348 of file vstring.h.
Referenced by std::getline().
__versa_string& operator+= | ( | _CharT | __c | ) | [inline] |
Append a character.
c | The character to append. |
Definition at line 523 of file vstring.h.
References __versa_string::push_back().
__versa_string& operator+= | ( | const _CharT * | __s | ) | [inline] |
Append a C string.
s | The C string to append. |
Definition at line 514 of file vstring.h.
References __versa_string::append().
__versa_string& operator+= | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __str | ) | [inline] |
Append a string to this string.
str | The string to append. |
Definition at line 505 of file vstring.h.
References __versa_string::append().
__versa_string& operator= | ( | _CharT | __c | ) | [inline] |
Set value to string of length 1.
c | Source character. |
Definition at line 251 of file vstring.h.
References __versa_string::assign().
__versa_string& operator= | ( | const _CharT * | __s | ) | [inline] |
Copy contents of s into this string.
s | Source null-terminated string. |
Definition at line 240 of file vstring.h.
References __versa_string::assign().
__versa_string& operator= | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __str | ) | [inline] |
Assign the value of str to this string.
str | Source string. |
Definition at line 232 of file vstring.h.
References __versa_string::assign().
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 450 of file vstring.h.
References __versa_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 433 of file vstring.h.
References __versa_string::size().
void push_back | ( | _CharT | __c | ) | [inline] |
Append a single character.
c | Character to append. |
Definition at line 614 of file vstring.h.
References __versa_string::assign(), __versa_string::capacity(), and __versa_string::size().
Referenced by __gnu_cxx::operator+(), and __versa_string::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 311 of file vstring.h.
References __versa_string::end().
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 302 of file vstring.h.
References __versa_string::end().
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 329 of file vstring.h.
References __versa_string::begin().
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 320 of file vstring.h.
References __versa_string::begin().
__versa_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() . |
__versa_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() . |
__versa_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 1103 of file vstring.h.
References __versa_string::replace().
__versa_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 1082 of file vstring.h.
References __versa_string::replace().
__versa_string& replace | ( | iterator | __i1, | |
iterator | __i2, | |||
const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 1064 of file vstring.h.
References __versa_string::replace(), and __versa_string::size().
Referenced by __versa_string::replace().
__versa_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() . |
__versa_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 1023 of file vstring.h.
References __versa_string::replace().
__versa_string& 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() . |
__versa_string& replace | ( | size_type | __pos1, | |
size_type | __n1, | |||
const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 972 of file vstring.h.
References __versa_string::_M_check(), __versa_string::_M_limit(), and __versa_string::replace().
__versa_string& replace | ( | size_type | __pos, | |
size_type | __n, | |||
const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 950 of file vstring.h.
References __versa_string::replace(), and __versa_string::size().
Referenced by __versa_string::append(), __versa_string::assign(), __versa_string::insert(), and __versa_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 404 of file vstring.h.
Referenced by __gnu_cxx::operator+().
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 375 of file vstring.h.
References __versa_string::resize().
Referenced by __versa_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 52 of file vstring.tcc.
References __versa_string::append(), and __versa_string::size().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 332 of file vstring.tcc.
References __versa_string::npos, and __versa_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 1376 of file vstring.h.
References __versa_string::rfind().
__versa_string< _CharT, _Traits, _Alloc, _Base >::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 310 of file vstring.tcc.
References std::min(), __versa_string::npos, and __versa_string::size().
size_type rfind | ( | const __versa_string< _CharT, _Traits, _Alloc, _Base > & | __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 1348 of file vstring.h.
References __versa_string::data(), __versa_string::rfind(), and __versa_string::size().
Referenced by __versa_string::find_last_of(), and __versa_string::rfind().
size_type size | ( | ) | const [inline] |
Returns the number of characters in the string, not including any null-termination.
Definition at line 337 of file vstring.h.
Referenced by __versa_string::append(), __versa_string::assign(), __versa_string::at(), __versa_string::compare(), __versa_string::empty(), __versa_string::end(), __versa_string::find(), __versa_string::find_first_not_of(), __versa_string::find_first_of(), __versa_string::find_last_not_of(), __versa_string::find_last_of(), __versa_string::insert(), __gnu_cxx::operator+(), __versa_string::operator[](), __versa_string::push_back(), __versa_string::replace(), __versa_string::resize(), and __versa_string::rfind().
__versa_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 1649 of file vstring.h.
References __versa_string::__versa_string().
void swap | ( | __versa_string< _CharT, _Traits, _Alloc, _Base > & | __s | ) | [inline] |
Swap contents with another string.
s | String to swap with. |
Definition at line 1248 of file vstring.h.
Referenced by __gnu_cxx::swap().
const __versa_string< _CharT, _Traits, _Alloc, _Base >::size_type npos [inline, static] |
Value returned by various member functions when they fail.
Definition at line 80 of file vstring.h.
Referenced by __versa_string::find(), __versa_string::find_first_not_of(), __versa_string::find_first_of(), __versa_string::find_last_not_of(), __versa_string::find_last_of(), and __versa_string::rfind().