本章介绍export()函数的多种用法。
描述:
将序列转成字符串
语法:
A.export(x:F,…;s)
备注:
将序表/排列/序列A中的每条记录,选出字段x并用自选分隔符s隔开,结果以字符串形式返回,结果字符串中的字段名为F。
当省略参数x时,输出所有字段,A是序列时生成无名称的单列串,A成员是序列时则再拼上分隔符。排号按作整数存。
当省略参数x:F时,若A是包含记录的序列,则记录必须是相同数据结构。
当A的记录或成员为序列/记录/序表时将返回json串,为排号键则写成十六进制串。
选项:
@t |
列名作为第一条记录写在字符串开头 |
@c |
无s时用逗号分隔。如果同时存在s则用s分隔。 |
@w |
换行符使用windows风格,即用\r\n,缺省按照操作系统规定。 |
@q |
导出的文本字段值和标题带有引号 |
@o |
使用Excel标准转义,串中双个引号表示一个引号,其它字符不转义,该选项需要与@q配合使用 |
参数:
A |
需要输出的序表/排列/序列 |
x |
输出的字段,省略则输出A中所有字段 |
F |
字串中的结果字段名,省略则使用原字段名 |
s |
字段间自选分隔符,缺省分隔符是tab |
返回值:
字符串
示例:
|
A |
|
1 |
=demo.query("select EID,NAME from EMPLOYEE") |
|
2 |
=A1.export() |
省略x、F和s参数 |
3 |
=A1.export(;"|") |
指定分隔符为“|” |
4 |
=A1.export@t(EID:id,NAME:name;",") |
指定选出字段和分隔符,并且将列名作为第一条记录写在字符串开头 |
5 |
[1,23,34,45] |
序列 |
6 |
=A5.export() |
|
7 |
=A1.export@c() |
使用@c选项,无s参数时默认用逗号分隔 |
8 |
=A1.export@w() |
换行符使用windows风格,即用\r\n |
9 |
=["12\r34","aa\nbb"] |
|
10 |
=A9.export() |
|
11 |
=A9.export@q() |
使用@q选项,导出的内容带有引号 |
12 |
<xml><row><DEPTID>1</DEPTID><DEPTNAME>sale</DEPTNAME><FATHER>12</FATHER></row><row><DEPTID>10</DEPTID><DEPTNAME>create</DEPTNAME><FATHER>12</FATHER></row></xml> |
|
13 |
=xml(A12) |
返回由序表组成的记录 展开: 再展开: |
14 |
=A13.export() |
返回json串 |
15 |
=file("D://t4.txt").import@coq() |
t4.txt内容如下: A15结果: |
16 |
=A15.export@coq() |
使用@o选项,串中两个引号表示一个引号 |
注意:
字符串的格式:记录间用空格隔开,字段间用自选分隔符隔开,缺省为tab键隔开
相关概念:
描述:
将序列/排列/序表写入文件
语法:
f.export(A,x:F,…;s)
备注:
将A以文本形式写入文件f。当文件不存在时,自动创建(但不能自动创建路径目录),创建的文件缺省为文本格式。
当A是排列或者序表时,x参数不存在则写入所有字段,A中不可输出的字段不能写入文件f,当字段取值为引用记录,则写入记录的主键。
当A是序列时,A必须是由相同数据结构的记录组成的序列;x参数不存在则将无字段名的单列文本写入文件f。
当A中成员为序列/记录/序表将缺省写成json串;当A中存在排号类型的字段时,此字段值以十六进制串形式写入。二进制输出时则使用原数据类型。
选项:
@t |
将字段信息(标题)作为第一行写入文件 |
@a |
追加写入;追加的内容要与原文件内容结构相同,否则报错;文件已有内容时忽略@t;缺省覆盖原文件。 |
@b |
写成二进制文件,速度更快。忽略@t;小文件不分段,足够大则重写分段。有s参数时认为A对s有序,仅在s变化时才分段;追加写时新数据的s值必须是不同的。 |
@c |
不存在参数s时用逗号分隔;存在参数s时则用s分隔。 |
@w |
换行符使用windows风格,即用\r\n,缺省操作系统规定。同时使用@b时,将序列的序列写成结构化数据,第一行作为字段名 |
@q |
导出的文本字段值和标题都带有引号 |
@o |
使用Excel标准转义,串中双个引号表示一个引号,其它字符不转义 |
参数:
f |
文件 |
A |
需要输出的序表/排列/序列,A成员是序列时,则再拼上分隔符写出。 |
x |
需要输出的字段,省略则导出A排列中所有可文本化字段,用#时表示用序号定位 |
F |
结果字段名,省略则使用原字段名 |
s |
对于文本文件为自选分隔符,缺省默认分隔符是tab |
示例:
– 将排列写入到文本文件中。
|
A |
|
1 |
=demo.query("select * from DEPARTMENT") |
|
2 |
=file("D:\\Department.txt").export(A1) |
|
3 |
=file("D:\\Department.txt").export@t(A1)
|
使用@t选项,第一行的字段信息作为标题写入 |
4 |
=file("D:\\Department2.txt").export(A1;"|") |
|
5 |
=file("D:\\Department2.txt").export(A1;) |
|
6 |
=file("D:\\Department2.txt").export@a(A1) |
接上例,在文件内容后追加A1中的内容 |
7 |
=file("D:\\Department3.txt").export@b(A1) |
写成二进制文件 |
8 |
=file("D:\\Department4.txt").export@t(A1,DEPT:Dept1;"|") |
x不省略时,只导出指定字段 |
9 |
=file("D:\\dept1.txt").export@ta(A1) |
dept1.txt不存在,执行后创建dept1.txt,并且导出第一行为标题 |
10 |
[a,s,d,f] |
|
11 |
=file("D:\\myfile.txt").export(A10) |
myfile.txt为无字段名单列文件 |
12 |
=file("D:\\Department6.txt").export@c(A1) |
|
13 |
=demo.query("select * from EMPLOYEE order by GENDER") |
按GENDER排序 |
14 |
=file("D:\\EMPLOYEE.btx ").export@b(A12,EID,NAME,SURNAME,GENDER,SALARY;GENDER) |
将A13的返回结果导出到EMPLOYEE. btx文件中,默认为A13对GENDER有序 |
15 |
=file("D:\\EMPLOYEE.txt").export@w(A1) |
换行符使用windows风格,即用\r\n |
16 |
=demo.query("select * from DEPARTMENT").keys(MANAGER) |
|
17 |
=A13.switch(DEPT,A16:DEPT) |
|
18 |
=file("D:\\EMPLOYEE1.txt").export@t(A17) |
A17中DEPT为引用记录则导出记录的主键 |
19 |
=demo.query("select * from DEPARTMENT") |
|
20 |
=file("D:\\Department7.txt").export(A19,#1) |
#1表示第一列,所以只导出了第一列的数据 |
21 |
=file("D:\\Dep1.txt").export@q(A19,#1) |
|
22 |
f1,f2,f3 2,"dd""ff",3 |
|
23 |
=A22.import@coq() |
|
24 |
=file("D://t5.txt").export@coq(A23) |
使用@o选项,串中两个引号表示一个引号,写出的t5.txt内容如下: |
注意:
txt文件的格式:记录间用回车符隔开,字段间用自选分隔符隔开,缺省为tab键隔开
相关概念:
描述:
将游标中的数据读出后写入到文本文件中
语法:
f.export(cs,x:F,…;s)
备注:
将游标cs以文本形式写进文件对象f。当文件不存在时,自动创建这个文件(不能自动创建路径目录)。
选项:
@t |
将字段信息(标题)作为第一行写入文件 |
@a |
追加写,如果省略则是覆盖原文件中的内容,与@t互斥。必须保证同构,否则报错。 |
@b |
写成二进制文件,速度更快,忽略@t,不支持参数s |
@c |
无s时用逗号分隔。如果同时有s则用s分隔。 |
@z |
强制@b,分段写入到二进制文件f中,缺省不分段。此选项中s为分组表达式,有s参数时认为cs 对s有序,仅在s变化时才分段。此二进制文件用于并行数据量大时的分段导出,导出时同一段的记录不会被拆开。 |
@w |
换行符使用windows风格,即用\r\n,缺省用操作系统规定 |
@q |
导出的文本字段值和标题都带有引号 |
@o |
用引号作为转义符,缺省用java风格的\,需要与@q配合使用 |
参数:
f |
文件对象 |
cs |
需要输出的游标数据 |
x |
需要输出的字段,省略则导出A排列中所有可文本化字段,用#时表示用序号定位 |
F |
结果字段名,省略则使用原字段名 |
s |
自选分隔符,缺省默认分隔符是tab |
示例:
– 将游标数据写入到文本文件中。
|
A |
|
1 |
=demo.cursor("select * from DEPARTMENT") |
|
2 |
=file("D:\\Department1.txt").export(A1) |
tab分隔符 |
3 |
=demo.cursor("select * from DEPARTMENT") |
|
4 |
=file("D:\\Department2.txt").export(A3;"/") |
指定分隔符“/” |
5 |
=demo.cursor("select * from DEPARTMENT") |
|
6 |
=file("D:\\Department3.txt").export@t(A5) |
第一行的字段信息作为标题写入
|
7 |
=demo.cursor("select * from DEPARTMENT") |
|
8 |
=file("D:\\Department4.txt").export@t(A7,DEPT:Dept1,DEPT:Dept2;"|") |
x不省略时,导出指定字段 |
9 |
=demo.cursor("select * from DEPARTMENT") |
|
10 |
=file("D:\\Department5.txt").export@t(A9,DEPT,MANAGER;"/") |
省略F则使用原字段名。 |
11 |
=demo.cursor("select * from DEPARTMENT") |
|
12 |
=file("D:\\Department5.txt").export@a(A11,DEPT,MANAGER;"/") |
接上例,在Department5.txt内容的后边追加A12中的内容 |
13 |
=demo.cursor("select * from DEPARTMENT") |
|
14 |
=file("D:\\Department6.txt").export@b(A13) |
写成二进制文件,速度更快 |
15 |
=demo.cursor("select * from DEPARTMENT") |
|
16 |
=file("D:\\Departmen7.txt").export@c(A15) |
使用逗号作为分隔符 |
17 |
=demo.cursor("select * from EMPLOYEE order by GENDER") |
按GENDER排序 |
18 |
=file("D:\\EMPLOYEE1.btx ").export@z(A17,EID,NAME,SURNAME,GENDER,SALARY;GENDER) |
导出分段二进制文件,按GENDER分组导出到EMPLOYEE. btx文件中 |
19 |
=demo.cursor("select * from EMPLOYEE order by GENDER") |
|
20 |
=file("D:\\EMPLOYEE2.txt").export@w(A19) |
换行符使用windows风格,即用\r\n |
21 |
=demo.cursor("select * from DEPARTMENT") |
|
22 |
=file("D:\\Department8.txt").export(A21,#1) |
#1表示第一列,所以结果导出游标中的第一列的数据 |
23 |
=file("D:\\Dep1.txt").export@q(A21) |
导出的文本字段值和标题都带有引号 |
24 |
=["12\r34","aa\nbb"].cursor() |
游标中的数据内容: |
25 |
=file("D:\\Dep2.txt").export@q(A24) |
|
26 |
=file("D:\\Dep3.txt").export@qo(A24) |
用引号作为转义符 |
相关概念: