---
title: "文件 File / Fs"
description: "文件读写、目录与通配查找"
---
---
title: 文件 File / Fs
description: 文件读写、目录与通配查找
---
`sa` · 扩展 `CLEO` · 需 CLEO
文件读写、目录、通配查找。
写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 设工作目录
`0` / `1` 为预置，或字符串路径。
```text
0A99 SET_CURRENT_DIRECTORY
in: path
```
```lua
setCurrentDirectory(0)
```
```js
Fs.setCurrentDirectory(path)
```
## 打开文件
按模式打开。成功条件为真，返回句柄。
```text
0A9A OPEN_FILE
in: filePathName, mode
out: handle
```
```lua
local f = openFile("cleo/data.txt", "rb")
if f then
-- ok
end
```
```js
const handle = File.open(filePathName, mode)
```
## 关闭文件
```text
0A9B CLOSE_FILE
in: self
```
```lua
closeFile(f)
```
```js
File.close(self)
```
## 文件大小
已打开文件字节大小。
```text
0A9C GET_FILE_SIZE
in: self
out: size
```
```lua
local size = getFileSize(f)
```
```js
const size = File.getSize(self)
```
## 读字节
从文件读 `size` 字节到目标。
```text
0A9D READ_FROM_FILE
in: self, size
out: destination
```
```lua
local data = readFromFile(f, 4)
```
```js
const destination = File.read(self, size)
```
## 写字节
把源起始 `size` 字节写入文件。
```text
0A9E WRITE_TO_FILE
in: self, size, source
```
```lua
writeToFile(f, 4, data)
```
```js
File.write(self, size, source)
```
## 定位
`origin` 为 SeekOrigin。条件表示是否成功。
```text
0AD5 FILE_SEEK
in: self, offset, origin
```
```lua
fileSeek(f, 0, 0)
```
```js
File.seek(self, offset, origin)
```
## 是否到 EOF
已读完或出错时条件为真。
```text
0AD6 IS_END_OF_FILE_REACHED
in: self
```
```lua
if isEndOfFileReached(f) then
-- eof
end
```
```js
if (File.isEndReached(self)) {
}
```
## 读字符串
读一行文本（最多 maxLength-1，遇换行 / EOF 停）。
```text
0AD7 READ_STRING_FROM_FILE
in: self, storeTo, maxLength
```
```lua
local line = readStringFromFile(f, 128)
```
```js
File.readString(self, storeTo, maxLength)
```
## 写字符串
写字符串（不含结尾 `\0`）。
```text
0AD8 WRITE_STRING_TO_FILE
in: self, source
```
```lua
writeStringToFile(f, "hello")
```
```js
File.writeString(self, source)
```
## 格式化写
printf 格式化后写入文件。
```text
0AD9 WRITE_FORMATTED_STRING_TO_FILE
in: self, format, args...
```
```lua
writeFormattedStringToFile(f, "hp=%d", 100)
```
```js
File.writeFormattedString(self, format, ...args)
```
## 扫描文件
sscanf 风格从文件解析。
```text
0ADA SCAN_FILE
in: self, format
out: nValues, values...
```
```lua
local n, v = scanFile(f, "%d")
```
```js
const { nValues, values } = File.scan(self, format)
```
## 文件是否存在
用在 `if` 里。
```text
0AAB DOES_FILE_EXIST
in: path
```
```lua
if doesFileExist("cleo/cfg.ini") then
-- exists
end
```
```js
if (Fs.doesFileExist(path)) {
}
```
## 目录是否存在
```text
0AE4 DOES_DIRECTORY_EXIST
in: path
```
```lua
if doesDirectoryExist("cleo/mods") then
end
```
```js
if (Fs.doesDirectoryExist(path)) {
}
```
## 创建目录
条件表示是否成功。
```text
0AE5 CREATE_DIRECTORY
in: path
```
```lua
createDirectory("cleo/out")
```
```js
Fs.createDirectory(path)
```
## 查找第一个
通配找第一个匹配项，返回查找句柄和名字。
```text
0AE6 FIND_FIRST_FILE
in: searchMask
out: handle, fileName
```
```lua
local h, name = findFirstFile("cleo/*.cs")
```
```js
const { handle, fileName } = FindFile.first(searchMask)
```
## 查找下一个
继续 `FIND_FIRST_FILE`。
```text
0AE7 FIND_NEXT_FILE
in: self
out: fileName
```
```lua
local name = findNextFile(h)
```
```js
const fileName = FindFile.next(self)
```
## 关闭查找
```text
0AE8 FIND_CLOSE
in: self
```
```lua
findClose(h)
```
```js
FindFile.close(self)
```