aardio 文档

string.database 库模块帮助文档

string 成员列表

string.database

用于解析、读写 CSV(Comma Separated Values),TXT 格式数据库。
注意文本数据规范不统一,不同的程序解析结果可能有差异。
用法请参考:范例程序 / 数据库 / csv / string.database

创建 TXT,CSV 格式数据库对象。

string.database()

返回对象:stringDatabaseObject

string.database(分隔符,文本包含符)

创建 TXT,CSV 格式数据库对象。
参数可以省略,默认使用制表符作为分隔符,双引号包含文本

stringDatabaseObject 成员列表

stringDatabaseObject.dataTable

对象本身存储的数据表。
parse 函数解析得到的数组会赋值并替换此属性。
push 函数则默认向此数据表添加数据。
stringify,stringifyA 函数在不指定参数时使用此数据表作为参数

stringDatabaseObject.each(文件路径)

for tab in stringDatabaseObject.each("文件路径.csv") {
    /*逐行读取 CSV 文件,tab 为当前读取行解析后的列数组*/
}

stringDatabaseObject.load

加载并解析文件

stringDatabaseObject.load(文件路径,代码页)

加载并解析文件,返回数组,
文件开头有 UTF-8 BOM 则以 UTF-8 编码读入内容,
否则以参数 @2 指定的编码读入并转换为 UTF-8 编码,
参数 @2 省略时默认值为 0,表示当前默认 ANSI 编码

stringDatabaseObject.parse

解析数据并返回得到的数组

stringDatabaseObject.parse(文本)

解析数据并返回得到的数组。
对象的 dataTable 属性也会被赋值并替换为这里返回的数组

stringDatabaseObject.push

添加数据到对象的 dataTable 属性指向的数据表

stringDatabaseObject.push(...)

添加数据到对象的 dataTable 属性指向的数据表
参数 @1 如果是表,则所有参数都作为数据行添加到 dataTable 数据表
否则所有参数合并为一行数据并添加到 dataTable 数据表
之后可以调用 stringify 函数生成文本

stringDatabaseObject.quote

文本包含符

stringDatabaseObject.save

以 UTF-8 编码写入文件

stringDatabaseObject.save(文件路径,数据数组,是否追加)

在指定文件写入 UTF-8 BOM,
然后将数据以 UTF-8 编码、CSV 格式写入文件。
如果不指定数据数组参数,则使用之前调用 push 函数添加的数据。
参数 @3 如果为 true 则保留原来的文件内容。

stringDatabaseObject.saveA

以 ANSI 编码写入文件

stringDatabaseObject.saveA(文件路径,数据数组,是否追加)

将数据以 ANSI 编码、CSV 格式写入文件
如果不指定数据数组参数,则使用之前调用 push 函数添加的数据。
参数 @3 如果为 true 则保留原来的文件内容。

stringDatabaseObject.separator

列分隔符

stringDatabaseObject.stringify

数据表转换为 UTF8 文本

stringDatabaseObject.stringify(数据数组)

数据表转换为 UTF8 文本
如果不指定参数,则使用对象的 dataTable 属性作为参数

stringDatabaseObject.stringifyA

数据表转换为 ANSI 文本

stringDatabaseObject.stringifyA(数据数组)

数据表转换为 ANSI 文本
如果不指定参数,则使用对象的 dataTable 属性作为参数

Markdown 格式