# syscap_ndk.h

> phone 12+ | 2in1 13+ | tablet 12+ | tv 19+ | wearable 18+

## 概述

查询单个系统能力（SystemCapability）是否被支持的API。开发者可在运行时查询设备是否支持特定系统能力，实现差异化功能适配。典型使用场景包括：针对不同设备型号适配功能、特性降级开关控制、条件功能分支判断等。该API具有轻量级、高效的特点，能帮助开发者避免因调用设备不支持的API而导致的崩溃问题，提高应用在不同设备上的兼容性和稳定性。

**引用文件：** <syscap_ndk.h>

**系统能力：** SystemCapability.Startup.SystemInfo

**起始版本：** 8

**相关模块：** [Init](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/init)

## 汇总

### 函数

|名称|描述|
|:-----------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|bool [canIUse](#caniuse) (const char *cap)|返回指定的系统能力是否被支持。返回true表示支持，返回false表示不支持。cap参数为系统能力名称，格式为"SystemCapability.xxx.xxx"。 系统能力（SystemCapability，简称 SysCap），指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集，每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用对应的API。 **起始版本：** 8|

## 函数说明

### canIUse()

```c
bool canIUse (const char * cap)
```

**描述：**

查询指定的系统能力是否被支持。 系统能力（SystemCapability，简称SysCap），指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集，每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用某接口。

**起始版本：** 8

**参数：**

|名称|描述|
|:--|:----------|
|cap|待查询的系统能力名称。|

**返回：**

|类型|说明|
|:---|:-----------------------------------|
|bool|系统能力查询结果，true表示系统具备该能力，false表示系统不具备。|