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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::experimental::ranges::distance  -  std::experimental::ranges::dis-
       tance

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	begin-
       ning 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.	Other-
       wise, 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  in-
       stantiation.

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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::experimental::ranges::distance&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help