1# oh_preferences_value.h
2
3
4## 概述
5
6提供访问Preferences值（PreferencesValue）对象的接口、枚举类型与数据结构。
7
8**引用文件：**<database/preferences/oh_preferences_value.h>
9
10**库：** libohpreferences.so
11
12**系统能力：** SystemCapability.DistributedDataManager.Preferences.Core
13
14**起始版本：** 13
15
16**相关模块：**[Preferences](_preferences.md)
17
18
19## 汇总
20
21
22### 类型定义
23
24| 名称 | 描述 |
25| -------- | -------- |
26| typedef enum [Preference_ValueType](_preferences.md#preference_valuetype) [Preference_ValueType](_preferences.md#preference_valuetype) | 定义PreferencesValue的数据类型。 |
27| typedef struct [OH_PreferencesPair](_preferences.md#oh_preferencespair) [OH_PreferencesPair](_preferences.md#oh_preferencespair) | 定义Preferences使用的KV数据对象类型。 |
28| typedef struct [OH_PreferencesValue](_preferences.md#oh_preferencesvalue) [OH_PreferencesValue](_preferences.md#oh_preferencesvalue) | 定义PreferencesValue对象类型。 |
29
30
31### 枚举
32
33| 名称 | 描述 |
34| -------- | -------- |
35| [Preference_ValueType](_preferences.md#preference_valuetype-1) {<br/>PREFERENCE_TYPE_NULL = 0, PREFERENCE_TYPE_INT, PREFERENCE_TYPE_BOOL, PREFERENCE_TYPE_STRING,<br/>PREFERENCE_TYPE_BUTT<br/>} | 定义PreferencesValue的数据类型。 |
36
37
38### 函数
39
40| 名称 | 描述 |
41| -------- | -------- |
42| const char \* [OH_PreferencesPair_GetKey](_preferences.md#oh_preferencespair_getkey) (const [OH_PreferencesPair](_preferences.md#oh_preferencespair) \*pairs, uint32_t index) | 获取KV数据中索引对应数据的键。 |
43| const [OH_PreferencesValue](_preferences.md#oh_preferencesvalue) \* [OH_PreferencesPair_GetPreferencesValue](_preferences.md#oh_preferencespair_getpreferencesvalue) (const [OH_PreferencesPair](_preferences.md#oh_preferencespair) \*pairs, uint32_t index) | 获取KV数据数组中索引对应的值。 |
44| [Preference_ValueType](_preferences.md#preference_valuetype) [OH_PreferencesValue_GetValueType](_preferences.md#oh_preferencesvalue_getvaluetype) (const [OH_PreferencesValue](_preferences.md#oh_preferencesvalue) \*object) | 获取PreferencesValue对象的数据类型。 |
45| int [OH_PreferencesValue_GetInt](_preferences.md#oh_preferencesvalue_getint) (const [OH_PreferencesValue](_preferences.md#oh_preferencesvalue) \*object, int \*value) | 从PreferencesValue对象[OH_PreferencesValue](_preferences.md#oh_preferencesvalue)中获取一个整型值。 |
46| int [OH_PreferencesValue_GetBool](_preferences.md#oh_preferencesvalue_getbool) (const [OH_PreferencesValue](_preferences.md#oh_preferencesvalue) \*object, bool \*value) | 从PreferencesValue对象[OH_PreferencesValue](_preferences.md#oh_preferencesvalue)中获取一个布尔值。 |
47| int [OH_PreferencesValue_GetString](_preferences.md#oh_preferencesvalue_getstring) (const [OH_PreferencesValue](_preferences.md#oh_preferencesvalue) \*object, char \*\*value, uint32_t \*valueLen) | 从PreferencesValue对象[OH_PreferencesValue](_preferences.md#oh_preferencesvalue)中获取字符串。 |
48