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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::span::rend - std::span::rend

Synopsis
	  constexpr reverse_iterator rend() const noexcept;

	  Returns a reverse iterator to	the element following the last element
       of the reversed
	  span.	 It  corresponds to the	element	preceding the first element of
       the non-reversed
	  span.	This element acts as a placeholder, attempting	to  access  it
       results in
	  undefined behavior.

	  range-rbegin-rend.svg

Parameters
	  (none)

Return value
	  Reverse iterator to the element following the	last element.

Complexity
	  Constant.

Example
       // Run this code

	#include <algorithm>
	#include <iostream>
	#include <span>
	#include <string_view>

	void ascending(const std::span<const std::string_view> data,
		       const std::string_view term)
	{
	    std::for_each(data.begin(),	data.end(),
		[](const std::string_view x) { std::cout << x << " "; });
	    std::cout << term;
	}

	void descending(const std::span<const std::string_view>	data,
		       const std::string_view term)
	{
	    std::for_each(data.rbegin(), data.rend(),
		[](const std::string_view x) { std::cout << x << " "; });
	    std::cout << term;
	}

	int main()
	{
	    constexpr std::string_view bars[]{ "","","","","","","","" };
	    ascending(bars, " ");
	    descending(bars, "\n");
	}

Output:

See also
	  rbegin  returns a reverse iterator to	the beginning
	  (C++20) (public member function)
	  rend	  returns a reverse end	iterator for a container or array
	  crend	  (function template)
	  (C++14)

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

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

home | help