f.import()

阅读(2121) 标签: 文件对象, 读取内容, 序表,

描述:

读取文件内容并返回成序表。

语法:

f.import()

 

f.import(Fi:type:fmt,…;k:n,s)

从文本文件f中读取n段中的第k段数据,Fi为读出的字段,缺省读出所有字段。s为自选分隔符,缺省分隔符是tab

在分段读取时,会自动调整位置使读取到的整条内容读入记录,同时会保证读取时数据的连续性,避免出现重复或遗漏。

备注:

读取文件f,将读取的每行内容作为一个记录形成序表返回。

参数:

f

文件。

Fi

读出的字段,缺省读出所有,#时表示用序号定位。

type

字段类型,包括:boolintlongfloatdecimalstringdatetimedatetime,缺省使用第一行数据类型type为整数时表示排号键,排号数据目前只允许使用16个字节。

fmt

日期时间格式

s

自选分隔符,缺省默认分隔符是tab。省略参数s时,s前边的逗号可以省略。

k

分段号。

n

总段数。kn都省略时表示读全文件。

选项:

@t

f第一行记录作为字段名,不使用本选项就使用_1_2,…作为字段名Fi#i时仍保持原列名

@b

读取由export方式写出的二进制文件,支持参数Fikn,不支持参数types,忽略选项@t@s@i@q。记录数少或不分段文件在分段读取时可能会有空段。

@e

Fi在文件中不存在时将生成null,缺省将报错。

@s

不拆分字段,读成单字段串构成的序表,忽略参数。

@i

结果集只有1列时返回成序列。

@q

剥离数据项两端引号,包括标题,处理转义;中间的引号不管。

@a

将单引号作为引号处理,缺省不处理,与@q组合使用时也是将单引号作为引号处理。

@p

解析时处理括号和引号匹配,括号内分隔符不算,同时引号外转义也处理。

@f

不做任何解析,简单用分隔符拆成串。

@l

允许续行,行尾是转义字符\

@m

多线程取数,加快读取文件速度。结果集次序不确定,有k:n参数时忽略该选项。常用于从大文件取数。配置信息中并行数需大于1@o时可能错,有k:n参数时也是这样。

@c

 s缺省时用逗号分隔

@o

使用Excel标准转义,串中双个引号表示一个引号,其它字符不转义。

@k

保留数据项两端的空白符,缺省将自动trim

@d

行内有数据不匹配类型和格式时删除该行,此时会按type检查类型@p@q时括号和引号不匹配时也删除该行。

@n

列数和第一行不匹配也作为错误处理,将被抛弃。

@v

@d@n检查类型匹配且出错时抛出违例,并且中断程序,输出出错行的内容。

@w

将每行读成序列,返回序列的序列,列名也算作一行。

@r

先读成串再解析,避免某些字符集的错误,使用该选项速度会慢。

返回值:

序表

示例:

 

A

 

1

=file("D:\\score.txt").import()

2

=file("D:\\score.txt").import@t()

3

=file("D:\\score.txt").import(;1:2)

省略选出字段和分隔符s读取分段中的第一段数据。

4

=file("D:\\Department2.txt").import(;,"|")

省略选出字段,kn读取全文件。

5

=file("D:\\Department2.txt").import(;1:3,"|")

省略选出字段。

6

=file("D:\\EMPLOYEE.txt").import@c(GENDER;1:2)

EMPLOYEE.txt内容以逗号分隔,读取第一段数据中的GENDER的字段值。

7

=file("D:\\Department5.txt").import@t(DEPT,MANAGER:int;1:3,"/")

Department5.txt内容以斜杠分隔,按照指定字段DEPTMANAGER读出:

8

=file("D:\\score.txt").import@e(EID;1:3)

 

score.txt文件中没有字段EID,因此返回空。

9

=file("D:\\Department.txt").import@ts()

10

=file("D:\\EMPLOYEE.btx").import@b(;1:2)

读取f.export@z(A,x:F,…;)导出的集文件(分段二进制文件)EMPLOYEE.btx,并且取第1段内容。

11

=file("D:\\orders.txt").import@mt(;,",")

文件比较大,加快读取文件速度。结果跟文件里的记录顺序不一致。

12

=file("D:\\StuName.txt").import@i()

StuName.txt只有1列,返回成序列。

13

=file("D:\\test.txt").import@t()

个别标题及字段值带有引号:

14

=file("D:\\test.txt").import@tq()

使用@q选项,去除数据项两端的引号,包含标题,中间的不管:

15

=file("D:\\Sale1.txt").import()

取出Sale1.txt中的所有记录。

16

=file("D:\\ Sale1.txt").import(#1,#3)

取出Sale1.txt中的第1列与第3列。

17

=file("D:/Dep3.txt").import@cqo()

Dep3.txt文件内容:

使用@o选项,串中两个引号表示一个引号,返回结果:

18

=file("D:/Dep1.txt").import@k()

保留数据项两端的空白符。

19

=file("D:/Department1.txt").import@t(id:int,name;,"|")

20

=file("D:/Department1.txt").import@td(id:int,name;,"|")

行内有数据不匹配类型时删除该行。

21

=file("D:/Department1.txt").import@tdv(id:int,name;,"|")

检查类型匹配且出错时抛出违例,中断程序,输出出错行的内容。

22

=file("Dep2.txt").import@tdn(id:int,name,surname;,"|")

Dep2.txt文件内容:

68行列数与第一行不匹配,故忽略:

23

=file("D://EMP1.txt").import@s(;1:2)

不拆分字段,读成单字段串构成的序表,忽略参数:

24

=file("D://EMP2.txt").import(#2:date:"yyyy/MM/dd")

EMP2txt文件内容:

将文件里格式为yyyy/MM/dd的数据解析成日期类型的字段:

25

=file("City.txt").import@w()

使用@w选项,返回序列的序列:

26

=file("D://t1.txt").import@c()

t1.txt文件内容:

使用@c选项,分隔符缺省使用逗号,返回结果:

27

=file("D://t1.txt").import@cp()

使用@p选项,解析时处理括号和引号匹配:

28

=file("D://t1.txt").import@cpa()

使用@a选项,将单引号做为引号处理:

29

=file("D://t2.txt").import@l()

t2.txt内容如下:

使用@l选项,行尾为转义符\时允许续行:

30

=file("D://t3.txt").import@f()

使用@f选项,直接用分隔符拆成串:

注意:

txt文件的格式:记录间用回车符隔开,字段间用自选分隔符隔开,缺省为tab键隔开。

相关概念:

f.export()