函数文档
下载地址:https://ylands.qq.com/workshop/detail.htm?id=1236
原始CSV数据整理
CSV在EXCEL整理
以下表为例:所有CSV表,第一行必须为字段名
字段名要求:不重复
数据集工具支持 string,int,float,向量,颜色 五种数据格式,其中 向量,颜色,需要准寻以下格式要求:
- 向量 格式为: 数字/数字/数字,数字可为正负 整数或浮点数
- 颜色 格式为: 数字/数字/数字/数字 分别代表R/G/B/A, 格式为整数数
CSV转化为字符串
请使用notepad++,将CSV用notepad++打开后,必须符合以下要求:
- 每个数据以逗号间隔,数据内没有逗号
- 每行以 CRLF 结尾
- 最后一行没有CRLF
- 文件格式为:Windows(CR LF)|UTF-8 BOM
- 第一行字段中,禁止出现 “id” 字段名
数据在游戏中存在方式
建议以此种方式输入游戏,方便搜索管理
[BZ]数据表库V1.1
类型
艾兰岛 全局存储
属性
方法
[BZ][数据表库]创建表
将原始CSV字符串数据转为二维表
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
表名 | String | 表名(字段-类型,字段-类型,…) | 表名必须,括号内指定字段类型不指定,则字段都为string类型 | 当前支持 string,int,float,向量,颜色类型 |
主键 | String | 字段 | No | 要求成为主键的列内数据不能重复,此项为空,则自动添加一列 名为id,自增长的整数列为主键列 |
元数据CSV | String | 字符串 | Y | 格式要求见上文原始CSV数据整理 |
返回
返回一个单完整表结果的实体存储
实例
[BZ][数据表库] 表名
获取已创建表的表名
在创建表时,本地变量可设置任意名称,如下图,本地变量:地点表并不是真正的表名
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
表 | 实体存模对象 | - | Y | 创建表返回值 |
返回
返回表名,String类型
实例
[BZ][数据表库]显示列属性
用于查看表结构的简单命令,显示表结构,字段类型,主键,是否为空等属性
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
表 | 实体存模对象 | - | Y | 创建表返回值 |
返回
返回字段属性字符串,字符串已格式化
实例
输出日志:
----
[BZ][数据表库]查询
查询指定列下的所有数据
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
字段 | String | - | Y | 输入字段名字符串 |
表 | 实体存模对象 | - | Y | 创建表返回值 |
输出自断裂数据结果 | Array | - | Y | 返回查询列的所有数据 |
返回
返回数组 查询列的所有数据
实例
返回 vector 列中所有向量数据
[BZ][数据表库]查询
返回指定字段=值条件下的所在行数据
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
查询字段 | String | - | Y | 输入字段名 |
查询字段等于值 | String | 字符串 | Y | 所有类型的值都以字符串形式输入,不支持输入向量,颜色2种类型。如果未填,或输入空,则返回第一行数据 |
表 | 实体存模对象 | - | Y | 创建表返回值 |
输出字段等于值所在行数据 | Array | - | Y | - |
返回
返回数组 查询列对应值的所在行数据
如果条件值
实例
返回
[BZ][数据表库]条件查询
依据条件返回查询字段的数据
查询条件优先级 WHERE > AND > OR
AND 是与WHERE 在主键上的交集
OR 是与前2者的并集
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
查询字段 | String | - | Y | 指定要返回数据的字段 |
WHERE | String | 支持=、>、< 三种运算符号 字段运算符值 | N | 可以为空,值不支持向量与颜色 |
AND | String | 支持=、>、< 三种运算符号 字段运算符值 | N | 可以为空,值不支持向量与颜色 |
OR | String | 支持=、>、< 三种运算符号 字段运算符值 | N | 可以为空,值不支持向量与颜色 |
表 | 实体存模对象 | - | Y | 创建表返回值 |
返回查询字段列内符合数据 | Array | - | Y | 运行前先创建本地数组变量 |
返回
符合条件的查询字段数据
实例
对比在excel里运行结果
[BZ][数据表库]更新数据
更新符合WHERE条件的所有KEY列里的数据为VALUE值
参考MySQL语句为:
UPDATE [LOW_PRIORITY] [IGNORE] tbl_name
SET col_name1=expr1 [, col_name2=expr2 ...]
[WHERE where_definition]
KEY数组包含所有 列名
VALUE数组 依据索引 对应KEY里字段需要更新的值
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
表 | 实体存模对象 | - | Y | 创建表返回值 |
KEY | ARRAY | 数组元素为列名字符串 | Y | - |
VALUE | ARRAY | 数组元素为列名对应的值 | Y | KEY,VALUE 数组长度要一致 |
WHERE | String | 条件字符串,支持=、>、<运算符 | N | 只支持输入一个条件,列名运算符值,如果为空,则更新KEY里列所有数据为VALUE值,不支持向量与颜色 |
返回
无
实例
红框部分为更新逻辑
查询更新列,日志输出
[BZ][数据表库]检查运算符号
判断字符串种是否有=,>,< 运算符,以及格式是否正确
要求格式 字符串运算符值
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
字符串 | String | 字符串运算符值 | Y | - |
返回
nan:字符串为空,或者字符串内无运算符号,或者运算符号在字符串开头或者结尾,否则返回 =,>,<
实例
输出:
[BZ][数据表库]字段条件查询
返回符合条件的指定字段数据对应主键
内部函数
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
字段 | String | - | Y | 查询列 |
运算符号 | String | - | Y | 支持 =,<,> |
查询字段条件 | String | - | Y | 不支持向量与颜色 |
返回索引 | Array | - | - | - |
返回
返回符合条件的主键列数据
实例
返回主键列符合条件数据
[BZ][数据表库]检查字段是否存在
如果表中存在字段,返回 True,否则返回False
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
字段 | String | - | Y | - |
表 | 实体存模对象 | - | Y | 创建表返回值 |
返回
True 或 False
实例
[BZ][数据表库]插入数据
向已创建表末尾插入新数据
参考MySQL语法
INSERT INTO table_name ( field1, field2,...fieldN )
VALUES
( value1, value2,...valueN );
参数
参数 | 类型 | 格式 | 是否必须 | 说明 |
---|---|---|---|---|
字段 | String | - | Y | - |
表 | 实体存模对象 | - | Y | 创建表返回值 |
KEY | Array | - | Y | 字段数组,缺少的字段会自动根据该字段数据类型加入数据 |
VLAUE | Array | - | Y | 字段对应的值,需要与KEY里的字段一一对应 |
返回
返回新插入数据的索引 (int)
实例
[BZ]表数据
属性
- 表名
- 列名
- 列标识号
- 主键
- 行数
- 列数组
- 主键列
- 表属性
方法
[BZ]单列数据
属性
- 列实体数组
- 列名
- 主键
- 数据数量
- MAX
- 数据类型
方法
- [BZ]挂载
- [BZ]添加数据
- [BZ]修改数据
- [BZ]列数据数量
[BZ]表属性数组模板
属性
- Field
- Type
- Collation
- Null
- Key
- Default
- Extra
- Privileges
- Comment
方法
[BZ][YString]
属性
- NumersArray
方法
- [BZ][YString]去除字符串内所有空格
- [BZ][YString]去除字符串左侧空格
- [BZ][YString]返回字符串长度
- [BZ][YString]返回大写字母
- [BZ][YString]文本转数值
- [BZ][YString]去除/n
- [BZ][YString]单行字符串分隔符切片
- InitNumArray (必须游戏一开始初始化)
- [BZ][YString]单个字符转数值
- NULL
- CRLF
- None
- [BZ][YString]秒格式化
- [BZ][YString]多行文本分隔符切片
- [BZ][YString]返回字符串宽度
- [BZ][YString]文本转浮点数值
- [BZ][YString]Last Index Of
- [BZ][YString]返回字符在另一个字符串出现次数
- [BZ][YString]数据转换
- [BZ][YString]文本转颜色
- [BZ][YString]文本转向量
[BZ][数组]
方法
- [BZ][数组]获取出现次数
- [BZ][数组]从数组中删除指定对象
- [BZ][数组]检查数组重复值并打印第一个重复值
- [BZ][数组]求2个数组交集
- [BZ][数组]求数组1差集
- [BZ][数组]求2个数组并集
[BZ][调试]
方法
- [[BZ][调试]控制台打印
- [BZ][调试]日志打印
- [BZ][调试]日志打印
- [BZ][调试]字符串前加冒号
- [BZ][调试]ERROR
- [BZ][调试]DEBUG
- [BZ][调试]WARN
- [BZ][调试]颜色高亮
- [BZ][调试]字体加粗