Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | string‎ | basic string
m (Text replace - "<!-- ======== --> " to "")
m (fmt.)
 
(29 intermediate revisions by 10 users not shown)
Line 1: Line 1:
−
{{cpp/string/basic_string/title | rend | crend}}
+
{{cpp/string/basic_string/title|rend|crend}}
−
{{cpp/string/basic_string/sidebar}}
+
{{cpp/string/basic_string/navbar}}
−
{{ddcl list begin}}
+
{{dcl begin}}
−
{{ddcl list item |  
+
{{dcla|anchor=no|num=1|noexcept=c++11|constexpr=c++20|
−
iterator rend();
+
reverse_iterator rend();
 
}}
 
}}
−
{{ddcl list item |
+
{{dcla|anchor=no|num=2|noexcept=c++11|constexpr=c++20|
−
const_iterator rend() const;
+
const_reverse_iterator rend() const;
 
}}
 
}}
−
{{ddcl list item | notes={{mark c++0x feature}} |
+
{{dcla|anchor=no|num=3|since=c++11|constexpr=c++20|
−
const_iterator crend() const;
+
const_reverse_iterator crend() const noexcept;
 
}}
 
}}
−
{{ddcl list end}}
+
{{dcl end}}
  
−
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.  
+
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.
  
−
{{params}}
+
{{image|range-rbegin-rend.svg}}
−
{{param none}}
+
  
−
{{returns}}
+
===Parameters===
 +
(none)
  
−
reverse iterator to the character following the last character
+
===Return value===
 +
Reverse iterator to the character following the last character.
  
−
{{complex}}
+
===Complexity===
−
{{complex constant}}
+
Constant.
  
−
{{see also}}
+
===Notes===
 +
libc++ backports {{tt|crend()}} to C++98 mode.
  
−
{{dcl list begin}}
+
===Example===
−
{{dcl list template | cpp/string/basic_string/dcl list rbegin}}
+
{{example
−
{{dcl list end}}
+
|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[
 +
}}
 +
 
 +
===See also===
 +
{{dsc begin}}
 +
{{dsc inc|cpp/string/basic_string/dsc rbegin}}
 +
{{dsc inc|cpp/string/basic_string_view/dsc rend}}
 +
{{dsc end}}
 +
 
 +
{{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"