智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
OH_Predicates
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
本文导读
typedef struct {...} OH_Predicates 成员变量
展开
| 名称 | 描述 |
|---|---|
| int64_t id | OH_Predicates结构体的唯一标识符。 |
成员函数
展开
成员函数说明
equalTo()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*beginWrap)(OH_Predicates *predicates)
描述
函数指针，向谓词添加左括号。
该方法等同于SQL语句中的“(”。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回带有左括号的谓词。 |
endWrap()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*endWrap)(OH_Predicates *predicates)
描述
函数指针，向谓词添加右括号。
该方法等同于SQL语句中的“)”。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回带有右括号的谓词。 |
orOperate()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*orOperate)(OH_Predicates *predicates)
描述
函数指针，将或条件添加到谓词中。
该方法等同于SQL语句中的“OR”。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回带有或条件的谓词。 |
andOperate()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*andOperate)(OH_Predicates *predicates)
描述
函数指针，向谓词添加和条件。
该方法等同于SQL语句中的“AND”。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回带有和条件的谓词。 |
isNull()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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_OrderType type | 排序类型。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回与指定字段匹配的谓词。 |
distinct()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*distinct)(OH_Predicates *predicates)
描述
函数指针，配置谓词以过滤重复记录并仅保留其中一个。
该方法等同于SQL语句中的“DISTINCT”。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回可用于过滤重复记录的谓词。 |
limit()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*limit)(OH_Predicates *predicates, unsigned int value)
描述
函数指针，设置最大数据记录数的谓词。
该方法等同于SQL语句中的“LIMIT”。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
| unsigned int value | 表示最大数据记录数。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回可用于设置最大数据记录数的谓词。 |
offset()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*offset)(OH_Predicates *predicates, unsigned int rowOffset)
描述
函数指针，配置谓词以指定返回结果的起始位置。
该方法等同于SQL语句中的“OFFSET”。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
| unsigned int rowOffset | 返回结果的起始位置，取值为正整数。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回具有指定返回结果起始位置的谓词。 |
groupBy()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*groupBy)(OH_Predicates *predicates, char const *const *fields, int length)
描述
函数指针，配置谓词按指定列分组查询结果。
该方法等同于SQL语句中的“GROUP BY”。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
| char const *const *fields | 指定分组依赖的列名，不能为空指针。 |
| int length | 该参数为输入参数，表示fields数组的长度。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回分组查询列的谓词。 |
in()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
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()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
OH_Predicates *(*clear)(OH_Predicates *predicates)
描述
函数指针，清空谓词。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_Predicates * | 返回清空后的谓词。 |
destroy()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
int (*destroy)(OH_Predicates *predicates)
描述
销毁OH_Predicates对象，并回收该对象占用的内存。
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_Predicates *predicates | 表示指向OH_Predicates实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| int | 返回操作是否成功，出错时返回对应的错误码。详细信息请参阅OH_Rdb_ErrCode。 |
华为开发者联盟 版权所有 ©2026
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词