std::basic_string<CharT,Traits,Allocator>::rbegin, std::basic_string<CharT,Traits,Allocator>::crbegin

From cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
Member functions
Element access
Iterators
basic_string::rbeginbasic_string::crbegin
(DR*)
Capacity
Operations
Search
Constants
Deduction guides (C++17)
Non-member functions
I/O
Comparison
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
Numeric conversion
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Helper classes
 
(1)
reverse_iterator rbegin();
(until C++11)
reverse_iterator rbegin() noexcept;
(since C++11)
(until C++20)
constexpr reverse_iterator rbegin() noexcept;
(since C++20)
(2)
const_reverse_iterator rbegin() const;
(until C++11)
const_reverse_iterator rbegin() const noexcept;
(since C++11)
(until C++20)
constexpr const_reverse_iterator rbegin() const noexcept;
(since C++20)
(3)
const_reverse_iterator crbegin() const;
(until C++11)
const_reverse_iterator crbegin() const noexcept;
(since C++11)
(until C++20)
constexpr const_reverse_iterator crbegin() const noexcept;
(since C++20)

Returns a reverse iterator to the first character of the reversed string. It corresponds to the last character of the non-reversed string.

range-rbegin-rend.svg

Parameters

(none)

Return value

Reverse iterator to the first character.

Complexity

Constant.

Notes

In libstdc++, crbegin() is not available in C++98 mode.

Example

#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
 
int main()
{
    std::string s("Exemplar!");
    *s.rbegin() = 'y';
    std::cout << s << '\n'; // "Exemplary"
 
    std::string c;
    std::copy(s.crbegin(), s.crend(), std::back_inserter(c));
    std::cout << c << '\n'; // "yralpmexE"
}

Output:

Exemplary
yralpmexE

Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
LWG 1192 C++98 std::basic_string did not have the member function crbegin() added

See also

returns a reverse iterator to the end
(public member function)
returns a reverse iterator to the beginning
(public member function of std::basic_string_view<CharT,Traits>)