• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# OH_VObject
2<!--Kit: ArkData-->
3<!--Subsystem: DistributedDataManager-->
4<!--Owner: @baijidong-->
5<!--Designer: @widecode; @htt1997-->
6<!--Tester: @yippo; @logic42-->
7<!--Adviser: @ge-yafang-->
8
9## 概述
10
11表示允许的数据字段类型。
12
13**起始版本:** 10
14
15**相关模块:** [RDB](capi-rdb.md)
16
17**所在头文件:** [oh_value_object.h](capi-oh-value-object-h.md)
18
19## 汇总
20
21### 成员变量
22
23| 名称       | 描述                           |
24| ---------- | ------------------------------ |
25| int64_t id | OH_VObject结构体的唯一标识符。 |
26
27### 成员函数
28
29| 名称                                                         | 描述                                                     |
30| ------------------------------------------------------------ | -------------------------------------------------------- |
31| [int (*putInt64)(OH_VObject *valueObject, int64_t *value, uint32_t count))](#putint64) | 将int64类型的单个参数或者数组转换为OH_VObject类型的值。  |
32| [int (*putDouble)(OH_VObject *valueObject, double *value, uint32_t count)](#putdouble) | 将double类型的单个参数或者数组转换为OH_VObject类型的值。 |
33| [int (*putText)(OH_VObject *valueObject, const char *value)](#puttext) | 将char *类型的字符数组转换为OH_VObject类型的值。         |
34| [int (*putTexts)(OH_VObject *valueObject, const char **value, uint32_t count)](#puttexts) | 将char *类型的字符串数组转换为OH_VObject类型的值。       |
35| [int (*destroy)(OH_VObject *valueObject)](#destroy)          | OH_VObject,并回收该对象占用的内存。                     |
36
37## 成员函数说明
38
39### putInt64()
40
41```
42int (*putInt64)(OH_VObject *valueObject, int64_t *value, uint32_t count))
43```
44
45**描述**
46
47将int64类型的单个参数或者数组转换为OH_VObject类型的值。
48
49**起始版本:** 10
50
51**参数:**
52
53| 参数项                  | 描述                                                         |
54| ----------------------- | ------------------------------------------------------------ |
55| OH_VObject *valueObject | 表示指向OH_VObject实例的指针。                               |
56| int64_t *value          | 表示指向int64_t类型的单个参数或者数组的指针。                |
57| uint32_t count          | 如果value是指向单个数值的指针,则count = 1;如果value是指向数组的指针,则count是数组的长度。 |
58
59**返回:**
60
61| 类型 | 说明                                       |
62| ---- | ------------------------------------------ |
63| int  | 返回操作是否成功,出错时返回对应的错误码。 |
64
65### putDouble()
66
67```
68int (*putDouble)(OH_VObject *valueObject, double *value, uint32_t count)
69```
70
71**描述**
72
73将double类型的单个参数或者数组转换为OH_VObject类型的值。
74
75**起始版本:** 10
76
77**参数:**
78
79| 参数项                  | 描述                                                         |
80| ----------------------- | ------------------------------------------------------------ |
81| OH_VObject *valueObject | 表示指向OH_VObject实例的指针。                               |
82| double *value           | 表示指向double类型的单个参数或者数组的指针。                 |
83| uint32_t count          | 如果value是指向单个数值的指针,则count = 1;如果value是指向数组的指针,则count是数组的长度。 |
84
85**返回:**
86
87| 类型 | 说明                                       |
88| ---- | ------------------------------------------ |
89| int  | 返回操作是否成功,出错时返回对应的错误码。 |
90
91### putText()
92
93```
94int (*putText)(OH_VObject *valueObject, const char *value)
95```
96
97**描述**
98
99将char *类型的字符数组转换为OH_VObject类型的值。
100
101**起始版本:** 10
102
103**参数:**
104
105| 参数项                  | 描述                           |
106| ----------------------- | ------------------------------ |
107| OH_VObject *valueObject | 表示指向OH_VObject实例的指针。 |
108| const char *value       | 表示字符数组参数。             |
109
110**返回:**
111
112| 类型 | 说明                                       |
113| ---- | ------------------------------------------ |
114| int  | 返回操作是否成功,出错时返回对应的错误码。 |
115
116### putTexts()
117
118```
119int (*putTexts)(OH_VObject *valueObject, const char **value, uint32_t count)
120```
121
122**描述**
123
124将char *类型的字符串数组转换为OH_VObject类型的值。
125
126**起始版本:** 10
127
128**参数:**
129
130| 参数项                  | 描述                            |
131| ----------------------- | ------------------------------- |
132| OH_VObject *valueObject | 表示指向OH_VObject实例的指针。  |
133| const char **value      | 表示字符串数组参数。            |
134| uint32_t count          | 表示字符串数组参数value的长度。 |
135
136**返回:**
137
138| 类型 | 说明                                       |
139| ---- | ------------------------------------------ |
140| int  | 返回操作是否成功,出错时返回对应的错误码。 |
141
142### destroy()
143
144```
145int (*destroy)(OH_VObject *valueObject)
146```
147
148**描述**
149
150销毁OH_VObject对象,并回收该对象占用的内存。
151
152**起始版本:** 10
153
154**参数:**
155
156| 参数项                  | 描述                           |
157| ----------------------- | ------------------------------ |
158| OH_VObject *valueObject | 表示指向OH_VObject实例的指针。 |
159
160**返回:**
161
162| 类型 | 说明                                       |
163| ---- | ------------------------------------------ |
164| int  | 返回操作是否成功,出错时返回对应的错误码。 |