Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::array::back(3)	      C++ Standard Libary	   std::array::back(3)

NAME
       std::array::back	- std::array::back

Synopsis
	  reference back();			   (until C++17)
	  constexpr reference back();		   (since C++17)
	  const_reference back() const;		   (until C++14)
	  constexpr const_reference back() const;  (since C++14)

	  Returns a reference to the last element in the container.

	  Calling back on an empty container causes undefined behavior.

Parameters
	  (none)

Return value
	  Reference to the last	element.

Complexity
	  Constant.

Notes
	  For  a  non-empty container c, the expression	c.back() is equivalent
       to
	  *std::prev(c.end())

Example
	  The following	code uses back	to  display  the  last	element	 of  a
       std::array<char>:

       // Run this code

	#include <array>
	#include <iostream>

	int main()
	{
	    std::array<char, 6>	letters	{'a', 'b', 'c',	'd', 'e', 'f'};

	    if (!letters.empty()) {
		std::cout  <<  "The  last character is '" << letters.back() <<
       "'.\n";
	    }
	}

Output:
	The last character is 'f'.

See also
	  front	  access the first element
	  (C++11) (public member function)

http://cppreference.com		  2022.07.31		   std::array::back(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::array::back&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help