awtk/docs/manual/enum_helper.md
2020-05-25 17:44:36 +08:00

114 lines
3.3 KiB
Markdown

## enum\_helper
### 概述
----------------------------------
### 函数
<p id="enum_helper_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#enum_helper_asset_type_find_by_value">asset\_type\_find\_by\_value</a> | 获取资源类型枚值和名称的对应关系。 |
| <a href="#enum_helper_find_item">find\_item</a> | 获取特定枚值和名称的对应关系。 |
| <a href="#enum_helper_find_item_by_value">find\_item\_by\_value</a> | 获取特定枚值和名称的对应关系。 |
| <a href="#enum_helper_keys_type_find">keys\_type\_find</a> | 获取按键值和名称的对应关系。 |
| <a href="#enum_helper_keys_type_find_by_value">keys\_type\_find\_by\_value</a> | 获取按键值和名称的对应关系。 |
#### asset\_type\_find\_by\_value 函数
-----------------------
* 函数功能:
> <p id="enum_helper_asset_type_find_by_value">获取资源类型枚值和名称的对应关系。
* 函数原型:
```
const key_type_value_t* asset_type_find_by_value (uint32_t value);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | const key\_type\_value\_t* | 返回资源类型枚值和名称的对应关系。 |
| value | uint32\_t | 资源的类型。 |
#### find\_item 函数
-----------------------
* 函数功能:
> <p id="enum_helper_find_item">获取特定枚值和名称的对应关系。
* 函数原型:
```
const key_type_value_t* find_item (const key_type_value_t* items, uint32_t nr, const char* name);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | const key\_type\_value\_t* | 返回资源类型枚值和名称的对应关系。 |
| items | const key\_type\_value\_t* | 特定枚举值对应列表。 |
| nr | uint32\_t | 列表长度。 |
| name | const char* | 名称。 |
#### find\_item\_by\_value 函数
-----------------------
* 函数功能:
> <p id="enum_helper_find_item_by_value">获取特定枚值和名称的对应关系。
* 函数原型:
```
const key_type_value_t* find_item_by_value (const key_type_value_t* items, uint32_t nr, uint32_t value);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | const key\_type\_value\_t* | 返回资源类型枚值和名称的对应关系。 |
| items | const key\_type\_value\_t* | 特定枚举值对应列表。 |
| nr | uint32\_t | 列表长度。 |
| value | uint32\_t | 资源的类型。 |
#### keys\_type\_find 函数
-----------------------
* 函数功能:
> <p id="enum_helper_keys_type_find">获取按键值和名称的对应关系。
* 函数原型:
```
const key_type_value_t* keys_type_find (const char* name);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | const key\_type\_value\_t* | 返回按键值和名称的对应关系。 |
| name | const char* | 按键名。 |
#### keys\_type\_find\_by\_value 函数
-----------------------
* 函数功能:
> <p id="enum_helper_keys_type_find_by_value">获取按键值和名称的对应关系。
* 函数原型:
```
const key_type_value_t* keys_type_find_by_value (uint32_t value);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | const key\_type\_value\_t* | 返回按键值和名称的对应关系。 |
| value | uint32\_t | 按键值。 |