harmony 鸿蒙oh_data_values.h

2025-06-12
浏览 (5)

oh_data_values.h

Overview

Defines APIs and enums related to multiple data values.

File to include: <database/data/oh_data_values.h>

Library: libnative_rdb_ndk.z.so

System capability: SystemCapability.DistributedDataManager.RelationalStore.Core

Since: 18

Related module: RDB

Summary

Types

Name	Description
typedef struct OH_Data_Values OH_Data_Values	Defines the OH_Data_Values struct.

Functions

Name	Description
OH_Data_Values * OH_Values_Create (void)	Creates an OH_Data_Values instance to store multiple KV pairs.
int OH_Values_Destroy (OH_Data_Values *values)	Destroys an OH_Data_Values instance.
int OH_Values_Put (OH_Data_Values values, const OH_Data_Value val)	Adds data of the OH_Data_Value type to an OH_Data_Values instance.
int OH_Values_PutNull (OH_Data_Values *values)	Adds empty data to an OH_Data_Values instance.
int OH_Values_PutInt (OH_Data_Values *values, int64_t val)	Adds integer data to an OH_Data_Values instance.
int OH_Values_PutReal (OH_Data_Values *values, double val)	Adds data of the REAL type to an OH_Data_Values instance.
int OH_Values_PutText (OH_Data_Values values, const char val)	Adds data of the string type to an OH_Data_Values instance.
int OH_Values_PutBlob (OH_Data_Values values, const unsigned char val, size_t length)	Adds data of the BLOB type to an OH_Data_Values instance.
int OH_Values_PutAsset (OH_Data_Values values, const Data_Asset val)	Adds data of the ASSET type to an OH_Data_Values instance.
int OH_Values_PutAssets (OH_Data_Values values, const Data_Asset const *val, size_t length)	Adds data of the ASSETS type to an OH_Data_Values instance.
int OH_Values_PutFloatVector (OH_Data_Values values, const float val, size_t length)	Adds data of the float array type to an OH_Data_Values instance.
int OH_Values_PutUnlimitedInt (OH_Data_Values values, int sign, const uint64_t trueForm, size_t length)	Adds an integer array of any length to an OH_Data_Values instance.
int OH_Values_Count (OH_Data_Values values, size_t count)	Obtains the number of values.
int OH_Values_GetType (OH_Data_Values values, int index, OH_ColumnType type)	Obtains the data type.
int OH_Values_Get (OH_Data_Values values, int index, OH_Data_Value *val)	Obtains data of the OH_Data_Value type.
int OH_Values_IsNull (OH_Data_Values values, int index, bool val)	Checks whether a value is null.
int OH_Values_GetInt (OH_Data_Values values, int index, int64_t val)	Obtains integer data.
int OH_Values_GetReal (OH_Data_Values values, int index, double val)	Obtains data of the REAL type.
int OH_Values_GetText (OH_Data_Values values, int index, const char *val)	Obtains data of the string type.
int OH_Values_GetBlob (OH_Data_Values values, int index, const uint8_t val, size_t length)	Obtains data of the BLOB type.
int OH_Values_GetAsset (OH_Data_Values values, int index, Data_Asset val)	Obtains data of the ASSET type.
int OH_Values_GetAssetsCount (OH_Data_Values values, int index, size_t length)	Obtains the length of ASSETS data.
int OH_Values_GetAssets (OH_Data_Values values, int index, Data_Asset val, size_t inLen, size_t outLen)	Obtains data of the ASSETS type.
int OH_Values_GetFloatVectorCount (OH_Data_Values values, int index, size_t length)	Obtains the length of a floating-point array.
int OH_Values_GetFloatVector (OH_Data_Values values, int index, float val, size_t inLen, size_t *outLen)	Obtains data of the floating-point array type.
int OH_Values_GetUnlimitedIntBand (OH_Data_Values values, int index, size_t length)	Obtains the length of an integer of any length.
int OH_Values_GetUnlimitedInt (OH_Data_Values values, int index, int sign, uint64_t trueForm, size_t inLen, size_t outLen)	Obtains integer data of any length.