meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
scripting:world:sqlite [2025/08/06 17:08] – bibiboxsscripting:world:sqlite [2025/08/12 00:17] (当前版本) – bibiboxs
行 6: 行 6:
 > 数据库操作需要掌握**相关知识**，适合复杂数据存储或有明确目的使用，如果只是希望实现**简单游戏存档**等功能，请考虑使用`Json`功能。 > 数据库操作需要掌握**相关知识**，适合复杂数据存储或有明确目的使用，如果只是希望实现**简单游戏存档**等功能，请考虑使用`Json`功能。
  
-注意：**SQLite**类支持增删查改以及部分扩展操作，若选用**SQLite**作为存储方式，建议使用**Browser**相关工具可视化**建库和管理**，而不是100%通过引擎API方式。+注意：数据库操作语句将直接影响**数据安全**，因此应该确保严格的**SQL指令输入**，以及字符串的安全过滤。
  
  
行 54: 行 54:
 ### SQLite.EscapeString() ### SQLite.EscapeString()
  
-> 格式化数据库字符串语句，确保目标字符串不包含SQL注入等危险。+> 格式化数据库**字符串**，降低目标字符串SQL注入等风险。
  
 ```javascript ```javascript
行 62: 行 62:
 ```javascript ```javascript
 let sql = "SELECT * FROM Accounts WHERE Name = '" + SQLite.EscapeString("playerName") + "'"; let sql = "SELECT * FROM Accounts WHERE Name = '" + SQLite.EscapeString("playerName") + "'";
 +```
 +
 +
 +
 +### SQLite.IsSafeString()
 +
 +> 检查指定数据库**字符串**，判断是否为安全字符串（不包含非安全字符）。
 +
 +```javascript
 +function SQLite.IsSafeString( text: string ): bool
 ``` ```
  
行 172: 行 182:
 ### SQLiteQueryResult.Get() ### SQLiteQueryResult.Get()
  
-> 根据**列\行**获取数值。+> 根据**列\行**获取数值，如果**目标\数值**不存在，默认返回`null`。 
 +> 
 +> 注意：如果指定**列\行**存在**表内数据**，但**数值内容**为空，同样会返回`null`，准确判断应该使用`ExistColumn() | ExistRow()`。
  
 ```javascript ```javascript
行 220: 行 232:
 ```javascript ```javascript
 function SQLiteQueryResult.ExistRow( row: int ): bool function SQLiteQueryResult.ExistRow( row: int ): bool
 +```
 +
 +
 +
 +### SQLiteQueryResult.HasData()
 +
 +> 获取当前结果**是否有效且存在数据**。
 +>
 +> 注意：有时此选项会返回`false`，但`IsValid()`返回`true`，表示查到了对应的**有效**表，但是**没有找到**匹配的**行数据**。
 +
 +```javascript
 +function SQLiteQueryResult.HasData(): bool
 ``` ```
  
行 226: 行 250:
 ### SQLiteQueryResult.IsValid() ### SQLiteQueryResult.IsValid()
  
-> 获取当前结果**是否有效**（存在结果）。+> 获取当前结果**是否有效**（查询流程正常，即使**没有找到**匹配的**行数据**）。 
 +> 
 +> 注意：如果此值返回`false`，则代表没有找到任何内容，查询没有意义。
  
 ```javascript ```javascript
 function SQLiteQueryResult.IsValid(): bool function SQLiteQueryResult.IsValid(): bool
 ``` ```
 +
 +