home | help
std::counte...ator::count(3)   C++ Standard Libary  std::counte...ator::count(3)

NAME
     std::counted_iterator::count - std::counted_iterator::count

Synopsis
	constexpr  std::iter_difference_t<I>  count()  const  noexcept;   (since
     C++20)

	Returns the underlying length that is the distance to the end.

Parameters
	(none)

Return value
	The underlying length.

Example
     // Run this code

      #include <cassert>
      #include <iostream>
      #include <iterator>

      int main()
      {
	  constexpr static auto il = {1, 2, 3, 4, 5};
	  constexpr std::counted_iterator i1{il.begin() + 1, 3};
	  static_assert(i1.count() == 3);
	  auto i2{i1};
	  for (; std::default_sentinel != i2; ++i2)
	      std::cout << "*i2: " << *i2 << ",  count():  "  <<  i2.count()  <<
     '\n';
	  assert(i2.count() == 0);
      }

Output:
      *i2: 2, count(): 3
      *i2: 3, count(): 2
      *i2: 4, count(): 1

See also
	base	accesses the underlying iterator
	(C++20) (public member function)

http://cppreference.com 	   2024.06.10	    std::counte...ator::count(3)

home | help