SA

文件 File / Fs

文件读写、目录与通配查找

sa · 扩展 CLEO · 需 CLEO

文件读写、目录、通配查找。

写法见 Lua / Redux

设工作目录

SET_CURRENT_DIRECTORY · 0A99
Fs.SetCurrentDirectory

0 / 1 为预置,或字符串路径。

0A99 SET_CURRENT_DIRECTORY
in: path

打开文件

OPEN_FILE · 0A9A
File.Open

按模式打开。成功条件为真,返回句柄。

0A9A OPEN_FILE
in: filePathName, mode
out: handle

关闭文件

CLOSE_FILE · 0A9B
File.Close
0A9B CLOSE_FILE
in: self

文件大小

GET_FILE_SIZE · 0A9C
File.GetSize

已打开文件字节大小。

0A9C GET_FILE_SIZE
in: self
out: size

读字节

READ_FROM_FILE · 0A9D
File.Read

从文件读 size 字节到目标。

0A9D READ_FROM_FILE
in: self, size
out: destination

写字节

WRITE_TO_FILE · 0A9E
File.Write

把源起始 size 字节写入文件。

0A9E WRITE_TO_FILE
in: self, size, source

定位

FILE_SEEK · 0AD5
File.Seek

origin 为 SeekOrigin。条件表示是否成功。

0AD5 FILE_SEEK
in: self, offset, origin

是否到 EOF

IS_END_OF_FILE_REACHED · 0AD6
File.IsEndReached

已读完或出错时条件为真。

0AD6 IS_END_OF_FILE_REACHED
in: self

读字符串

READ_STRING_FROM_FILE · 0AD7
File.ReadString

读一行文本(最多 maxLength-1,遇换行 / EOF 停)。

0AD7 READ_STRING_FROM_FILE
in: self, storeTo, maxLength

写字符串

WRITE_STRING_TO_FILE · 0AD8
File.WriteString

写字符串(不含结尾 \0)。

0AD8 WRITE_STRING_TO_FILE
in: self, source

格式化写

WRITE_FORMATTED_STRING_TO_FILE · 0AD9
File.WriteFormattedString

printf 格式化后写入文件。

0AD9 WRITE_FORMATTED_STRING_TO_FILE
in: self, format, args...

扫描文件

SCAN_FILE · 0ADA
File.Scan

sscanf 风格从文件解析。

0ADA SCAN_FILE
in: self, format
out: nValues, values...

文件是否存在

DOES_FILE_EXIST · 0AAB
Fs.DoesFileExist

用在 if 里。

0AAB DOES_FILE_EXIST
in: path

目录是否存在

DOES_DIRECTORY_EXIST · 0AE4
Fs.DoesDirectoryExist
0AE4 DOES_DIRECTORY_EXIST
in: path

创建目录

CREATE_DIRECTORY · 0AE5
Fs.CreateDirectory

条件表示是否成功。

0AE5 CREATE_DIRECTORY
in: path

查找第一个

FIND_FIRST_FILE · 0AE6
FindFile.First

通配找第一个匹配项,返回查找句柄和名字。

0AE6 FIND_FIRST_FILE
in: searchMask
out: handle, fileName

查找下一个

FIND_NEXT_FILE · 0AE7
FindFile.Next

继续 FIND_FIRST_FILE

0AE7 FIND_NEXT_FILE
in: self
out: fileName

关闭查找

FIND_CLOSE · 0AE8
FindFile.Close
0AE8 FIND_CLOSE
in: self

On this page