本文介绍SPL读写文本文件和Excel文件的基本方法，包括简单的文件目录操作。

文本文件

读写结构化文本

结构化文本的格式比较规范，即每行一条记录，列之间用分隔符区分。SPL可用import/export函数读写结构化文本。

比如：ordersNT.txt存储订单记录，列之间用制表符tab分隔，业务意义依次为：订单ID、客户编号、销售ID、订单金额、订单日期。部分数据如下：

将该表按客户编号的字母顺序从小到大的排序，相同的客户编号再按订单金额从大到小排序，最后保持原格式存入新文件。部分结果应当如下：

要计算出上述结果，可用如下SPL脚本：

A1、A3:读入、写出结构化文本文件。

A2：函数sort进行排序，_2和_4分别代表第2列和第4列，默认按顺序排序，负号代表逆序。

 

SPL也可以处理带列名（标题）的文本文件。比如orders.txt的第1行为列名，部分数据如下：

同样对该文件进行排序，结果带列名写入新文件，可用如下SPL脚本：

A1、A3：选项@t表示带列名读入、写出文本文件。

A2：用列名而不是序号进行排序。

 

函数import/export默认的分隔符是tab，选项@c表示以逗号为分隔符（常用于csv文件）。如果遇到其他特殊分隔符，SPL同样可以处理。比如orders_semi.txt以||为分隔符，可用如下SPL脚本：

 

函数export默认的功能是将数据写入新文件，或覆盖同名文件，但有时候我们需要在原文件后面追加结构相同的新数据，这种情况使用@a选项：

   

读写字符串序列

         有些文本的格式不规范，不能直接进行结构化计算，但可以读为字符串序列。这样的半结构化数据格式繁多，下面用多行记录举例，说明SPL读写字符串序列的一般方法。

文件3lines.txt中每3行的前2行对应一条记录，第3行无用，部分数据如下：

         去掉文件中的无用行，结果写入新文件，可用如下SPL脚本：

A1：读入文本文件。@n表示按行读成序列，序列的每个成员对应一行。

A2：对序列A1每隔3个成员取第1个成员和第2个成员。

A3：将序列写入文本文件，序列的每个成员对应一行。

 

 

Excel文件

读写结构化表格

结构化的Excel表格比较规范， SPL可用xlsimport/xlsexport函数进行读写。

比如：ordersNT.xlsx中第1个sheet的各列的业务意义依次是订单ID、客户编号、销售ID、订单金额、订单日期。部分数据如下：

将该表按客户编号的字母顺序从小到大的排序，相同的客户编号再按订单金额从大到小排序，最后保持原格式存入新Excel。

要计算出上述结果，可用如下SPL脚本：

A1、A3：读写excel的第1个sheet。如果要读入指定sheet，可用xlsimport(;sheet序号或sheet名)，如果要写入指定的sheet，可用xlsexport(A2; sheet序号或sheet名)

 

SPL也可以处理带列名（标题）的结构化表格，方法与文本文件类似。比如orders.xlsx部分数据如下：

对该文件进行排序，结果带列名写入新文件，可用如下SPL脚本：

 

         有时候表格的前几行无用需要跳过，比如下面的数据：

可用下面的SPL脚本，从第4行开始读取：

 

有时候我们需要在原表格后面追加结构相同的新数据，这种情况下只需使用@a选项，形如：

如果原表格的最后一个有内容的行设置了外观属性，则追加的数据会继承该行的风格。比如原表格D列风格为#,##0.00，E列风格为mmm-dd-yyyy。如下表：

则追加数据后，结果如下表：

如果原表格最后一个有内容的行之后的第一个空行设置了风格属性，则追加的数据会继承该行的风格属性。利用这个特点，我们可以实现按指定格式从无到有的输出数据。比如先建立空白Excel，设置第2行的D列风格为#,##0.00，E列风格为mmm-dd-yyyy。

再向该空白表格追加数据，结果如下：

读写二维字符串序列

         有些Excel的格式不够规范，没有明确的列属性，这种情况下可当作二维字符串序列来处理。

比如下面的key-value数据：

         现在要将上述数据按key和value拆分为2列，并按key和value排序，最后写入新的Excel。结果如下：

要计算出上述结果，可用如下SPL脚本：

A1：读入Excel，@w表示读为二维字符串序列，整体是大序列，每行既是大序列的成员，同时也是个小序列；行内每格是小序列的成员。

A2：将二维序列合并为一维序列，并去除可能的空白格，比如A1、B1、E2。

A3：将字符串序列拆分为key和value。

A4：按key、value排序。

A5：将结果写入新Excel，@w表示写入序列的序列。

读写单元格

前面的内容都是以表格或序列为单位读写Excel，有时候我们也会以精细的单元格为单位读写Excel。

比如：下面的表格在第1行有编辑者和编辑日期。

现在要将编辑者和编辑日期复制到第7行对应的位置上，结果应当如下：

要计算出上述结果，可用如下SPL脚本：

A2：以对象方式打开Excel文件。

A3：读Excel对象的A1格，赋予变量str。默认从第1个sheet读，如果想读取指定sheet里的A1单元格，可用A2.xlscell("A1",sheet序号或sheet名)

B3：将A1格内容写入A7格。类似地，如果想在指定sheet里写入A7单元格，可用A2.xlscell("A7",sheet序号或sheet名;str)

A4-B4：读E1格内容，并写入E7格

A5：将Excel对象写入Excel文件。

 

上面例子中，需要读入的A1-E1是连续单元格，需要写入的A7-E7也是连续单元格，对于这种连续单元格的读写，SPL可以用更简化的代码来实现。比如上例的代码可以改成：

A3：以序列的格式读入连续单元格

A4：向连续单元格写入序列，序列的每个成员对应一个单元格。既可以用序列向连续单元格写入数据，也可以用\t或\r分隔的字符串，其中\t表示横向分隔，\r表示纵向（跨行）分隔。

多sheet处理

使用Excel对象，不仅可用读写单元格，也可以处理多个sheet，下面举例说明。

某Excel用多个sheet存储订单表格，每个sheet的格式相同，但数量和名称不定。现在要将这些订单整理到新Excel中，每个sheet存一年的数据。

要计算出上述结果，可用如下SPL脚本：

A1：以对象方式打开源Excel文件。

A2：遍历每个sheet，读取每个sheet的订单，再合并所有订单。A1.(stname)表示从Excel对象A1中取出所有的sheet名。

A3：将订单按年份分组。

A4：以对象方式打开目标Excel文件。@w表示写模式，文件不存在时将新建文件。

A5：遍历A3的每组（每年）订单，依次写入到A4的新sheet中。

A6：@w模式打开的Excel对象必须用函数xlsclose关闭。

文件和目录

解析文件名

         函数filename可解析出文件名的不同部分：

         已知文件名的各部分，可用concat函数拼出全路径。比如：

遍历文件

某目录下有一批Excel文件，这些文件的第1个sheet存储着订单数据，且结构相同。现在要将这些订单合并到新的Excel中。

要计算出上述结果，可用如下SPL脚本：

A1：搜索目录下所有扩展名为xlsx的文件名，@p表示返回全路径。

A2：按文件名循环读入Excel，再合并数据。

函数direcotory还有更多功能，比如用@s选项递归搜索子目录，用@d选项列出子目录，用@r删除目录，用@m创建目录。

 

系统目录

前面的例子中，我们使用全路径来访问数据文件，如果配置了系统目录中的main path，则可以将main path当作根目录，用相对路径来访问数据文件。具体的配置界面参见下图：

比如，未配置main path时，脚本为：file("d:/data/p/orders.xlsx").xlsimport()

配置main path=d:\data，则脚本可写作：file("p/orders.xlsx").xlsimport()

如果没有配置main path而直接用相对路径，则实际的main path是启动集算器的目录，直接启动集算器时（或通过快捷方式启动），该目录是[集算器安装目录\bin]，双击splx文件间接启动集算器时，该目录是splx文件所在的目录。使用下面的脚本可验证main path：filename@p("")

除了main path之外，集算器还有其他较为重要的系统目录。

temp：计算引擎存放临时文件的目录，如果没有设置，则默认使用操作系统临时目录。

searching path：脚本文件的根目录，包括了main path，可以设置多个目录，目录之间用分号分隔。