---
title: countNonZero
description: "countNonZero用于计算矩阵或图像中非零像素的数量。可以快速统计图像中某种特定特征的出现次数。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_kpcv_06_0038.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_kpcv_06_0038.html
indexId: 48a4b1e7f193791f6723fb93e0218b0ab72105b02fd9d6cc8fd3d1a13cc1786677
---
# countNonZero

#### 函数功能

countNonZero用于计算矩阵或图像中非零像素的数量。可以快速统计图像中某种特定特征的出现次数。


#### 函数接口

```
int countNonZero(InputArray src);
```


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 输入图像。 | 非空、单通道 | 输入 |


#### 返回值

- 非零像素数量。


#### 示例

```
#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    // 创建一个5x5的二值图像
    cv::Mat src = (cv::Mat_<uint8_t>(5, 5) << 0, 0, 0, 0, 0,
                                              0, 1, 1, 1, 0,
                                              0, 1, 0, 1, 0,
                                              0, 1, 1, 1, 0,
                                              0, 0, 0, 0, 0);

    // 统计非零像素的数量
    int count = cv::countNonZero(src);

    std::cout << "非零像素数量: " << count << std::endl;

    return 0;
}
```

运行结果：

```
非零像素数量: 8
```