home | help 
std::experi...es::distance(3)  C++ Standard Libary std::experi...es::distance(3)

NAME
     std::experimental::ranges::distance - std::experimental::ranges::distance

Synopsis
	Defined in header <experimental/ranges/iterator>
	namespace {
									      (ranges
     TS)
	    constexpr	/*   unspecified   */  distance  =  /*	unspecified  */;
     (customization
									      point
     object)
	}
	Call signature
	template< Iterator I, Sentinel<I> S >
	constexpr ranges::difference_type_t<I> distance( I first, S last  (1)
	);
	template< Range R >
	constexpr ranges::difference_type_t<ranges::iterator_t<R>>	  (2)
	distance( R&& r );
	template< SizedRange R >
	constexpr ranges::difference_type_t<ranges::iterator_t<R>>	  (3)
	distance( R&& r );

	Returns the distance between first and last, or  between  the  beginning
     and the end of
	the range r.

	1)  If	SizedSentinel<S,  I>  is  satisfied, equivalent to return last -
     first;.
	Otherwise, returns the number of increments needed to get from first  to
     last. If
	[first,  last)	does  not  denote a range, then I and S must be the same
     type and must
	model SizedSentinel, and [last, first) must denote a  range.  Otherwise,
     the behavior
	is undefined.
	2)     Equivalent     to    return    ranges::distance(ranges::begin(r),
     ranges::end(r));.
	3) Equivalent to return ranges::size(r);.

	Instantiating overloads (2,3) may be ill-formed if the header
	<experimental/ranges/range> is not included before the point of  instan-
     tiation.

Return value
	The  distance  between	first and last, or between the beginning and the
     end of the
	range r.

Example
	 This section is incomplete
	 Reason: no example

See also
	distance returns the distance between two iterators
		 (function template)
	advance  advances an iterator by given distance
		 (function template)
	next	 increment an iterator
		 (function template)
	prev	 decrement an iterator
		 (function template)
	size	 obtains the size of a range whose size  can  be  calculated  in
     constant time
		 (customization point object)

Category:
	  * Todo no example

http://cppreference.com 	   2024.06.10	   std::experi...es::distance(3)
home | help