love.filesystem
Предоставляет интерфейс к файловой системе пользователя.
Этот модуль предоставляет доступ к файлам в определенных местах:
- Корневая папка архива .love (или исходной директории)
- Корневая папка директории сохранения игры.
- Папка, содержащая архив .love игры (или исходную директорию), но только при выполнении определенных условий.
Каждой игре предоставляется отдельная директория на системе, где файлы могут быть сохранены с помощью love.filesystem. Это единственная директория, где love.filesystem может записывать файлы. Эти директории, как правило, находятся по пути:
| ОС | Путь | Альтернатива | Примечания |
|---|---|---|---|
| Windows XP |
C:\Documents and Settings\user\Application Data\LOVE\ |
%appdata%\LOVE\ | При слиянии директория сохранения будет создана непосредственно внутри Application Data, а не как поддиректория LOVE. |
| Windows Vista, 7, 8 и 10 |
C:\Users\user\AppData\Roaming\LOVE |
%appdata%\LOVE\ | При слиянии директория сохранения будет создана непосредственно внутри AppData, а не как поддиректория LOVE. |
| Mac |
/Users/user/Library/Application Support/LOVE/ | - | - |
| Linux |
$XDG_DATA_HOME/love/ |
~/.local/share/love/ | - |
| Android |
/data/user/0/org.love2d.android/files/save/ |
/data/data/org.love2d.android/files/save/ | В Android есть различные места сохранения. Если они не работают, вы можете использовать love.filesystem.getSaveDirectory() для проверки. |
Файлы, открытые для записи или добавления, всегда будут созданы в директории сохранения. То же самое относится и к другим операциям, связанным с записью в файловую систему, таким как createDirectory.
Файлы, открытые для чтения, будут искаться в директории сохранения, а затем в архиве .love (в указанном порядке). Поэтому, если файл с определенным именем (и путем) существует как в архиве .love, так и в папке сохранения, приоритет отдаётся файлу в папке сохранения.
Примечание: Все пути относительны к архиву .love и директории сохранения. (кроме вызовов get*Directory())
Рекомендуется сначала установить идентификатор вашей игры в вашем conf.lua. Вы можете установить его с помощью love.filesystem.setIdentity также.
Типы
| DroppedFile | Представляет файл, переданный из окна. | 0.10.0 | |
| File | Представляет файл в файловой системе. | ||
| FileData | Данные, представляющие содержимое файла. |
Функции
| love.filesystem.append | Добавить данные в существующий файл. | 0.9.0 | |
| love.filesystem.areSymlinksEnabled | Получить, следует ли love.filesystem следовать символическим ссылкам. | 0.9.2 | |
| love.filesystem.createDirectory | Создать директорию. | 0.9.0 | |
| love.filesystem.enumerate | Возвращает все файлы и подкаталоги в каталоге. | 0.3.0 | 0.9.0 |
| love.filesystem.exists | Проверить, существует ли файл или каталог. | 11.0 | |
| love.filesystem.getAppdataDirectory | Возвращает каталог данных приложения (может быть таким же, как getUserDirectory) | ||
| love.filesystem.getCRequirePath | Получить пути к файловой системе, которые будут проверяться на наличие c-библиотек при вызове require. | 11.0 | |
| love.filesystem.getDirectoryItems | Возвращает все файлы и подкаталоги в каталоге. | 0.9.0 | |
| love.filesystem.getIdentity | Получить имя каталога записи для вашей игры. | 0.9.0 | |
| love.filesystem.getInfo | Получить информацию о заданном файле или каталоге. | 11.0 | |
| love.filesystem.getLastModified | Получить время последней модификации файла. | 0.7.1 | 11.0 |
| love.filesystem.getRealDirectory | Получить абсолютный путь к каталогу, содержащему путь к файлу. | 0.9.2 | |
| love.filesystem.getRequirePath | Получить пути к файловой системе, которые будут проверяться при вызове require. | 0.10.0 | |
| love.filesystem.getSaveDirectory | Получить полный путь к назначенному каталогу сохранения. | 0.5.0 | |
| love.filesystem.getSize | Получить размер файла в байтах. | 0.9.0 | 11.0 |
| love.filesystem.getSource | Возвращает полный путь к файлу .love или каталогу. | 0.9.0 | |
| love.filesystem.getSourceBaseDirectory | Возвращает полный путь к каталогу, содержащему файл .love. | 0.9.0 | |
| love.filesystem.getUserDirectory | Возвращает путь к каталогу пользователя | ||
| love.filesystem.getWorkingDirectory | Получить текущий рабочий каталог. | 0.5.0 | |
| love.filesystem.init | Инициализирует love.filesystem, будет вызываться внутри, поэтому не следует использовать явно. | ||
| love.filesystem.isDirectory | Проверить, является ли что-то каталогом. | 11.0 | |
| love.filesystem.isFile | Проверить, является ли что-то файлом. | 11.0 | |
| love.filesystem.isFused | Получить, находится ли игра в режиме слияния или нет. | 0.9.0 | |
| love.filesystem.isSymlink | Узнать, является ли путь к файлу фактически символической ссылкой. | 0.9.2 | 11.0 |
| love.filesystem.lines | Итерироваться по строкам в файле. | ||
| love.filesystem.load | Загрузить Lua-файл (но не выполнить его). | 0.5.0 | |
| love.filesystem.mkdir | Создать директорию. | 0.9.0 | |
| love.filesystem.mount | Подмонтировать zip-файл или папку в каталог сохранения игры для чтения. | 0.9.0 | |
| love.filesystem.newFile | Создать новый объект File. | ||
| love.filesystem.newFileData | Создать новый объект FileData из файла на диске или из строки в памяти. | 0.7.0 | |
| love.filesystem.read | Прочитать содержимое файла. | ||
| love.filesystem.remove | Удалить файл (или каталог). | ||
| love.filesystem.setCRequirePath | Установить пути к файловой системе, которые будут проверяться на наличие c-библиотек при вызове require. | 11.0 | |
| love.filesystem.setIdentity | Установить каталог записи для вашей игры. | ||
| love.filesystem.setRequirePath | Установить пути к файловой системе, которые будут проверяться при вызове require. | 0.10.0 | |
| love.filesystem.setSource | Устанавливает источник игры, где находится код. Используется внутри. | ||
| love.filesystem.setSymlinksEnabled | Установить, следует ли love.filesystem следовать символическим ссылкам. | 0.9.2 | |
| love.filesystem.unmount | Размонтировать zip-файл или папку, ранее смонтированные с помощью love.filesystem.mount. | 0.9.0 | |
| love.filesystem.write | Записать данные в файл. |
Перечисления
| FileDecoder | Как декодировать заданный FileData. | 0.7.0 | 11.0 |
| FileMode | Различные режимы открытия File. | ||
| FileType | Тип файла. | 11.0 |
См. также
© 2006–2020 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/love.filesystem
