# std::flat_map<Key,T,Compare,KeyContainer,MappedContainer>::count

> C++ Atlas: `cppatlas.com/w/cpp/container/flat_map/count` | Source: https://en.cppreference.com/w/cpp/container/flat_map/count | Domain: Containers | Standards: C++23

Returns the number of elements with key that compares equivalent to the specified argument.

## Official Specification Summary (cppreference)

```cpp
size_type count( const Key& key ) const; // (1) (since C++23)

template< class K >
size_type count( const K& x ) const; // (2) (since C++23)
```

Returns the number of elements with key that compares *equivalent* to the specified argument.

1) Returns the number of elements with key `key`. This is either 1 or 0 since this container does not allow duplicates.

2) Returns the number of elements with key that compares equivalent to the value `x`. This overload participates in overload resolution only if the qualified-id `Compare::is_transparent` is valid and denotes a type. It allows calling this function without constructing an instance of `Key`.

### Parameters

- `key` - key value of the elements to count
- `x` - alternative value to compare to the keys

### Return value

Number of elements with key that compares *equivalent* to `key` or `x`, which, for overload (1), is either 1 or 0.

### Complexity

Logarithmic in the size of the container plus linear in the number of elements found.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`find`](https://en.cppreference.com/w/cpp/container/flat_map/find): finds element with specific key (public member function)
- [`equal_range`](https://en.cppreference.com/w/cpp/container/flat_map/equal_range): returns range of elements matching a specific key (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/container/flat_map/count (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.