[ Skill ] 文件读写 & IO 句柄

https://www.cnblogs.com/yeungchie/

在 Skill 中使用一种叫做 ioport 类型的变量来操作文件。不过我一般更习惯称为 IO 句柄 (IO/File Handle)。

常用下面两个函数来获得这些 IO 句柄：

• infile
  
  获得输入句柄，读 文件。
• outfile
  
  获得输出句柄，写 文件。

输入

输入句柄 infile

假设现有一个文件 file.txt

$ cat -n file.txt
     1  2022-02-20
     2  20:39:29
     3  Sunday

获取一个输入句柄，打开这个文件。

inHandle = infile( "file.txt" )

行读取 gets

用 gets 可以将按 行 迭代文件内容（一行一行读取），全部内容读取完会返回 nil。

gets( string inHandle )

上面这个操作将第一行的内容赋值给了 string 变量。

printf( "%s\n" string )
; 2022-02-20

也可以将第一个参数指定为 nil，不赋值给变量，通过函数返回值的读取内容，类似 sprintf 函数。

再次使用 gets 则会继续读取第二行内容。

printf( "%s\n" gets( nil inHandle ))
; 20:39:29

字读取 getc

用 getc 可以将按 单个字符 迭代文件内容（一个字一个字读取），全部内容读取完会返回 nil。

和 gets 有点不同，getc 返回 symbol 类型，且第一个变量为句柄。

printf( "%s\n" getc( inHandle ))
; S

读取完剩下内容，并打印出来。

while( char = getc( inHandle )
  printf( "%s\n" char )
)
; u
; n
; d
; a
; y

读取结束后记得关闭这个句柄。

close( inHandle )

输出

输出句柄 outfile

获取一个输出句柄，打开一个文件，打开方式如果没有指定则默认为 w，这会覆盖原有内容。

outHandle = outfile( "file.txt" )

打印输出 fprintf

用 fprintf 将字符串输出到 IO 句柄，下面写点东西进去。

fprintf( outHandle "%s\n" "2022-02-20")
close( outHandle )

$ cat -n file.txt
     1  2022-02-20

打开方式 mode

上面提到 outfile 的默认打开方式 w 会覆盖源文件内容，当我们需要在源文件基础上追加内容时，可以在第二个参数指定 a ，代表 append 方式。

outHandle = outfile( "file.txt" "a" )
fprintf( outHandle "%s\n" "21:06:13")
close( outHandle )

$ cat -n file.txt
     1  2022-02-20
     2  21:06:13

关闭

关闭句柄 close

上面的例子中已经出现过了，功能很简单，IO 句柄用完后关掉它，解除与文件的关联，释放资源（文件句柄资源是有限的）。

close( inHandle )
close( outHandle )

预设句柄

预设的几个句柄变量。

标准输入

• piport

标准输入句柄，类似于 C 中的 stdin。

可以配合函数 get_filename 来获取当前文件的文件名（路径）：

$ cat -n piport.il
     1  printf( "The value is %s\n" get_filename( piport ))

load( "piport.il" )
The value is piport.il

• stdin

这个变量在 help 文档中描述是和 piport 类似的，但两者又不相等。

stdin == piport
; nil

也无法配合 get_filename 函数：

$ cat -n stdin.il
     1  printf( "The value is %s\n" get_filename( stdin ))

load( "stdin.il" )
The value is *stdin*

也不像 Perl 中的 <STDIN> 能获取终端上的用户输入，我暂时没找到应用场景。

标准输出

• poport

标准输出句柄，类似于 C 中的 stdout。

在使用一些 常用的 print 函数 向 CIW 打印数据时，其实省略了指向标准输出这一步，例如 printf：

printf( "%s\n" getCurrentTime())
; Feb 21 21:19:42 2022

也可以写成 fprintf：

fprintf( poport "%s\n" getCurrentTime())
; Feb 21 21:20:47 2022

效果是一样的。

• ptport

跟 poport 一样的。

ptport == poport
; t

• stdout

跟 poport 一样的。

stdout == poport
; t

错误输出

• errport

错误输出句柄，类似于 C 中的 stderr，用于打印错误信息，在 CIW 上会显示红色的字体。

fprintf( poport "Unremarkable infomation ~\n" )

Unremarkable infomation ~

fprintf( errport "Error infomation !\n" )

Error infomation !

• stderr

跟 errport 一样的。

stderr == errport
; t

警告输出

• woport

警告输出句柄，也类似于 C 中的 stdout，用于打印警告信息，在 CIW 上会显示黄色的字体。

fprintf( woport "Warning infomation !\n" )

Warning infomation !

刷新缓冲区

刷新输出缓冲区

drain( poport )

不过我一般用这个

hiFlushCIW()