Hello there! We are conducting a survey to better understand the user experience in making a first edit. If you have ever made an edit on Gamepedia, please fill out the survey. Thank you!

ComputerCraft/Fs API

Материал из Minecraft Wiki
Перейти к: навигация, поиск

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". Оставление косой черты остается на усмотрение программиста.