public member function
<string>
std::string::cbegin
const_iterator cbegin() const noexcept;
Return const_iterator to beginning
Returns a const_iterator pointing to the first character of the string.
A const_iterator is an iterator that points to const content. This iterator can be increased and decreased (unless it is itself also const), just like the iterator returned by string::begin, but it cannot be used to modify the contents it points to, even if the string object is not itself const.
Return Value
A const_iterator to the beginning of the string.
Member type const_iterator is a random access iterator type that points to a const character.
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
|
// string::cbegin/cend
#include <iostream>
#include <string>
int main ()
{
std::string str ("Lorem ipsum");
for (auto it=str.cbegin(); it!=str.cend(); ++it)
std::cout << *it;
std::cout << '\n';
return 0;
}
|
Output:
Complexity
Unspecified, but generally constant.
Iterator validity
No changes.
Data races
The object is accessed.
Exception safety
No-throw guarantee: this member function never throws exceptions.
The copy construction or assignment of the returned iterator is also guaranteed to never throw.
See also
- string::begin
- Return iterator to beginning (public member function)
- string::cend
- Return const_iterator to end (public member function)
- string::crbegin
- Return const_reverse_iterator to reverse beginning (public member function)