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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::span::back - std::span::back

Synopsis
	  constexpr reference back() const;

	  Returns a reference to the last element in the span.

	  Calling back on an empty span	results	in undefined behavior.

Parameters
	  (none)

Return value
	  A reference to the back element.

Complexity
	  Constant

Notes
	  For a	span c,	the expression c.back()	is equivalent to *(c.end()-1).

Example
       // Run this code

	#include <span>
	#include <iostream>

	void print_forward(std::span<const int>	const span) {
	    for	(auto n	{ span.size() }; n != 0; --n ) {
		std::cout << span.last(n).front() << ' ';
	    }
	    std::cout << '\n';
	}

	void print_backward(std::span<const int> const span) {
	    for	(auto n	{ span.size() }; n != 0; --n) {
		std::cout << span.first(n).back() << ' ';
	    }
	    std::cout << '\n';
	}

	int main()
	{
	    constexpr int numbers[] { 0, 1, 2, 3, 4 };
	    print_forward(numbers);
	    print_backward(numbers);
	}

Output:
	0 1 2 3	4
	4 3 2 1	0

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

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

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

home | help