f.import()

f.import()

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

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

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

f

文件。

F_i

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

type

字段类型，包括：bool、int、long、float、decimal、string、date、time和datetime，缺省使用第一行数据类型。type为整数时表示排号键，排号数据目前只允许使用16个字节。

fmt

日期时间格式。

s

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

k

分段号。

n

总段数。k和n都省略时表示读全文件。

@t

f中第一行记录作为字段名,不使用本选项就使用_1，_2,…作为字段名，F_i是#i时仍保持原列名。

@b

读取由export方式写出的二进制文件，支持参数F_i、k和n，不支持参数type和s，忽略选项@t@s@i@q@a@n@k @p@f@l@m@c@o@d@v@r。记录数少或不分段文件在分段读取时可能会有空段。

@e

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

@s

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

@i

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

@q

剥离数据项两端引号，包括标题，处理转义；中间的引号不作处理。

@a

将单引号作为引号处理，缺省不处理，可与@q@p组合使用。

@p

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

@f

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

@l

允许续行，行尾是转义字符\。

@m

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

@c

 s缺省时用逗号分隔。

@o

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

@k

保留数据项两端的空白符，缺省将自动删除两端空白符。

@d

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

@n

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

@v

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

@w

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

@r

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

@y

使用定长方式解析数据，fmt解释为字段的宽度；type为日期时间类型数据时，用fmt计算出宽度。

与@t选项互斥，Fi解释为结果集字段名，省略表示跳过该字段，不可改变原文件中字段次序。

有@e时，未写fmt的字段认为是加入的空字段，否则报错。

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(;,"|")

省略选出字段，k和n。读取全文件。

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内容以斜杠分隔，按照指定字段DEPT和MANAGER读出：

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文件内容：

第6、8行列数与第一行不匹配，故忽略：

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选项，直接用分隔符拆成串：

A

1

=file("um.txt")

2

=A1.import()

读取um.txt文件中的数据，返回内容如下：

3

=A1.import@y(UID:int:1,Amount:int:5,Udate:string:18)

使用@y选项，用定长方式解析数据，第一列数据宽度为1，数据类型为int，列名为UID；第二列数据宽度为5，数据类型为int，列名为Amount；第二列数据宽度为18，数据类型为string，列名为Udate，返回结果如下：

4

=A1.import@y(UID:int:1,Amount:int:5,Udate:datetime:"yyyy-MM-ddHH:mm:ss")

第三列为日期时间类型，可以根据时间日期格式计算出列宽度，返回结果如下：

5

=A1.import@ye(UID:int:1,UName::8,Amount:int:5,Udate:string:18)

有@e时，第二列中fmt参数为空认为是加入的空字段，返回结果如下：