InnerCore/Модуль FileTools

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

Для создания, чтения и редактирования файлов Inner Core имеет модуль FileTools, который предоставляет удобные функции для работы с файлами, а также ряд переменных, используемых при работе с файлами.

Переменные для работы с файлами в Inner Core[править]

  • FileTools.mntdir - возвращает путь до хранилища смонтированных папок Android ("/mnt")
  • FileTools.root - возвращает путь до внешнего хранилища файлов устройства (путь к домашней папке), заканчивается на "/"
  • FileTools.workdir - возвращает относительный путь до папки Core Engine ("games/com.mojang/coreengine/")
  • FileTools.moddir - возвращает относительный путь до папки с модами ("games/com.mojang/mods/")
  • FileTools.modpedir - возвращает относительный путь до папки ModPE ("games/com.mojang/modpe/"). На данный момент в этой папке иногда пролетают перекатиполе, больше там ничего нету

Методы для работы с файлами в Inner Core[править]

  • FileTools.mkdir(path) - создает папку по указанному пути
  • FileTools.mkworkdirs() - создает рабочие папки Core Engine (workdir, moddir, modpedir)
  • FileTools.getFullPath(path) - возвращает абсолютный путь к файлу по его относительному к пути. Относительный путь не должен начинаться с "/". Если аргумент уже является полным путём к файлам внешнего хранилища или хранилища смонтированных папок Android, функция вернёт путь без изменений. Большинство других методов FileTools работают через него, поэтому в них можно передавать относительный путь
  • FileTools.isExists(path) - проверяет, существует ли файл или папка по пути path. Параметр может быть как абсолютным путём, так и относительным
  • FileTools.WriteText(path, value, add) - записывает строку value в файл по пути path, если add равен true, то добавляет value в конец файла, если false или не указан, то файл перезаписывается
  • FileTools.ReadText(path) - считывает файл по пути path в строку
  • FileTools.WriteImage(path, image) - записывает изображение, объект типа Bitmap, в файл по пути path
  • FileTools.ReadImage(path) - считывает изображение по пути path в объект типа Bitmap
  • FileTools.ReadTextAsset(path) - считывает файл из ресурспака по пути path в строку
  • FileTools.ReadImageAsset(path) - считывает изображение из ресурспака по пути path в объект типа Bitmap
  • FileTools.ReadBytesAsset(path) - считывает байты из ресурспака по пути path в Java-массив типа byte
  • FileTools.GetListOfDirs(path) - возвращает список каталогов по данному пути в виде Javascript-массива объектов File
  • FileTools.GetListOfFiles(path, extension) - возвращает список файлов по данному пути в виде Javascript-массива объектов File. Если задан второй аргумент, возвращает только файлы с заданным расширением
  • FileTools.ReadKeyValueFile(path, separator) - возвращает объект, состоящих из пар ключ-значение, считанных из файла по пути path. Если не задан разделитель, по умолчанию используется разделитель ":". При этом ни ключ, ни значение не очищаются от пробелов, поэтому следует делать это вручную при необходимости. Пример файла:
key1:value1
key2:value2
key3:value3
  • FileTools.WriteKeyValueFile(path, object, separator) - записывает объект, состоящий из пар ключ-значение, по пути path, используя separator в качестве разделителя. Если separator не задан, используется разделитель ":". Пример файла приведён в описании к методу ReadKeyValueFile
  • FileTools.ReadJSON(path) - считывает файл с объектом JSON по заданому пути в Javascript-объект
  • FileTools.WriteJSON(path, json, beautify) - записывает в JSON-файл по заданому пути Javascript-объект, если beautify равен true, то вывод будет красиво отформатирован