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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::vector::back - std::vector::back

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

	  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::vector<char>:

       // Run this code

	#include <vector>
	#include <iostream>

	int main()
	{
	    std::vector<char> 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
		(public	member function)

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

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

home | help