harmony 鸿蒙OH_Predicates

  • 2025-06-12
  • 浏览 (5)

OH_Predicates

概述

表示谓词。

起始版本: 10

相关模块: RDB

所在头文件: oh_predicates.h

成员变量

名称 描述
int64_t id H_Predicates结构体的唯一标识符。

成员函数

名称 描述
OH_Predicates *(*equalTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段等于指定值的字段。
OH_Predicates *(*notEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段不等于指定值的字段。
该方法等同于SQL语句中的“!=”。
OH_Predicates *(*beginWrap)(OH_Predicates *predicates) 函数指针,向谓词添加左括号。
该方法等同于SQL语句中的“(”。
OH_Predicates *(*endWrap)(OH_Predicates *predicates) 函数指针,向谓词添加右括号。
该方法等同于SQL语句中的“)”。
OH_Predicates *(*orOperate)(OH_Predicates *predicates) 函数指针,将或条件添加到谓词中。
该方法等同于SQL语句中的“OR”。
OH_Predicates *(*andOperate)(OH_Predicates *predicates) 函数指针,向谓词添加和条件。
该方法等同于SQL语句中的“AND”。
OH_Predicates *(*isNull)(OH_Predicates *predicates, const char *field) 函数指针,配置谓词以匹配值为null的字段。
该方法等同于SQL语句中的“IS NULL”。
OH_Predicates *(*isNotNull)(OH_Predicates *predicates, const char *field) 函数指针,配置谓词以匹配值不为null的指定字段。
该方法等同于SQL语句中的“IS NOT NULL”。
OH_Predicates *(*like)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段为field且值类似于指定字符串的字段。
该方法等同于SQL语句中的“LIKE”。
OH_Predicates *(*between)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,将谓词配置为匹配数据字段为field且其值在给定范围内的指定字段。
该方法等同于SQL语句中的“BETWEEN”。
OH_Predicates *(*notBetween)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,将谓词配置为匹配数据字段为field且其值超出给定范围内的指定字段。
该方法等同于SQL语句中的“NOT BETWEEN”。
OH_Predicates *(*greaterThan)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段为field且值大于指定值valueObject的字段。
该方法等同于SQL语句中的“>”。
OH_Predicates *(*lessThan)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段为field且值小于指定值valueObject的字段。
该方法等同于SQL语句中的“<”。
OH_Predicates *(*greaterThanOrEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段为field且值大于或等于指定值valueObject的字段。
该方法等同于SQL语句中的“>=”。
OH_Predicates *(*lessThanOrEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段为field且值小于或等于指定值valueObject的字段。
该方法等同于SQL语句中的“<=”。
OH_Predicates *(*orderBy)(OH_Predicates *predicates, const char *field, OH_OrderType type) 函数指针,配置谓词以匹配其值按升序或降序排序的列。
该方法等同于SQL语句中的“ORDER BY”。
OH_Predicates *(*distinct)(OH_Predicates *predicates) 函数指针,配置谓词以过滤重复记录并仅保留其中一个。
该方法等同于SQL语句中的“DISTINCT”。
OH_Predicates *(*limit)(OH_Predicates *predicates, unsigned int value) 函数指针,设置最大数据记录数的谓词。
该方法等同于SQL语句中的“LIMIT”。
OH_Predicates *(*offset)(OH_Predicates *predicates, unsigned int rowOffset) 函数指针,配置谓词以指定返回结果的起始位置。
该方法等同于SQL语句中的“OFFSET”。
OH_Predicates *(*groupBy)(OH_Predicates *predicates, char const *const *fields, int length) 函数指针,配置R谓词按指定列分组查询结果。
该方法等同于SQL语句中的“GROUP BY”。
OH_Predicates *(*in)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段为field且值在给定范围内的指定字段。
该方法等同于SQL语句中的“IN”。
OH_Predicates *(*notIn)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject) 函数指针,配置谓词以匹配数据字段为field且值超出给定范围内的指定字段。
该方法等同于SQL语句中的“NOT IN”。
OH_Predicates *(*clear)(OH_Predicates *predicates) 函数指针,清空谓词。
int (*destroy)(OH_Predicates *predicates) 销毁OH_Predicates对象,并回收该对象占用的内存。

成员函数说明

equalTo()

OH_Predicates *(*equalTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段等于指定值的字段。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

notEqualTo()

OH_Predicates *(*notEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段不等于指定值的字段。
该方法等同于SQL语句中的“!=”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

beginWrap()

OH_Predicates *(*beginWrap)(OH_Predicates *predicates)

描述

函数指针,向谓词添加左括号。
该方法等同于SQL语句中的“(”。

起始版本: 10

参数:

参数项 描述
H_Predicates *predicates 表示指向OH_Predicates实例的指针。

返回:

类型 说明
OH_Predicates * 返回带有左括号的谓词。

endWrap()

OH_Predicates *(*endWrap)(OH_Predicates *predicates)

描述

函数指针,向谓词添加右括号。
该方法等同于SQL语句中的“)”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。

返回:

类型 说明
OH_Predicates * 返回带有右括号的谓词。

orOperate()

OH_Predicates *(*orOperate)(OH_Predicates *predicates)

描述

函数指针,将或条件添加到谓词中。
该方法等同于SQL语句中的“OR”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。

返回:

类型 说明
OH_Predicates * 返回带有或条件的谓词。

andOperate()

OH_Predicates *(*andOperate)(OH_Predicates *predicates)

描述

函数指针,向谓词添加和条件。
该方法等同于SQL语句中的“AND”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。

返回:

类型 说明
OH_Predicates * 返回带有和条件的谓词。

isNull()

OH_Predicates *(*isNull)(OH_Predicates *predicates, const char *field)

描述

函数指针,配置谓词以匹配值为null的字段。
该方法等同于SQL语句中的“IS NULL”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

isNotNull()

OH_Predicates *(*isNotNull)(OH_Predicates *predicates, const char *field)

描述

函数指针,配置谓词以匹配值不为null的指定字段。
该方法等同于SQL语句中的“IS NOT NULL”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

like()

OH_Predicates *(*like)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段为field且值类似于指定字符串的字段。
该方法等同于SQL语句中的“LIKE”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

between()

OH_Predicates *(*between)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,将谓词配置为匹配数据字段为field且其值在给定范围内的指定字段。
该方法等同于SQL语句中的“BETWEEN”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

notBetween()

OH_Predicates *(*notBetween)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,将谓词配置为匹配数据字段为field且其值超出给定范围内的指定字段。
该方法等同于SQL语句中的“NOT BETWEEN”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

greaterThan()

OH_Predicates *(*greaterThan)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段为field且值大于指定值valueObject的字段。
该方法等同于SQL语句中的“>”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

lessThan()

OH_Predicates *(*lessThan)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段为field且值小于指定值valueObject的字段。
该方法等同于SQL语句中的“<”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

greaterThanOrEqualTo()

OH_Predicates *(*greaterThanOrEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段为field且值大于或等于指定值valueObject的字段。
该方法等同于SQL语句中的“>=”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

lessThanOrEqualTo()

OH_Predicates *(*lessThanOrEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段为field且值小于或等于指定值valueObject的字段。
该方法等同于SQL语句中的“<=”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

orderBy()

OH_Predicates *(*orderBy)(OH_Predicates *predicates, const char *field, OH_OrderType type)

描述

函数指针,配置谓词以匹配其值按升序或降序排序的列。
该方法等同于SQL语句中的“ORDER BY”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 数据库表中的列名。
OH_VObject type 表示排序类型OH_VObject

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

distinct()

OH_Predicates *(*distinct)(OH_Predicates *predicates)

描述

函数指针,配置谓词以过滤重复记录并仅保留其中一个。
该方法等同于SQL语句中的“DISTINCT”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。

返回:

类型 说明
OH_Predicates * 返回可用于过滤重复记录的谓词。

limit()

OH_Predicates *(*limit)(OH_Predicates *predicates, unsigned int value)

描述

函数指针,设置最大数据记录数的谓词。
该方法等同于SQL语句中的“LIMIT”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
unsigned int value 表示最大数据记录数。

返回:

类型 说明
OH_Predicates * 返回可用于设置最大数据记录数的谓词。

offset()

OH_Predicates *(*offset)(OH_Predicates *predicates, unsigned int rowOffset)

描述

函数指针,配置谓词以指定返回结果的起始位置。
该方法等同于SQL语句中的“OFFSET”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
unsigned int rowOffset 返回结果的起始位置,取值为正整数。

返回:

类型 说明
OH_Predicates * 返回具有指定返回结果起始位置的谓词。

groupBy()

OH_Predicates *(*groupBy)(OH_Predicates *predicates, char const *const *fields, int length)

描述

函数指针,配置R谓词按指定列分组查询结果。
该方法等同于SQL语句中的“GROUP BY”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
char const *const *fields 指定分组依赖的列名。
int length 该参数为输入参数,表示开发者传入的fields数值的长度。

返回:

类型 说明
OH_Predicates * 返回分组查询列的谓词。

in()

OH_Predicates *(*in)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段为field且值在给定范围内的指定字段。
该方法等同于SQL语句中的“IN”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 表示数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

notIn()

OH_Predicates *(*notIn)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject)

描述

函数指针,配置谓词以匹配数据字段为field且值超出给定范围内的指定字段。
该方法等同于SQL语句中的“NOT IN”。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。
const char *field 表示数据库表中的列名。
OH_VObject *valueObject 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。

返回:

类型 说明
OH_Predicates * 返回与指定字段匹配的谓词。

clear()

OH_Predicates *(*clear)(OH_Predicates *predicates)

描述

函数指针,清空谓词。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。

返回:

类型 说明
OH_Predicates * 返回清空后的谓词。

destroy()

int (*destroy)(OH_Predicates *predicates)

描述

销毁OH_Predicates对象,并回收该对象占用的内存。

起始版本: 10

参数:

参数项 描述
OH_Predicates *predicates 表示指向OH_Predicates实例的指针。

返回:

类型 说明
int 返回操作是否成功,出错时返回对应的错误码。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkData(方舟数据管理)

harmony 鸿蒙Class (RdbPredicates)

harmony 鸿蒙arkts-apis-data-relationalStore-RdbStore

harmony 鸿蒙Interface (ResultSet)

harmony 鸿蒙Interface (Transaction)

harmony 鸿蒙Enums

harmony 鸿蒙Functions

harmony 鸿蒙Interfaces (其他)

harmony 鸿蒙Types

harmony 鸿蒙模块描述

0  赞