harmony 鸿蒙RDB
RDB
概述
关系型数据库(Relational Database,RDB)是一种基于关系模型来管理数据的数据库。关系型数据库基于SQLite组件提供了一套完整的 对本地数据库进行管理的机制,对外提供了一系列的增、删、改、查等接口,也可以直接运行用户输入的SQL语句来满足复杂的场景需要。
\@SystemCapability.DistributedDataManager.RelationalStore.Core
起始版本:
10
汇总
文件
名称 | 描述 |
---|---|
oh_cursor.h | 提供通过查询数据库生成的数据库结果集的访问方法。 引用文件:<database/rdb/oh_cursor.h> 库:native_rdb_ndk_header.so |
oh_predicates.h | 表示关系型数据库(RDB)的谓词。 引用文件:<database/rdb/oh_predicates.h> 库:native_rdb_ndk_header.so |
oh_value_object.h | 提供类型转换方法。 引用文件:<database/rdb/oh_value_object.h> 库:native_rdb_ndk_header.so |
oh_values_bucket.h | 用于存储键值对的类型。 引用文件:<database/rdb/oh_values_bucket.h> 库:native_rdb_ndk_header.so |
relational_store.h | 提供管理关系数据库(RDB)方法的接口。 引用文件:<database/rdb/relational_store.h> 库:native_rdb_ndk_header.so |
relational_store_error_code.h | 声明关系型数据库(RDB)的错误码信息。 引用文件:<database/rdb/relational_error_code.h> 库:native_rdb_ndk_header.so |
结构体
名称 | 描述 |
---|---|
OH_Cursor | 表示结果集。 |
OH_Predicates | 表示谓词。 |
OH_VObject | 表示允许的数据字段类型。 |
OH_VBucket | 用于存储键值对的类型。 |
OH_Rdb_Config | 管理关系数据库配置。 |
OH_Rdb_Store | 表示数据库类型。 |
类型定义
名称 | 描述 |
---|---|
OH_ColumnType | 数据库字段类型。 |
OH_Cursor | 表示结果集。 |
OH_OrderType | 排序方式。 |
OH_Predicates | 表示谓词。 |
OH_VObject | 表示允许的数据字段类型。 |
OH_VBucket | 用于存储键值对的类型。 |
OH_Rdb_SecurityLevel | 数据库的安全级别枚举。 |
OH_Rdb_ErrCode | 表示错误码信息。 |
枚举
名称 | 描述 |
---|---|
OH_ColumnType { TYPE_NULL = 0, TYPE_INT64, TYPE_REAL, TYPE_TEXT, TYPE_BLOB } |
数据库字段类型。 |
OH_OrderType { ASC = 0, DESC = 1 } | 排序方式。 |
OH_Rdb_SecurityLevel { S1 = 1, S2, S3, S4 } | 数据库的安全级别枚举。 |
OH_Rdb_ErrCode { RDB_ERR = -1, RDB_OK = 0, E_BASE = 14800000, RDB_E_NOT_SUPPORTED = 801, RDB_E_ERROR = E_BASE, RDB_E_INVALID_ARGS = (E_BASE + 1), RDB_E_CANNOT_UPDATE_READONLY = (E_BASE + 2), RDB_E_REMOVE_FILE = (E_BASE + 3), RDB_E_EMPTY_TABLE_NAME = (E_BASE + 5), RDB_E_EMPTY_VALUES_BUCKET = (E_BASE + 6), RDB_E_EXECUTE_IN_STEP_QUERY = (E_BASE + 7), RDB_E_INVALID_COLUMN_INDEX = (E_BASE + 8), RDB_E_INVALID_COLUMN_TYPE = (E_BASE + 9), RDB_E_EMPTY_FILE_NAME = (E_BASE + 10), RDB_E_INVALID_FILE_PATH = (E_BASE + 11), RDB_E_TRANSACTION_IN_EXECUTE = (E_BASE + 12), RDB_E_INVALID_STATEMENT = (E_BASE + 13), RDB_E_EXECUTE_WRITE_IN_READ_CONNECTION = (E_BASE + 14), RDB_E_BEGIN_TRANSACTION_IN_READ_CONNECTION = (E_BASE + 15), RDB_E_NO_TRANSACTION_IN_SESSION = (E_BASE + 16), RDB_E_MORE_STEP_QUERY_IN_ONE_SESSION = (E_BASE + 17), RDB_E_NO_ROW_IN_QUERY = (E_BASE + 18), RDB_E_INVALID_BIND_ARGS_COUNT = (E_BASE + 19), RDB_E_INVALID_OBJECT_TYPE = (E_BASE + 20), RDB_E_INVALID_CONFLICT_FLAG = (E_BASE + 21), RDB_E_HAVING_CLAUSE_NOT_IN_GROUP_BY = (E_BASE + 22), RDB_E_NOT_SUPPORTED_BY_STEP_RESULT_SET = (E_BASE + 23), RDB_E_STEP_RESULT_SET_CROSS_THREADS = (E_BASE + 24), RDB_E_STEP_RESULT_QUERY_NOT_EXECUTED = (E_BASE + 25), RDB_E_STEP_RESULT_IS_AFTER_LAST = (E_BASE + 26), RDB_E_STEP_RESULT_QUERY_EXCEEDED = (E_BASE + 27), RDB_E_STATEMENT_NOT_PREPARED = (E_BASE + 28), RDB_E_EXECUTE_RESULT_INCORRECT = (E_BASE + 29), RDB_E_STEP_RESULT_CLOSED = (E_BASE + 30), RDB_E_RELATIVE_PATH = (E_BASE + 31), RDB_E_EMPTY_NEW_ENCRYPT_KEY = (E_BASE + 32), RDB_E_CHANGE_UNENCRYPTED_TO_ENCRYPTED = (E_BASE + 33), RDB_E_CHANGE_ENCRYPT_KEY_IN_BUSY = (E_BASE + 34), RDB_E_STEP_STATEMENT_NOT_INIT = (E_BASE + 35), RDB_E_NOT_SUPPORTED_ATTACH_IN_WAL_MODE = (E_BASE + 36), RDB_E_CREATE_FOLDER_FAIL = (E_BASE + 37), RDB_E_SQLITE_SQL_BUILDER_NORMALIZE_FAIL = (E_BASE + 38), RDB_E_STORE_SESSION_NOT_GIVE_CONNECTION_TEMPORARILY = (E_BASE + 39), RDB_E_STORE_SESSION_NO_CURRENT_TRANSACTION = (E_BASE + 40), RDB_E_NOT_SUPPORT = (E_BASE + 41), RDB_E_INVALID_PARCEL = (E_BASE + 42), RDB_E_QUERY_IN_EXECUTE = (E_BASE + 43), RDB_E_SET_PERSIST_WAL = (E_BASE + 44), RDB_E_DB_NOT_EXIST = (E_BASE + 45), RDB_E_ARGS_READ_CON_OVERLOAD = (E_BASE + 46), RDB_E_WAL_SIZE_OVER_LIMIT = (E_BASE + 47), RDB_E_CON_OVER_LIMIT = (E_BASE + 48) } |
表示错误码信息。 |
函数
名称 | 描述 |
---|---|
OH_Rdb_CreateValueObject (void) | 创建OH_VObject实例。 |
OH_Rdb_CreateValuesBucket (void) | 创建OH_VBucket实例。 |
OH_Rdb_CreatePredicates (const char *table) | 创建OH_Predicates实例。 |
OH_Rdb_GetOrOpen (const OH_Rdb_Config *config, int *errCode) | 获得一个相关的OH_Rdb_Store实例,操作关系型数据库。 |
OH_Rdb_CloseStore (OH_Rdb_Store *store) | 销毁OH_Rdb_Store对象,并回收该对象占用的内存。 |
OH_Rdb_DeleteStore (const OH_Rdb_Config *config) | 使用指定的数据库文件配置删除数据库。 |
OH_Rdb_Insert (OH_Rdb_Store *store, const char *table, OH_VBucket *valuesBucket) | 向目标表中插入一行数据。 |
OH_Rdb_Update (OH_Rdb_Store *store, OH_VBucket *valuesBucket, OH_Predicates *predicates) | 根据指定的条件更新数据库中的数据。 |
OH_Rdb_Delete (OH_Rdb_Store *store, OH_Predicates *predicates) | 根据指定的条件删除数据库中的数据。 |
OH_Rdb_Query (OH_Rdb_Store *store, OH_Predicates *predicates, const char *const *columnNames, int length) | 根据指定条件查询数据库中的数据 |
OH_Rdb_Execute (OH_Rdb_Store *store, const char *sql) | 执行无返回值的SQL语句。 |
OH_Rdb_ExecuteQuery (OH_Rdb_Store *store, const char *sql) | 根据指定SQL语句查询数据库中的数据。 |
OH_Rdb_BeginTransaction (OH_Rdb_Store *store) | 在开始执行SQL语句之前,开始事务。 |
OH_Rdb_RollBack (OH_Rdb_Store *store) | 回滚已经执行的SQL语句。 |
OH_Rdb_Commit (OH_Rdb_Store *store) | 提交已执行的SQL语句 |
OH_Rdb_Backup (OH_Rdb_Store *store, const char *databasePath) | 以指定路径备份数据库。 |
OH_Rdb_Restore (OH_Rdb_Store *store, const char *databasePath) | 从指定的数据库备份文件恢复数据库。 |
OH_Rdb_GetVersion (OH_Rdb_Store *store, int *version) | 获取数据库版本。 |
OH_Rdb_SetVersion (OH_Rdb_Store *store, int version) | 设置数据库版本。 |
变量
名称 | 描述 |
---|---|
OH_Cursor::id | OH_Cursor结构体的唯一标识符。 |
OH_Cursor::getColumnCount | 函数指针,获取结果集中的列数。 |
OH_Cursor::getColumnType | 函数指针,根据指定的列索引获取列类型。 |
OH_Cursor::getColumnIndex | 函数指针,根据指定的列名获取列索引。 |
OH_Cursor::getColumnName | 函数指针,根据指定的列索引获取列名。 |
OH_Cursor::getRowCount | 函数指针,获取结果集中的行数。 |
OH_Cursor::goToNextRow | 函数指针,转到结果集的下一行。 |
OH_Cursor::getSize | 函数指针,当结果集中列的数据类型是BLOB或者TEXT时,获取其值所需的内存。 |
OH_Cursor::getText | 函数指针,以字符串形式获取当前行中指定列的值。 |
OH_Cursor::getInt64 | 函数指针,以int64_t形式获取当前行中指定列的值。 |
OH_Cursor::getReal | 函数指针,以double形式获取当前行中指定列的值。 |
OH_Cursor::getBlob | 函数指针,以字节数组的形式获取当前行中指定列的值。 |
OH_Cursor::isNull | 函数指针,检查当前行中指定列的值是否为null。 |
OH_Cursor::destroy | 函数指针,关闭结果集。 |
OH_Predicates::id | OH_Predicates结构体的唯一标识符。 |
OH_Predicates::equalTo | 函数指针,配置谓词以匹配数据字段等于指定值的字段。 |
OH_Predicates::notEqualTo | 函数指针,配置谓词以匹配数据字段不等于指定值的字段。 |
OH_Predicates::beginWrap | 函数指针,向谓词添加左括号。 |
OH_Predicates::endWrap | 函数指针,向谓词添加右括号。 |
OH_Predicates::orOperate | 函数指针,将或条件添加到谓词中。 |
OH_Predicates::andOperate | 函数指针,向谓词添加和条件。 |
OH_Predicates::isNull | 函数指针,配置谓词以匹配值为null的字段。 |
OH_Predicates::isNotNull | 函数指针,配置谓词以匹配值不为null的指定字段。 |
OH_Predicates::like | 函数指针,配置谓词以匹配数据字段为field且值类似于指定字符串的字段。 |
OH_Predicates::between | 函数指针,将谓词配置为匹配数据字段为field且其值在给定范围内的指定字段。 |
OH_Predicates::notBetween | 函数指针,将谓词配置为匹配数据字段为field且其值超出给定范围内的指定字段。 |
OH_Predicates::greaterThan | 函数指针,配置谓词以匹配数据字段为field且值大于指定值valueObject的字段。 |
OH_Predicates::lessThan | 函数指针,配置谓词以匹配数据字段为field且值小于指定值valueObject的字段。 |
OH_Predicates::greaterThanOrEqualTo | 函数指针,配置谓词以匹配数据字段为field且值大于或等于指定值valueObject的字段。 |
OH_Predicates::lessThanOrEqualTo | 函数指针,配置谓词以匹配数据字段为field且值小于或等于指定值valueObject的字段。 |
OH_Predicates::orderBy | 函数指针,配置谓词以匹配其值按升序或降序排序的列。 |
OH_Predicates::distinct | 函数指针,配置谓词以过滤重复记录并仅保留其中一个。 |
OH_Predicates::limit | 函数指针,设置最大数据记录数的谓词。 |
OH_Predicates::offset | 函数指针,配置谓词以指定返回结果的起始位置。 |
OH_Predicates::groupBy | 函数指针,配置R谓词按指定列分组查询结果。 |
OH_Predicates::in | 函数指针,配置谓词以匹配数据字段为field且值在给定范围内的指定字段。 |
OH_Predicates::notIn | 函数指针,配置谓词以匹配数据字段为field且值超出给定范围内的指定字段。 |
OH_Predicates::clear | 函数指针,清空谓词。 |
OH_Predicates::destroy | 销毁OH_Predicates对象,并回收该对象占用的内存。 |
OH_VObject::id | OH_VObject结构体的唯一标识符。 |
OH_VObject::putInt64 | 将int64类型的单个参数或者数组转换为OH_VObject类型的值。 |
OH_VObject::putDouble | 将double类型的单个参数或者数组转换为OH_VObject类型的值。 |
OH_VObject::putText | 将char *类型的字符数组转换为OH_VObject类型的值。 |
OH_VObject::putTexts | 将char *类型的字符串数组转换为OH_VObject类型的值。 |
OH_VObject::destroy | 销毁OH_VObject对象,并回收该对象占用的内存。 |
OH_VBucket::id | OH_VBucket结构体的唯一标识符。 |
OH_VBucket::capability | 表示结构体的存储键值对的数量 |
OH_VBucket::putText | 将char*值放入给定列名的OH_VBucket对象中。 |
OH_VBucket::putInt64 | 将int64_t值放入给定列名的OH_VBucket对象中。 |
OH_VBucket::putReal | 将double值放入给定列名的OH_VBucket对象中。 |
OH_VBucket::putBlob | 将const uint8_t *值放入给定列名的OH_VBucket对象中。 |
OH_VBucket::putNull | 将NULL值放入给定列名的OH_VBucket对象中。 |
OH_VBucket::clear | 清空OH_VBucket对象。 |
OH_VBucket::destroy | 销毁OH_VBucket对象,并回收该对象占用的内存。 |
OH_Rdb_Config::selfSize | 该结构体的大小。 |
OH_Rdb_Config::dataBaseDir | 数据库文件路径。 |
OH_Rdb_Config::storeName | 数据库名称。 |
OH_Rdb_Config::bundleName | 应用包名。 |
OH_Rdb_Config::moduleName | 应用模块名。 |
OH_Rdb_Config::isEncrypt | 指定数据库是否加密。 |
OH_Rdb_Config::securityLevel | 设置数据库安全级别OH_Rdb_SecurityLevel。 |
OH_Rdb_Store::id | OH_Rdb_Store结构体的唯一标识符。 |
类型定义说明
OH_ColumnType
typedef enum OH_ColumnType OH_ColumnType
描述:
数据库字段类型.
OH_Cursor
typedef struct OH_Cursor OH_Cursor
描述:
表示结果集。
提供通过查询数据库生成的数据库结果集的访问方法。
OH_OrderType
typedef enum OH_OrderType OH_OrderType
描述:
排序方式。
OH_Predicates
typedef struct OH_Predicates OH_Predicates
描述:
表示谓词。
OH_Rdb_ErrCode
typedef enum OH_Rdb_ErrCode OH_Rdb_ErrCode
描述:
表示错误码信息。
OH_Rdb_SecurityLevel
typedef enum OH_Rdb_SecurityLevel OH_Rdb_SecurityLevel
描述:
数据库的安全级别枚举。
OH_VBucket
typedef struct OH_VBucket OH_VBucket
描述:
用于存储键值对的类型。
OH_VObject
typedef struct OH_VObject OH_VObject
描述:
表示允许的数据字段类型。
枚举类型说明
OH_ColumnType
enum OH_ColumnType
描述:
数据库字段类型。
枚举值 | 描述 |
---|---|
TYPE_NULL | 表示NULL类型。 |
TYPE_INT64 | 表示INT64数据类型。 |
TYPE_REAL | 表示REAL数据类型。 |
TYPE_TEXT | 表示TEXT数据类型。 |
TYPE_BLOB | 表示BLOB数据类型。 |
OH_OrderType
enum OH_OrderType
描述:
排序方式。
枚举值 | 描述 |
---|---|
ASC | 升序排列。 |
DESC | 降序排列。 |
OH_Rdb_ErrCode
enum OH_Rdb_ErrCode
描述:
表示错误码信息。
枚举值 | 描述 |
---|---|
RDB_ERR | 执行出错。 |
RDB_OK | 执行成功。 |
E_BASE | 异常错误代码的基础。 |
RDB_E_NOT_SUPPORTED | RDB不具备该能力。 |
RDB_E_ERROR | 常见异常的错误代码。 |
RDB_E_INVALID_ARGS | 参数非法。 |
RDB_E_CANNOT_UPDATE_READONLY | 更新只读数据库。 |
RDB_E_REMOVE_FILE | 删除文件失败。 |
RDB_E_EMPTY_TABLE_NAME | 表名为空。 |
RDB_E_EMPTY_VALUES_BUCKET | 键值对内容为空。 |
RDB_E_EXECUTE_IN_STEP_QUERY | 查询时执行的SQL语句错误。 |
RDB_E_INVALID_COLUMN_INDEX | 列索引非法. |
RDB_E_INVALID_COLUMN_TYPE | 列类型非法. |
RDB_E_EMPTY_FILE_NAME | 文件名称为空。 |
RDB_E_INVALID_FILE_PATH | 文件路径非法。 |
RDB_E_TRANSACTION_IN_EXECUTE | 开启事务执行出错, |
RDB_E_INVALID_STATEMENT | SQL语句预编译出错. |
RDB_E_EXECUTE_WRITE_IN_READ_CONNECTION | 在读连接中执行写操作。 |
RDB_E_BEGIN_TRANSACTION_IN_READ_CONNECTION | 在读连接中开启事务。 |
RDB_E_NO_TRANSACTION_IN_SESSION | 在数据库会话中不存在开启的事务. |
RDB_E_MORE_STEP_QUERY_IN_ONE_SESSION | 在一个数据库会话中执行多次查询。 |
RDB_E_NO_ROW_IN_QUERY | 查询得到的结果集不存在任何记录。 |
RDB_E_INVALID_BIND_ARGS_COUNT | SQL语句中绑定的参数个数非法。 |
RDB_E_INVALID_OBJECT_TYPE | 对象类型非法。 |
RDB_E_INVALID_CONFLICT_FLAG | 冲突解决类型非法。 |
RDB_E_HAVING_CLAUSE_NOT_IN_GROUP_BY | HAVING关键字只能用于GROUP BY之后. |
RDB_E_NOT_SUPPORTED_BY_STEP_RESULT_SET | 不支持step形式数据库结果集。 |
RDB_E_STEP_RESULT_SET_CROSS_THREADS | 结果集查询出错。 |
RDB_E_STEP_RESULT_QUERY_NOT_EXECUTED | 结果集查询语句未被执行。 |
RDB_E_STEP_RESULT_IS_AFTER_LAST | 结果集的游标已经处于最后一行。 |
RDB_E_STEP_RESULT_QUERY_EXCEEDED | 结果集查询次数已经超过上限。 |
RDB_E_STATEMENT_NOT_PREPARED | SQL语句未被预编译。 |
RDB_E_EXECUTE_RESULT_INCORRECT | 数据库执行结果异常. |
RDB_E_STEP_RESULT_CLOSED | 结果集已经关闭。 |
RDB_E_RELATIVE_PATH | 相对路径。 |
RDB_E_EMPTY_NEW_ENCRYPT_KEY | 新的密钥文件为空。 |
RDB_E_CHANGE_UNENCRYPTED_TO_ENCRYPTED | 将非加密的数据库更改为加密数据库。 |
RDB_E_CHANGE_ENCRYPT_KEY_IN_BUSY | 在数据库繁忙时更新数据库密钥。 |
RDB_E_STEP_STATEMENT_NOT_INIT | 预编译的SQL语句未被初始化。 |
RDB_E_NOT_SUPPORTED_ATTACH_IN_WAL_MODE | 在WAL日志模式下不支持ATTACH操作。 |
RDB_E_CREATE_FOLDER_FAIL | 创建文件夹失败。 |
RDB_E_SQLITE_SQL_BUILDER_NORMALIZE_FAIL | SQL语句构建失败。 |
RDB_E_STORE_SESSION_NOT_GIVE_CONNECTION_TEMPORARILY | 数据库会话暂未提供连接。 |
RDB_E_STORE_SESSION_NO_CURRENT_TRANSACTION | 数据库会话不具有当前的事务。 |
RDB_E_NOT_SUPPORT | 不支持当前操作。 |
RDB_E_INVALID_PARCEL | 当前PARCEL非法。 |
RDB_E_QUERY_IN_EXECUTE | 执行query查询出错。 |
RDB_E_SET_PERSIST_WAL | 设置WAL模式下数据库文件的持久化时出错。 |
RDB_E_DB_NOT_EXIST | 数据库不存在。 |
RDB_E_ARGS_READ_CON_OVERLOAD | 设置的读连接数大于上限。 |
RDB_E_WAL_SIZE_OVER_LIMIT | WAL日志文件大小超过默认值。 |
RDB_E_CON_OVER_LIMIT | 数据库连接数已用完。 |
OH_Rdb_SecurityLevel
enum OH_Rdb_SecurityLevel
描述:
数据库的安全级别枚举。
枚举值 | 描述 |
---|---|
S1 | S1: 表示数据库的安全级别为低级别。 当数据泄露时会产生较低影响。 |
S2 | S2: 表示数据库的安全级别为中级别。 当数据泄露时会产生较大影响。 |
S3 | S3: 表示数据库的安全级别为高级别。 当数据泄露时会产生重大影响。 |
S4 | S4: 表示数据库的安全级别为关键级别。 当数据泄露时会产生严重影响。 |
函数说明
OH_Rdb_Backup()
int OH_Rdb_Backup (OH_Rdb_Store * store, const char * databasePath )
描述:
以指定路径备份数据库。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
databasePath | 指定数据库的备份文件路径。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_BeginTransaction()
int OH_Rdb_BeginTransaction (OH_Rdb_Store * store)
描述:
在开始执行SQL语句之前,开始事务。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_CloseStore()
int OH_Rdb_CloseStore (OH_Rdb_Store * store)
描述:
销毁OH_Rdb_Store对象,并回收该对象占用的内存。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_Commit()
int OH_Rdb_Commit (OH_Rdb_Store * store)
描述:
提交已执行的SQL语句
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_CreatePredicates()
OH_Predicates* OH_Rdb_CreatePredicates (const char * table)
描述:
创建OH_Predicates实例。
参数:
名称 | 描述 |
---|---|
table | 表示数据库表名。 |
返回:
创建成功则返回一个指向OH_Predicates结构体实例的指针,否则返回NULL。
参见:
OH_Rdb_CreateValueObject()
OH_VObject* OH_Rdb_CreateValueObject (void)
描述:
创建OH_VObject实例。
返回:
创建成功则返回一个指向OH_VObject结构体实例的指针,否则返回NULL。
参见:
OH_Rdb_CreateValuesBucket()
OH_VBucket* OH_Rdb_CreateValuesBucket (void)
描述:
创建OH_VBucket实例。
返回:
创建成功则返回一个指向OH_VBucket结构体实例的指针,否则返回NULL。
参见:
OH_Rdb_Delete()
int OH_Rdb_Delete (OH_Rdb_Store * store, OH_Predicates * predicates )
描述:
根据指定的条件删除数据库中的数据。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
predicates | 表示指向OH_Predicates实例的指针,指定删除条件。 |
返回:
如果更新成功,返回受影响的行数,否则返回特定的错误码。
参见:
OH_Rdb_DeleteStore()
int OH_Rdb_DeleteStore (const OH_Rdb_Config * config)
描述:
使用指定的数据库文件配置删除数据库。
参数:
名称 | 描述 |
---|---|
path | 表示数据库路径。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
OH_Rdb_Execute()
int OH_Rdb_Execute (OH_Rdb_Store * store, const char * sql )
描述:
执行无返回值的SQL语句。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
sql | 指定要执行的SQL语句。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_ExecuteQuery()
OH_Cursor* OH_Rdb_ExecuteQuery (OH_Rdb_Store * store, const char * sql )
描述:
根据指定SQL语句查询数据库中的数据。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
sql | 指定要执行的SQL语句。 |
返回:
如果查询成功则返回一个指向OH_Cursor结构体实例的指针,否则返回NULL。
参见:
OH_Rdb_GetOrOpen()
OH_Rdb_Store* OH_Rdb_GetOrOpen (const OH_Rdb_Config * config, int * errCode )
描述:
获得一个相关的OH_Rdb_Store实例,操作关系型数据库。
参数:
名称 | 描述 |
---|---|
config | 表示指向OH_Rdb_Config实例的指针,与此RDB存储相关的数据库配置。 |
errCode | 该参数是输出参数,函数执行状态写入该变量。 |
返回:
创建成功则返回一个指向OH_Rdb_Store结构体实例的指针,否则返回NULL。
参见:
OH_Rdb_GetVersion()
int OH_Rdb_GetVersion (OH_Rdb_Store * store, int * version )
描述:
获取数据库版本。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
version | 表示版本号。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_Insert()
int OH_Rdb_Insert (OH_Rdb_Store * store, const char * table, OH_VBucket * valuesBucket )
描述:
向目标表中插入一行数据。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
table | 表示指定的目标表名。 |
valuesBucket | 表示要插入到表中的数据行OH_VBucket。 |
返回:
如果插入成功,返回行ID。否则返回特定的错误码。
参见:
OH_Rdb_Query()
OH_Cursor* OH_Rdb_Query (OH_Rdb_Store * store, OH_Predicates * predicates, const char *const * columnNames, int length )
描述:
根据指定条件查询数据库中的数据
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
predicates | 表示指向OH_Predicates实例的指针,指定查询条件。 |
columnNames | 表示要查询的列。如果值为空,则查询应用于所有列。 |
length | 表示columnNames数组的长度。若length大于columnNames数组的实际长度,则会访问越界。 |
返回:
如果查询成功则返回一个指向OH_Cursor结构体实例的指针,否则返回NULL。
参见:
OH_Rdb_Store, OH_Predicates, OH_Cursor.
OH_Rdb_Restore()
int OH_Rdb_Restore (OH_Rdb_Store * store, const char * databasePath )
描述:
从指定的数据库备份文件恢复数据库。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
databasePath | 指定数据库的备份文件路径。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_RollBack()
int OH_Rdb_RollBack (OH_Rdb_Store * store)
描述:
回滚已经执行的SQL语句。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_SetVersion()
int OH_Rdb_SetVersion (OH_Rdb_Store * store, int version )
描述:
设置数据库版本。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
version | 表示版本号。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
OH_Rdb_Update()
int OH_Rdb_Update (OH_Rdb_Store * store, OH_VBucket * valuesBucket, OH_Predicates * predicates )
描述:
根据指定的条件更新数据库中的数据。
参数:
名称 | 描述 |
---|---|
store | 表示指向OH_Rdb_Store实例的指针。 |
valuesBucket | 表示要更新到表中的数据行OH_VBucket。 |
predicates | 表示指向OH_Predicates实例的指针,指定更新条件。 |
返回:
如果更新成功,返回受影响的行数,否则返回特定的错误码。
参见:
OH_Rdb_Store, OH_Bucket, OH_Predicates.
变量说明
andOperate
OH_Predicates*(* OH_Predicates::andOperate) (OH_Predicates *predicates)
描述:
函数指针,向谓词添加和条件。
该方法等同于SQL语句中的“AND”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
返回:
返回带有和条件的谓词。
参见:
beginWrap
OH_Predicates*(* OH_Predicates::beginWrap) (OH_Predicates *predicates)
描述:
函数指针,向谓词添加左括号。
该方法等同于SQL语句中的“(”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
返回:
返回带有左括号的谓词。
参见:
between
OH_Predicates*(* OH_Predicates::between) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,将谓词配置为匹配数据字段为field且其值在给定范围内的指定字段。
该方法等同于SQL语句中的“BETWEEN”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
storeName
const char* OH_Rdb_Config::storeName
描述:
数据库名称。
bundleName
const char* OH_Rdb_Config::bundleName
描述:
应用包名。
capability
uint16_t OH_VBucket::capability
描述:
表示结构体的存储键值对的数量
clear [1⁄2]
OH_Predicates*(* OH_Predicates::clear) (OH_Predicates *predicates)
描述:
函数指针,清空谓词。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
返回:
返回清空后的谓词
参见:
clear [2⁄2]
int(* OH_VBucket::clear) (OH_VBucket *bucket)
描述:
清空OH_VBucket对象。
参数:
名称 | 描述 |
---|---|
bucket | 表示指向OH_VBucket实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
dataBaseDir
const char* OH_Rdb_Config::dataBaseDir
描述:
数据库文件路径。
destroy [1⁄4]
int(* OH_Cursor::destroy) (OH_Cursor *cursor)
描述:
函数指针,关闭结果集。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
destroy [2⁄4]
int(* OH_Predicates::destroy) (OH_Predicates *predicates)
描述:
销毁OH_Predicates对象,并回收该对象占用的内存。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
destroy [3⁄4]
int(* OH_VBucket::destroy) (OH_VBucket *bucket)
描述:
销毁OH_VBucket对象,并回收该对象占用的内存。
参数:
名称 | 描述 |
---|---|
bucket | 表示指向OH_VBucket实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
destroy [4⁄4]
int(* OH_VObject::destroy) (OH_VObject *valueObject)
描述:
销毁OH_VObject对象,并回收该对象占用的内存。
参数:
名称 | 描述 |
---|---|
valueObject | 表示指向OH_VObject实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
distinct
OH_Predicates*(* OH_Predicates::distinct) (OH_Predicates *predicates)
描述:
函数指针,配置谓词以过滤重复记录并仅保留其中一个。
该方法等同于SQL语句中的“DISTINCT”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
返回:
返回可用于过滤重复记录的谓词。
参见:
endWrap
OH_Predicates*(* OH_Predicates::endWrap) (OH_Predicates *predicates)
描述:
函数指针,向谓词添加右括号。
该方法等同于SQL语句中的“)”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
返回:
返回带有右括号的谓词。
参见:
equalTo
OH_Predicates*(* OH_Predicates::equalTo) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段等于指定值的字段。
该方法等同于SQL语句中的“=”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
getBlob
int(* OH_Cursor::getBlob) (OH_Cursor *cursor, int32_t columnIndex, unsigned char *value, int length)
描述:
函数指针,以字节数组的形式获取当前行中指定列的值。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
columnIndex | 表示结果集中指定列的索引。 |
value | 该参数是输出参数,结果集中指定列的值会以字节数组形式写入该变量。 |
length | 表示value的长度,该值可通过getSize获取。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getColumnCount
int(* OH_Cursor::getColumnCount) (OH_Cursor *cursor, int *count)
描述:
函数指针,获取结果集中的列数。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
count | 该参数是输出参数,结果集中的列数会写入该变量。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getColumnIndex
int(* OH_Cursor::getColumnIndex) (OH_Cursor *cursor, const char *name, int *columnIndex)
描述:
函数指针,根据指定的列名获取列索引。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
name | 表示结果集中指定列的名称。 |
columnIndex | 该参数是输出参数,结果集中指定列的索引会写入该变量。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getColumnName
int(* OH_Cursor::getColumnName) (OH_Cursor *cursor, int32_t columnIndex, char *name, int length)
描述:
函数指针,根据指定的列索引获取列名。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
columnIndex | 表示结果集中指定列的索引。 |
name | 该参数是输出参数,结果集中指定列的名称会写入该变量。 |
length | 表示列名的长度。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getColumnType
int(* OH_Cursor::getColumnType) (OH_Cursor *cursor, int32_t columnIndex, OH_ColumnType *columnType)
描述:
函数指针,根据指定的列索引获取列类型。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
columnIndex | 表示结果集中指定列的索引。 |
columnType | 该参数是输出参数,结果集中指定列的数据类型OH_ColumnType会写入该变量。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getInt64
int(* OH_Cursor::getInt64) (OH_Cursor *cursor, int32_t columnIndex, int64_t *value)
描述:
函数指针,以int64_t形式获取当前行中指定列的值。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
columnIndex | 表示结果集中指定列的索引。 |
value | 该参数是输出参数,结果集中指定列的值会以int64_t形式写入该变量。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getReal
int(* OH_Cursor::getReal) (OH_Cursor *cursor, int32_t columnIndex, double *value)
描述:
函数指针,以double形式获取当前行中指定列的值。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
columnIndex | 表示结果集中指定列的索引。 |
value | 该参数是输出参数,结果集中指定列的值会以double形式写入该变量。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getRowCount
int(* OH_Cursor::getRowCount) (OH_Cursor *cursor, int *count)
描述:
函数指针,获取结果集中的行数。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
count | 该参数是输出参数,结果集中的行数会写入该变量。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getSize
int(* OH_Cursor::getSize) (OH_Cursor *cursor, int32_t columnIndex, size_t *size)
描述:
函数指针,当结果集中列的数据类型是BLOB或者TEXT时,获取其值所需的内存。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
columnIndex | 表示结果集中指定列的索引。 |
size | 该参数是输出参数,BLOB或者TEXT数据所需内存大小会写入该变量。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
getText
int(* OH_Cursor::getText) (OH_Cursor *cursor, int32_t columnIndex, char *value, int length)
描述:
函数指针,以字符串形式获取当前行中指定列的值。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
columnIndex | 表示结果集中指定列的索引。 |
value | 该参数是输出参数,结果集中指定列的值会以字符串形式写入该变量。 |
length | 表示value的长度,该值可通过getSize获取。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
goToNextRow
int(* OH_Cursor::goToNextRow) (OH_Cursor *cursor)
描述:
函数指针,转到结果集的下一行。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
greaterThan
OH_Predicates*(* OH_Predicates::greaterThan) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段为field且值大于指定值valueObject的字段。
该方法等同于SQL语句中的“>”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词
参见:
greaterThanOrEqualTo
OH_Predicates*(* OH_Predicates::greaterThanOrEqualTo) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段为field且值大于或等于指定值valueObject的字段
该方法等同于SQL语句中的“>=”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
groupBy
OH_Predicates*(* OH_Predicates::groupBy) (OH_Predicates *predicates, char const *const *fields, int length)
描述:
函数指针,配置R谓词按指定列分组查询结果。
该方法等同于SQL语句中的“GROUP BY”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
fields | 指定分组依赖的列名。 |
length | 表示fields数值的长度。 |
返回:
返回分组查询列的谓词。
参见:
id [1⁄4]
int64_t OH_Predicates::id
描述:
OH_Predicates结构体的唯一标识符。
id [2⁄4]
int64_t OH_VObject::id
描述:
OH_VObject结构体的唯一标识符。
id [3⁄4]
int64_t OH_VBucket::id
描述:
OH_VBucket结构体的唯一标识符。
id [4⁄4]
int64_t OH_Rdb_Store::id
描述:
OH_Rdb_Store结构体的唯一标识符。
in
OH_Predicates*(* OH_Predicates::in) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段为field且值在给定范围内的指定字段。
该方法等同于SQL语句中的“IN”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 表示数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
isEncrypt
bool OH_Rdb_Config::isEncrypt
描述:
指定数据库是否加密。
isNotNull
OH_Predicates*(* OH_Predicates::isNotNull) (OH_Predicates *predicates, const char *field)
描述:
函数指针,配置谓词以匹配值不为null的指定字段。
该方法等同于SQL语句中的“IS NOT NULL”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
返回:
返回与指定字段匹配的谓词
参见:
isNull [1⁄2]
int(* OH_Cursor::isNull) (OH_Cursor *cursor, int32_t columnIndex, bool *isNull)
描述:
函数指针,检查当前行中指定列的值是否为null。
参数:
名称 | 描述 |
---|---|
cursor | 表示指向OH_Cursor实例的指针。 |
columnIndex | 表示结果集中指定列的索引。 |
isNull | 该参数是输出参数,如果当前行中指定列的值为null,该值为true,否则为false。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
isNull [2⁄2]
OH_Predicates*(* OH_Predicates::isNull) (OH_Predicates *predicates, const char *field)
描述:
函数指针,配置谓词以匹配值为null的字段。
该方法等同于SQL语句中的“IS NULL”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
返回:
返回与指定字段匹配的谓词。
参见:
lessThan
OH_Predicates*(* OH_Predicates::lessThan) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段为field且值小于指定值valueObject的字段
该方法等同于SQL语句中的“<”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
lessThanOrEqualTo
OH_Predicates*(* OH_Predicates::lessThanOrEqualTo) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段为field且值小于或等于指定值valueObject的字段
该方法等同于SQL语句中的“<=”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
like
OH_Predicates*(* OH_Predicates::like) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段为field且值类似于指定字符串的字段。
该方法等同于SQL语句中的“LIKE”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
limit
OH_Predicates*(* OH_Predicates::limit) (OH_Predicates *predicates, unsigned int value)
描述:
函数指针,设置最大数据记录数的谓词。
该方法等同于SQL语句中的“LIMIT”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
value | 表示最大数据记录数。 |
返回:
返回可用于设置最大数据记录数的谓词。
参见:
moduleName
const char* OH_Rdb_Config::moduleName
描述:
应用模块名。
notBetween
OH_Predicates*(* OH_Predicates::notBetween) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,将谓词配置为匹配数据字段为field且其值超出给定范围内的指定字段。
该方法等同于SQL语句中的“NOT BETWEEN”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
notEqualTo
OH_Predicates*(* OH_Predicates::notEqualTo) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段不等于指定值的字段。
该方法等同于SQL语句中的“!=”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
notIn
OH_Predicates*(* OH_Predicates::notIn) (OH_Predicates *predicates, const char *field, OH_VObject *valueObject)
描述:
函数指针,配置谓词以匹配数据字段为field且值超出给定范围内的指定字段。
该方法等同于SQL语句中的“NOT IN”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 表示数据库表中的列名。 |
valueObject | 表示指向OH_VObject实例的指针,指示要与谓词匹配的值。 |
返回:
返回与指定字段匹配的谓词。
参见:
offset
OH_Predicates*(* OH_Predicates::offset) (OH_Predicates *predicates, unsigned int rowOffset)
描述:
函数指针,配置谓词以指定返回结果的起始位置。
该方法等同于SQL语句中的“OFFSET”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
rowOffset | 返回结果的起始位置,取值为正整数。 |
返回:
返回具有指定返回结果起始位置的谓词。
参见:
orderBy
OH_Predicates*(* OH_Predicates::orderBy) (OH_Predicates *predicates, const char *field, OH_OrderType type)
描述:
函数指针,配置谓词以匹配其值按升序或降序排序的列。
该方法等同于SQL语句中的“ORDER BY”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
field | 数据库表中的列名。 |
type | 表示排序类型 OH_OrderType. |
返回:
返回与指定字段匹配的谓词。
参见:
orOperate
OH_Predicates*(* OH_Predicates::orOperate) (OH_Predicates *predicates)
描述:
函数指针,将或条件添加到谓词中。
该方法等同于SQL语句中的“OR”。
参数:
名称 | 描述 |
---|---|
predicates | 表示指向OH_Predicates实例的指针。 |
返回:
返回带有或条件的谓词。
参见:
putBlob
int(* OH_VBucket::putBlob) (OH_VBucket *bucket, const char *field, const uint8_t *value, uint32_t size)
描述:
将const uint8_t *值放入给定列名的OH_VBucket对象中。
参数:
名称 | 描述 |
---|---|
bucket | 表示指向OH_VBucket实例的指针。 |
field | 数据库表中的列名。 |
value | 数据库表中指定列名对应的值。 |
size | 表示value的长度。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
putDouble
int(* OH_VObject::putDouble) (OH_VObject *valueObject, double *value, uint32_t count)
描述:
将double类型的单个参数或者数组转换为OH_VObject类型的值。
参数:
名称 | 描述 |
---|---|
valueObject | 表示指向OH_VObject实例的指针。 |
value | 表示指向double类型的单个参数或者数组的指针。 |
count | 如果value是指向单个数值的指针,则count = 1;如果value是指向数组的指针,则count是数组的长度。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
putInt64 [1⁄2]
int(* OH_VBucket::putInt64) (OH_VBucket *bucket, const char *field, int64_t value)
描述:
将int64_t值放入给定列名的OH_VBucket对象中。
参数:
名称 | 描述 |
---|---|
bucket | 表示指向OH_VBucket实例的指针。 |
field | 数据库表中的列名。 |
value | 数据库表中指定列名对应的值。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
putInt64 [2⁄2]
int(* OH_VObject::putInt64) (OH_VObject *valueObject, int64_t *value, uint32_t count)
描述:
将int64类型的单个参数或者数组转换为OH_VObject类型的值。
参数:
名称 | 描述 |
---|---|
valueObject | 表示指向OH_VObject实例的指针。 |
value | 表示指向int64_t类型的单个参数或者数组的指针。 |
count | 如果value是指向单个数值的指针,则count = 1;如果value是指向数组的指针,则count是数组的长度。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
putNull
int(* OH_VBucket::putNull) (OH_VBucket *bucket, const char *field)
描述:
将NULL值放入给定列名的OH_VBucket对象中。
参数:
名称 | 描述 |
---|---|
bucket | 表示指向OH_VBucket实例的指针。 |
field | 数据库表中的列名。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
putReal
int(* OH_VBucket::putReal) (OH_VBucket *bucket, const char *field, double value)
描述:
将double值放入给定列名的OH_VBucket对象中。
参数:
名称 | 描述 |
---|---|
bucket | 表示指向OH_VBucket实例的指针。 |
field | 数据库表中的列名。 |
value | 数据库表中指定列名对应的值。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
putText [1⁄2]
int(* OH_VBucket::putText) (OH_VBucket *bucket, const char *field, const char *value)
描述:
将char*值放入给定列名的OH_VBucket对象中。
参数:
名称 | 描述 |
---|---|
bucket | 表示指向OH_VBucket实例的指针。 |
field | 数据库表中的列名。 |
value | 数据库表中指定列名对应的值。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
putText [2⁄2]
int(* OH_VObject::putText) (OH_VObject *valueObject, const char *value)
描述:
将char *类型的字符数组转换为OH_VObject类型的值。
参数:
名称 | 描述 |
---|---|
valueObject | 表示指向OH_VObject实例的指针。 |
value | 表示字符数组参数。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
putTexts
int(* OH_VObject::putTexts) (OH_VObject *valueObject, const char **value, uint32_t count)
描述:
将char *类型的字符串数组转换为OH_VObject类型的值。
参数:
名称 | 描述 |
---|---|
valueObject | 表示指向OH_VObject实例的指针。 |
value | 表示字符串数组参数。 |
count | 表示字符串数组参数value的长度。 |
返回:
返回操作是否成功,出错时返回对应的错误码。
参见:
securityLevel
int OH_Rdb_Config::securityLevel
描述:
设置数据库安全级别OH_Rdb_SecurityLevel。
selfSize
int OH_Rdb_Config::selfSize
描述:
该结构体的大小。
你可能感兴趣的鸿蒙文章
- 所属分类: 后端技术
- 本文标签:
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦