std::basic_string<CharT,Traits,Allocator>::begin,std::basic_string<CharT,Traits,Allocator>::cbegin
From cppreference.com
<cpp |string |basic string
C++
std::basic_string
|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
iterator begin(); | (1) | (noexcept since C++11) (constexpr since C++20) |
const_iterator begin()const; | (2) | (noexcept since C++11) (constexpr since C++20) |
const_iterator cbegin()constnoexcept; | (3) | (since C++11) (constexpr since C++20) |
Returns an iterator to the first character of the string.
begin() returns amutable orconstant iterator, depending on the constness of*this.
cbegin() always returns aconstant iterator. It is equivalent toconst_cast<const basic_string&>(*this).begin().
Contents |
[edit]Parameters
(none)
[edit]Return value
Iterator to the first character.
[edit]Complexity
Constant.
[edit]Notes
libc++ backportscbegin() to C++98 mode.
[edit]Example
Run this code
#include <iostream>#include <string> int main(){std::string s("Exemplar");*s.begin()='e';std::cout<< s<<'\n'; auto i= s.cbegin();std::cout<<*i<<'\n';// *i = 'E'; // error: i is a constant iterator}
Output:
exemplare
[edit]See also
(C++11) | returns an iterator to the end (public member function)[edit] |
| returns an iterator to the beginning (public member function of std::basic_string_view<CharT,Traits>)[edit] |
