艾兰岛数据表工具V1.1

函数文档

下载地址：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][调试]字体加粗