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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::span::end -	std::span::end

Synopsis
	  constexpr iterator end() const noexcept;

	  Returns an iterator to the element following the last	element	of the
       span.

	  This	element	acts as	a placeholder; attempting to access it results
       in undefined
	  behavior.

	  range-begin-end.svg

Parameters
	  (none)

Return value
	  Iterator to the element following the	last element.

Complexity
	  Constant.

Example
       // Run this code

	#include <span>
	#include <iostream>

	void print(std::span<const int>	sp)
	{
	    for(auto it	= sp.begin(); it != sp.end(); ++it) {
		std::cout << *it << ' ';
	    }
	    std::cout << '\n';
	}

	void transmogrify(std::span<int> sp)
	{
	    if (!sp.empty()) {
		std::cout << *sp.begin() << '\n';
		*sp.begin() = 2;
	    }
	}

	int main()
	{
	    int	array[]	{ 1, 3,	4, 5 };
	    print(array);
	    transmogrify(array);
	    print(array);
	}

Output:
	1 3 4 5
	1
	2 3 4 5

See also
	  begin	  returns an iterator to the beginning
	  (C++20) (public member function)
	  end
	  cend	  returns an iterator to the end of a container	or array
	  (C++11) (function template)
	  (C++14)

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

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

home | help