harmony 鸿蒙oh_predicates.h

2025-06-12
浏览 (3)

oh_predicates.h

概述

表示关系型数据库（RDB）的谓词。

引用文件：

库： libnative_rdb_ndk.z.so

系统能力： SystemCapability.DistributedDataManager.RelationalStore.Core

起始版本： 10

相关模块： RDB

汇总

结构体

名称	typedef关键字	描述
OH_Predicates	OH_Predicates	表示谓词。

枚举

名称	typedef关键字	描述
OH_OrderType	OH_OrderType	排序方式。

函数

名称	描述
int OH_Predicates_NotLike(OH_Predicates predicates, const char field, const char *pattern)	设置OH_Predicates以匹配数据类型为字符串且值不类似于指定值的字段。此方法类似于SQL语句中的“Not like”。
int OH_Predicates_Glob(OH_Predicates predicates, const char field, const char *pattern)	设置OH_Predicates以匹配指定字段（数据类型为字符串）且值包含通配符的字段。与like方法不同，此方法的输入参数区分大小写。
int OH_Predicates_NotGlob(OH_Predicates predicates, const char field, const char *pattern)	设置OH_Predicates以不匹配指定字段（数据类型为字符串）且值包含通配符的字段。与Not Like方法不同，此方法的输入参数区分大小写。
int OH_Predicates_Having(OH_Predicates predicates, const char conditions, const OH_Data_Values *values)	设置OH_Predicates以指定条件来过滤分组结果，这些结果将出现在最终结果中。

枚举类型说明

OH_OrderType

enum OH_OrderType

描述

排序方式。

起始版本： 10

枚举项	描述
ASC = 0	升序排列。
DESC = 1	降序排列。

函数说明

OH_Predicates_NotLike()

int OH_Predicates_NotLike(OH_Predicates *predicates, const char *field, const char *pattern)

描述

设置OH_Predicates以匹配数据类型为字符串且值不类似于指定值的字段。
此方法类似于SQL语句中的“Not like”。

起始版本： 20

参数：

参数项	描述
OH_Predicates *predicates	表示指向OH_Predicates实例的指针。
const char *field	表示数据库表中的列名。
const char *pattern	表示谓词不匹配的模式。

返回：

类型	说明
int	返回执行结果。如果执行成功，返回RDB_OK。如果输入参数无效，返回RDB_E_INVALID_ARGS。

OH_Predicates_Glob()

int OH_Predicates_Glob(OH_Predicates *predicates, const char *field, const char *pattern)

描述

设置OH_Predicates以匹配指定字段（数据类型为字符串）且值包含通配符的字段。
与like方法不同，此方法的输入参数区分大小写。

起始版本： 20

参数：

参数项	描述
OH_Predicates *predicates	表示指向OH_Predicates实例的指针。
const char *field	表示数据库表中的列名。
const char *pattern	表示谓词匹配的样式。

返回：

类型	说明
int	返回执行结果。如果执行成功，返回RDB_OK。如果输入参数无效，返回RDB_E_INVALID_ARGS。

OH_Predicates_NotGlob()

int OH_Predicates_NotGlob(OH_Predicates *predicates, const char *field, const char *pattern)

描述

设置OH_Predicates以不匹配指定字段（数据类型为字符串）且值包含通配符的字段。
与Not Like方法不同，此方法的输入参数区分大小写。

起始版本： 20

参数：

参数项	描述
OH_Predicates *predicates	表示指向OH_Predicates实例的指针。
const char *field	表示数据库表中的列名。
const char *pattern	表示谓词不匹配的样式。

返回：

类型	说明
int	返回执行结果。如果执行成功，返回RDB_OK。如果输入参数无效，返回RDB_E_INVALID_ARGS。

OH_Predicates_Having()

int OH_Predicates_Having(OH_Predicates *predicates, const char *conditions, const OH_Data_Values *values)

描述

设置OH_Predicates以指定条件来过滤分组结果，这些结果将出现在最终结果中。

起始版本： 20

参数：

参数项	描述
OH_Predicates *predicates	表示指向OH_Predicates实例的指针。
const char *conditions	表示having子句中的过滤条件。
const OH_Data_Values *values	表示指向OH_Data_Values实例的指针。