template <class InputIterator, class T> typename iterator_traits<InputIterator>::difference_type count ( ForwardIterator first, ForwardIterator last, const T& value );
Count appearances of value in range
Returns the number of elements in the range
[first,last) that compare equal to
value.
The behavior of this function template is equivalent to:
| |
Parameters
-
first, last
-
Forward iterators to the initial and final positions of the sequence of elements. The range used is
[first,last), which contains all the elements between
first and
last, including the element pointed by
first but not the element pointed by
last.
-
value
- Value to compare the elements in the range with.
Return value
The number of elements in the range [first,last) that compare equal to value.The return type ( iterator_traits<InputIterator>::difference_type) is a signed integral type, generally defined as the same type as ptrdiff_t.
Example
| |
Output:
10 appears 3 times. 20 appears 3 times. |
Complexity
Linear: Performs as many comparisons as the number of elements between first and last.See also
-
for_each
- Apply function to range (template function)
-
count_if
- Return number of elements in range satisfying condition (function template)
-
find
- Find value in range (function template)
-
replace
- Replace value in range (function template)