ComputerCraft/Fs API
FS API позволяет управлять файлами и файловой системой.
Название метода | Возвращаемое значение | Описание |
---|---|---|
fs.list(string путь) | table список файлов | Возвращает список файлов (включая поддиректории, но не их содержимое), которые содержатся в директории. Список представлен в виде численно индексированного массива. |
fs.exists(string путь) | boolean есть или нет | Проверяет, ссылается ли путь на файл или директорию. |
fs.isDir(string путь) | boolean директория или нет | Проверяет, ссылает ли путь на существующую директорию. |
fs.isReadOnly(string путь) | boolean только для чтения или нет | Проверяет, является ли путь файлом только для чтения (то есть не может быть изменен). |
fs.getName(string путь) | string имя файла или директории | Возвращает последний компонент пути (имя файла или папки). |
fs.getDrive(string путь) | string путь к диску/nil | Возвращает путь к носителю данных или nil в случает его отсутствия. |
fs.getSize(string путь) | number размер | Возвращает размер файла в байтах. |
fs.getFreeSpace(string путь) | number пространство | Возвращает оставшееся пространство на диске, содержащем указанную директорию. |
fs.makeDir(string путь) | nil | Создает директорию. |
fs.move(string пуст источника, string путь назначения) | nil | Перемещает файл или папку в новое место. |
fs.copy(string пуст источника, string путь назначения) | nil | Копирует файл или папку в новое место. |
fs.delete(string путь) | nil | Удаляет файл или папку. |
fs.combine(string основной путь, string дополнительный путь) | string путь | Совмещает две части пути, возвращая путь, состоящий из дополнительного пути, добавленного к основному. |
fs.open(string пусть, string режим) | table указатель на файл | Открывает файл для чтения или записи. |
fs.find(string маска) | table список файлов | Ищет файлы, используя маску для поиска. Требуется версия 1.6 или новее. |
fs.getDir(string путь) | string родительская директория | Возвращает родительскую директорию файла или папки. Требуется версия 1.63 или новее. |
fs.complete(string частичное имя, string путь [, boolean включает ли файлы] [, boolean включает в себя поддиректории]) | table | Возвращает список строк, которые могут быть объединены с указанным именем, чтобы произвести валидный вход в папку. Требуется версия 1.74 или новее. |
Путь
Все функции, за исключением fs.complete
, принимают только абсолютный путь.
Это означает, что текущий рабочий каталог, который установлен командой cd
или методом shell.setDir
, игнорируется. Каждый путь состоит из списка не пустых компонентов, разделённых косыми чертами ( /
), и эти компоненты принимаются по одному, начиная с первого, который содержится в корневом каталоге компьютера.
Если необходимо работать с путями, предоставленными пользователем, которые могут быть абсолютными или относительными для текущего рабочего каталога, используйте shell.resolve
.
В отличие от большинства настоящих операционных систем, система абсолютных путей ComputerCraft, необязательно должна начинаться с косой черты, создавая каталог "a/b/c" как "/a/b/c". Оставление косой черты остается на усмотрение программиста.