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 << c <<'\n'; // "Exemplar"
 }

Output:

 Exemplar