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

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

NAME

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

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

See also


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


(C++11)