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