艾蘭島數據表工具V1.1
函數文檔
原始CSV數據整理
CSV在EXCEL整理
以下表爲例：所有CSV表，第一行必須爲字段名
字段名要求：不重複
數據集工具支持 string，int，float，向量，顏色 五種數據格式，其中 向量，顏色，需要準尋以下格式要求：
- 向量 格式爲： 數字/數字/數字,數字可爲正負 整數或浮點數
- 顏色 格式爲： 數字/數字/數字/數字 分別代表R/G/B/A, 格式爲整數數
CSV轉化爲字符串
請使用notepad++，將CSV用notepad++打開後，必須符合以下要求：
- 每個數據以逗號間隔，數據內沒有逗號
- 每行以 CRLF 結尾
- 最後一行沒有CRLF
- 文件格式爲：Windows(CR LF)|UTF-8 BOM
數據在遊戲中存在方式
建議以此種方式輸入遊戲，方便搜索管理
[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值
SQL語句爲：
//SQL code block
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][數據表庫]插入數據
參數
返回
實例
[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][調試]字體加粗