Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | string‎ | basic string
m (Add example)
m (fmt.)
 
(12 intermediate revisions by 7 users not shown)
Line 1: Line 1:
−
{{cpp/string/basic_string/title | rbegin | crbegin}}
+
{{cpp/string/basic_string/title|rbegin|crbegin}}
 
{{cpp/string/basic_string/navbar}}
 
{{cpp/string/basic_string/navbar}}
 
{{dcl begin}}
 
{{dcl begin}}
−
{{dcl |
+
{{dcla|anchor=no|num=1|noexcept=c++11|constexpr=c++20|
 
reverse_iterator rbegin();
 
reverse_iterator rbegin();
 
}}
 
}}
−
{{dcl |
+
{{dcla|anchor=no|num=2|noexcept=c++11|constexpr=c++20|
 
const_reverse_iterator rbegin() const;
 
const_reverse_iterator rbegin() const;
 
}}
 
}}
−
{{dcl | since=c++11 |
+
{{dcla|anchor=no|num=3|since=c++11|constexpr=c++20|
−
const_reverse_iterator crbegin() const;
+
const_reverse_iterator crbegin() const noexcept;
 
}}
 
}}
 
{{dcl end}}
 
{{dcl end}}
  
−
Returns a reverse iterator to the first character of the reversed string. It corresponds to the last character of the non-reversed string.  
+
Returns a reverse iterator to the first character of the reversed string. It corresponds to the last character of the non-reversed string.
 +
 
 +
{{image|range-rbegin-rend.svg}}
  
 
===Parameters===
 
===Parameters===
Line 19: Line 21:
  
 
===Return value===
 
===Return value===
−
 
+
Reverse iterator to the first character.
−
reverse iterator to the first character
+
  
 
===Complexity===
 
===Complexity===
−
Constant
+
Constant.
 +
 
 +
===Notes===
 +
libc++ backports {{tt|crbegin()}} to C++98 mode.
  
 
===Example===
 
===Example===
 
{{example
 
{{example
−
| code=
+
|code=
−
#include <cassert>
+
#include <algorithm>
 +
#include <iostream>
 +
#include <iterator>
 
#include <string>
 
#include <string>
  
 
int main()
 
int main()
 
{
 
{
−
  std::string s("Exemplar!");
+
    std::string s("Exemplar!");
−
  *s.rbegin() = 'y';
+
    *s.rbegin() = 'y';
−
  assert("Exemplary" == s);
+
    std::cout << s << '\n'; // "Exemplary"
−
 
+
−
  auto i = s.crbegin();
+
    std::string c;
−
  assert(s[s.size()-1] == *i);
+
    std::copy(s.crbegin(), s.crend(), std::back_inserter(c));
 +
    std::cout << c << '\n'; // "yralpmexE"
 
}
 
}
−
| output=
+
|output=
 +
Exemplary
 +
yralpmexE
 
}}
 
}}
  
 
===See also===
 
===See also===
−
 
 
{{dsc begin}}
 
{{dsc begin}}
−
{{dsc inc | cpp/string/basic_string/dsc rend}}
+
{{dsc inc|cpp/string/basic_string/dsc rend}}
 +
{{dsc inc|cpp/string/basic_string_view/dsc rbegin}}
 
{{dsc end}}
 
{{dsc end}}
  
−
[[de:cpp/string/basic string/rbegin]]
+
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}
−
[[es:cpp/string/basic string/rbegin]]
+
−
[[fr:cpp/string/basic string/rbegin]]
+
−
[[it:cpp/string/basic string/rbegin]]
+
−
[[ja:cpp/string/basic string/rbegin]]
+
−
[[pt:cpp/string/basic string/rbegin]]
+
−
[[ru:cpp/string/basic string/rbegin]]
+
−
[[zh:cpp/string/basic string/rbegin]]
+

Latest revision as of 17:35, 22 June 2024

 
C++
 
Strings library
 
std::basic_string
Member functions
(C++23)
Element access
(DR*)
(DR*)
(C++17)
Iterators
(C++11)
(C++11)
basic_string::rbeginbasic_string::crbegin
(C++11)
(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 rbegin();
 (1) (noexcept since C++11)
(constexpr since C++20)
const_reverse_iterator rbegin() const;
 (2) (noexcept since C++11)
(constexpr since C++20)
const_reverse_iterator crbegin() const noexcept;
 (3) (since C++11)
(constexpr 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

Contents

[edit] Parameters

(none)

[edit] Return value

Reverse iterator to the first character.

[edit] Complexity

Constant.

[edit] Notes

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

[edit] Example

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

[edit] See also

(C++11)
 returns a reverse iterator to the end
(public member function) [edit]
returns a reverse iterator to the beginning
(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/rbegin&oldid=172764"