std::basic_string<CharT,Traits,Allocator>::end, (3) - Linux Manuals

std::basic_string<CharT,Traits,Allocator>::end,: std::basic_string<CharT,Traits,Allocator>::end,

NAME

std::basic_string<CharT,Traits,Allocator>::end, - std::basic_string<CharT,Traits,Allocator>::end,

Synopsis


iterator end();                               (until C++11)
iterator end() noexcept;                      (since C++11)
const_iterator end() const;           (1)                   (until C++11)
const_iterator end() const noexcept;      (2)               (since C++11)
const_iterator cend() const noexcept;         (3)           (since C++11)


Returns an iterator to the character following the last character of the string.
This character acts as a placeholder, attempting to access it results in undefined
behavior.


range-begin-end.svg

Parameters


(none)

Return value


iterator to the character following the last character

Complexity


Constant

Example


// Run this code


 #include <iostream>
 #include <algorithm>
 #include <iterator>
 #include <string>


 int main()
 {
  std::string s("Exemparl");
  std::next_permutation(s.begin(), s.end());


  std::string c;
  std::copy(s.cbegin(), s.cend(), std::back_inserter(c));
  std::cout << <<'\n'; // "Exemplar"
 }

Output:


 Exemplar

See also


begin   returns an iterator to the beginning
cbegin  (public member function)
(C++11)