全局变量数据库是金字塔内部的一种小型数据库,用来存放用户作用整个金字塔全局的变量。可以使用全局变量做变量存储,或者与PEL, VBA进行数据交互。
# setextdata 以数值方式设置指定名称的全局变量数据
setextdata(item, data)
以数值方式设置指定名称的全局变量数据。数据存储在“工具”--“数据管理”--“全局变量”中
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| item | str | 全局变量数据项名称 |
| data | float 或 int | 数据内容 |
注意: 数值型float金字塔采取单精度浮点数存储,如果数值过大可能会丢失精度,此时可以改为字符串存储以保留精度。
返回值
无
范例
#设置TEST全局变量的值。
setextdata('TEST', 1)
#打印输出'TEST'的结果
print(getextdata('TEST'))
1
2
3
4
2
3
4
# getextdata 得到指定名称的全局变量数据
getextdata(item)
得到指定名称的全局变量数据,数据存储在“工具”--“数据管理”--“全局变量”中
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| item | str | 全局变量数据项名称 |
返回值
float 或 int
注意: 数值型float金字塔采取单精度浮点数存储,如果数值过大可能会丢失精度,此时可以改为字符串存储以保留精度。
范例
#获取"ABC"名称的全局变量数据。
getextdata("ABC")
1
2
2
# setextstring 以字符串方式设置指定名称的字符串全局变量数据
setextstring(item, data)
以字符串方式设置指定名称的全局变量数据。数据存储在“工具”--“数据管理”--“全局变量”中。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| item | str | 全局变量数据项名称 |
| data | str 或 float 或 int | 数据内容(最终将以字符串形式存储) |
注意:
所有写入的数据最终都会被转换为字符串类型进行存储。如果传入的是数值类型(float 或 int),会自动转换为字符串格式保存,从而避免数值精度丢失问题,适用于大数值或高精度数据存储场景。
返回值
无
范例
# 设置字符串类型全局变量
setextstring('TEST_STR', 'hello world')
# 设置数值(会自动转为字符串存储)
setextstring('TEST_NUM', 123)
# 读取并打印
print(getextstring('TEST_STR')) # 输出: hello world
print(getextstring('TEST_NUM')) # 输出: 123
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# getextstring 得到指定名称的字符串全局变量数据
getextstring(item)
得到指定名称的字符串全局变量数据,数据存储在“工具”--“数据管理”--“全局变量”中。该函数用法与 getextdata 函数相同,但返回值始终为字符串类型;如果对应键值为数值类型,也会自动转换为字符串输出。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| item | str | 全局变量数据项名称 |
返回值
str
注意:
无论原始存储的数据类型为字符串还是数值类型,调用该函数时都会以字符串形式返回,适用于需要高精度或统一字符串处理的场景。
范例
#获取"ABC"名称字符串类型的全局变量数据。
getextstring("ABC")
1
2
2
# clearextdata 从全局变量数据库中清除所有全局变量数据
clearextdata()
参数
无
返回值
无