DataCenter API
1.2.1 DataCenter.addDB
| 功能 |
添加新的数据库 |
| 接口描述 |
DataCenter.addDB(arg) |
| arg |
数据库属性描述<字符串> |
| 例 |
DataCenter.addDB("dbName=DB_3_100, dStart=0, count=100, dSize=2, dType=2") |
| dbName |
数据库名称<字符串>，用来查找、索引数据库 |
| dStart |
数据单元起始编号（Modbus等需要使用。默认为0） |
| count |
数据单元数量 |
| dSize |
数据单元的大小（占用字节数） |
| dType |
数据单元的类型（暂时无作用） |
1.2.2 DataCenter.getDB
| 功能 |
获取数据库指针 |
| 接口描述 |
pDB = DataCenter.getDB(dbName) |
| dbName |
要查找的数据库名称<字符串> |
| pDB |
返回值<数据库指针>。如果未找到，则返回NULL |
1.2.3 DataCenter.removeDB
| 功能 |
删除数据库 |
| 接口描述 |
DataCenter.removeDB(dbName) |
| dbName |
要删除的数据库名称<字符串> |
1.2.4 DataCenter.removeAllDB
| 功能 |
删除所有数据库 |
| 接口描述 |
DataCenter.removeAllDB() |
1.2.5 DataCenter.debug
| 功能 |
设置数据库LOG打印级别 |
| 接口描述 |
DataCenter.debug(LogLevel) |
| LogLevel |
0x00000101 |
1.2.6 DataCenter.DBresize
| 功能 |
重设数据库的数据单元数量 |
| 接口描述 |
DataCenter.DBresize(pDB, count) |
| pDB |
数据库指针 |
| count |
数据单元数量（如果新数量比原来的数量小，多余的数值将会丢失） |
1.2.7 DataCenter.DBdestroy
| 功能 |
销毁数据库内部的资源 |
| 接口描述 |
DataCenter.DBdestroy(dbName) |
| dbName |
要销毁的数据库名称<字符串> |
1.2.8 DataCenter.DBclear
| 功能 |
清空数据库内所有数据 |
| 接口描述 |
DataCenter.DBclear(dbName) |
| dbName |
要清空的数据库名称<字符串> |
1.2.9 DataCenter.DBupdateRecord
| 功能 |
更新数据库中某个数据单元（附带更新时间） |
| 接口描述 |
DataCenter.DBupdateRecord(pDB, index, value, time) |
| pDB |
数据库指针 |
| index |
数据单元编号 |
| value |
新的数值 |
| time |
新的时间<Unix时间戳（u32类型）> |
1.2.10 DataCenter.DBupdateRecords
| 功能 |
更新数据库中多个数据单元（附带更新时间） |
| 接口描述 |
DataCenter.DBupdateRecords(pDB, index, count, pvalue, time) |
| pDB |
数据库指针 |
| index |
数据单元编号 |
| count |
更新的数据单元数量 |
| pvalue |
新的数值指针（必须与数据库中数据同样字长） |
| time |
新的时间<Unix时间戳（u32类型）> |
1.2.11 DataCenter.DBsetRecord
| 功能 |
更新数据库中某个数据单元 |
| 接口描述 |
DataCenter.DBsetRecord(pDB, index, value) |
| pDB |
数据库指针 |
| index |
数据单元编号 |
| value |
新的数值 |
1.2.12 DataCenter.DBsetRecords
| 功能 |
更新数据库中多个数据单元 |
| 接口描述 |
DataCenter.DBsetRecords(pDB, index, count, pvalue) |
| pDB |
数据库指针 |
| index |
数据单元编号 |
| count |
更新的数据单元数量 |
| pvalue |
新的数值指针（必须与数据库中数据同样字长） |
1.2.13 DataCenter.DBgetRecord
| 功能 |
获取数据库中某个数据单元的数值 |
| 接口描述 |
ret, val = DataCenter.DBgetRecord(pDB, index) |
| ret |
函数返回值，ret=0时证明函数运行无错，val有效 |
| val |
数据单元的数值 |
| pDB |
数据库指针 |
| index |
数据单元编号 |
1.2.14 DataCenter.DBgetRecords
| 功能 |
获取数据库中多个数据单元的数值（暂不支持） |
| 接口描述 |
ret = DataCenter.DBgetRecords(pDB, index, count, pvalue) |
| ret |
函数返回值，ret=0时证明函数运行无错，pvalue内数据有效 |
| pDB |
数据库指针 |
| index |
需要获取的起始数据单元编号 |
| count |
需要获取的数据单元数量 |
| pvalue |
输出数值指针，获取的多个数据会被放置到这个数组中。（必须与数据库中数据同样字长） |
文档更新时间: 2024-11-05 17:39 作者：CGL
