Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/string/basic string/rend"

From cppreference.com
< cpp‎ | string‎ | basic string
m (fmt)
m (fmt.)
 
(4 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
{{cpp/string/basic_string/navbar}}
 
{{cpp/string/basic_string/navbar}}
 
{{dcl begin}}
 
{{dcl begin}}
−
{{dcl rev multi|num=1|until1=c++11|dcl1=
+
{{dcla|anchor=no|num=1|noexcept=c++11|constexpr=c++20|
 
reverse_iterator rend();
 
reverse_iterator rend();
−
|until2=c++20|dcl2=
 
−
reverse_iterator rend() noexcept;
 
−
|dcl3=
 
−
constexpr reverse_iterator rend() noexcept;
 
 
}}
 
}}
−
{{dcl rev multi|num=2|until1=c++11|dcl1=
+
{{dcla|anchor=no|num=2|noexcept=c++11|constexpr=c++20|
 
const_reverse_iterator rend() const;
 
const_reverse_iterator rend() const;
−
|until2=c++20|dcl2=
 
−
const_reverse_iterator rend() const noexcept;
 
−
|dcl3=
 
−
constexpr const_reverse_iterator rend() const noexcept;
 
 
}}
 
}}
−
{{dcl rev multi|num=3
+
{{dcla|anchor=no|num=3|since=c++11|constexpr=c++20|
−
|since1=c++11|dcl1=
+
 
const_reverse_iterator crend() const noexcept;
 
const_reverse_iterator crend() const noexcept;
−
|since2=c++20|dcl2=
 
−
constexpr const_reverse_iterator crend() const noexcept;
 
 
}}
 
}}
 
{{dcl end}}
 
{{dcl end}}
Line 32: Line 21:
  
 
===Return value===
 
===Return value===
−
reverse iterator to the character following the last character
+
Reverse iterator to the character following the last character.
  
 
===Complexity===
 
===Complexity===
−
Constant
+
Constant.
 +
 
 +
===Notes===
 +
libc++ backports {{tt|crend()}} to C++98 mode.
  
 
===Example===
 
===Example===
Line 62: Line 54:
  
 
===See also===
 
===See also===
−
 
 
{{dsc begin}}
 
{{dsc begin}}
 
{{dsc inc|cpp/string/basic_string/dsc rbegin}}
 
{{dsc inc|cpp/string/basic_string/dsc rbegin}}
−
{{dsc inc|cpp/string/basic_string_view/dsc {{SUBPAGENAMEE}}}}
+
{{dsc inc|cpp/string/basic_string_view/dsc rend}}
 
{{dsc end}}
 
{{dsc end}}
  
 
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}
 
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Latest revision as of 17:34, 22 June 2024

 
C++
 
Strings library
 
std::basic_string
Member functions
(C++23)
Element access
(DR*)
(DR*)
(C++17)
Iterators
(C++11)
(C++11)
(C++11)
basic_string::rendbasic_string::crend
(C++11)
Capacity
(DR*)
Modifiers
(C++23)
(DR*)
(C++23)
(C++23)
(C++23)  
Search
Operations
(C++20)
(C++20)
(C++23)
Constants
Non-member functions
(C++20)(C++20)
I/O
Comparison
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
Numeric conversions
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Literals
(C++14)
Helper classes
(C++11)
Deduction guides (C++17)

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

Returns a reverse iterator to the character following the last character of the reversed string. It corresponds to the character preceding the first character of the non-reversed string. This character acts as a placeholder, attempting to access it results in undefined behavior.

range-rbegin-rend.svg

Contents

[edit] Parameters

(none)

[edit] Return value

Reverse iterator to the character following the last character.

[edit] Complexity

Constant.

[edit] Notes

libc++ backports crend() to C++98 mode.

[edit] Example

Run this code
#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';
}

Output: 

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

[edit] See also

(C++11)
 returns a reverse iterator to the beginning
(public member function) [edit]
returns a reverse iterator to the end
(public member function of std::basic_string_view<CharT,Traits>) [edit]
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/rend&oldid=172763"