harmony 鸿蒙OH_Predicates
OH_Predicates
概述
表示谓词。
起始版本: 10
相关模块: RDB
所在头文件: oh_predicates.h
成员变量
名称 | 描述 |
---|---|
int64_t id | H_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 鸿蒙Class (RdbPredicates)
harmony 鸿蒙arkts-apis-data-relationalStore-RdbStore
harmony 鸿蒙Interface (ResultSet)
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦