std::basic_string<CharT,Traits,Allocator>::rend, std::basic_string<CharT,Traits,Allocator>::crend

	(1)
reverse_iterator rend();		(до C++11)
reverse_iterator rend() noexcept;		(с C++11) (до C++20)
constexpr reverse_iterator rend() noexcept;		(с C++20)
	(2)
const_reverse_iterator rend() const;		(до C++11)
const_reverse_iterator rend() const noexcept;		(с C++11) (до C++20)
constexpr const_reverse_iterator rend() const noexcept;		(с C++20)
	(3)
const_reverse_iterator crend() const;		(до C++11)
const_reverse_iterator crend() const noexcept;		(с C++11) (до C++20)
constexpr const_reverse_iterator crend() const noexcept;		(с C++20)

Возвращает обратный итератор на символ, следующий за последним символом перевернутой строки. Он соответствует символу, предшествующему первому символу исходной строки. Этот символ используется как заполнитель, попытка доступа к нему приводит к неопределённому поведению.

Параметры

(нет)

Возвращаемое значение

Обратный итератор на символ, следующий за последним символом.

Сложность

Постоянная.

Примечания

В libstdc++, crend() недоступна в режиме C++98. не доступна в режиме C++98.

Пример

#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
 
int main()
{
    std::string p("[A man, a plan, a canal: Panama]");
    std::string q;
 
    std::copy(p.crbegin(), p.crend(), std::back_inserter(q));
    std::cout << "q = " << q << '\n';
 
    std::copy(q.crbegin(), q.crend(), p.rbegin());
    std::cout << "p = " << p << '\n';
}

Вывод:

q = ]amanaP :lanac a ,nalp a ,nam A[
p = ]amanaP :lanac a ,nalp a ,nam A[

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применено к	Поведение, опубликованное в	Корректное поведение
LWG 1192	C++98	`std::basic_string` не имела члена-функции `crend()`	добавлена

См. также

rbegincrbegin (DR*)	возвращает обратный итератор в начало (публичный член-функция)
rendcrend	возвращает обратный итератор в конец (публичный член-функция `std::basic_string_view<CharT,Traits>`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/rend