# std::experimental::popcount

> C++ Atlas: `cppatlas.com/w/cpp/experimental/simd/popcount` | Source: https://en.cppreference.com/w/cpp/experimental/simd/popcount | Domain: Technical specifications

Returns the number of true values in the mask k.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <experimental/simd>

template< class T, class Abi >
int popcount( const simd_mask<T, Abi>& k ) noexcept; // (parallelism TS v2)
```

Returns the number of `true` values in the mask `k`.

### Parameters

- `k` - the `simd_mask` to apply the reduction to

### Return value

An `int` in the range `[​0​,` `simd_size_v<T, Abi>)`.

### Example

```cpp
#include <cstddef>
#include <experimental/simd>
#include <iostream>
namespace stdx = std::experimental;

template<typename Abi>
int count_zeros(stdx::simd<int, Abi> v)
{
    return stdx::popcount(v == 0); // v == 0 returns a simd_mask
}

void println(auto rem, auto const v)
{
    std::cout << rem << ": ";
    for (std::size_t i = 0; i != v.size(); ++i)
        std::cout << v[i] << ' ';
}

int main()
{
    stdx::simd<int> x{8};
    println("x", x);
    std::cout << "  zeros: " << count_zeros(x) << '\n';

    x[3] = x[1] = false;
    println("x", x);
    std::cout << "  zeros: " << count_zeros(x) << '\n';
}
```

Possible output:

```text
x: 8 8 8 8   zeros: 0
x: 8 0 8 0   zeros: 2
```

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