GlobalStringsSaveToFile

From SunFlurry wiki
Jump to: navigation, search
  GlobalStringsSaveToFile (Глобальные строки-массивы)
Объект:Функции общего назначения
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Неверные агрументы, системная ошибка сервера, не найден массив.
Визуальность:Нет

Функция выполняет сохранение массива на диск в файловой системе сервера в виде файла. Обычно она выполняется автоматически, если в массиве были изменения после определенного количества времени.

Синтаксис

GlobalStringsSaveToFile(<Имя или идентификатор массива (STRING,INT)>,<Имя файла на сервере (STRING)>,<Если время последней записи было не раньше в мс. (INT)>=0):<1 или 0>

Аргументы

  • <Имя или идентификатор массива (STRING,INT)> - Параметр задает имя массива (строка) или идентификатор массива (число).
  • <Имя файла на сервере (STRING)> - (необязательный аргумент) Аргумент, строковое представление которого будет представлять имя файла в нотации системы. На данный момент принимается только путь к файлам на сервере. Если аргумент не задан, используется тот файл, который был указан при создании массива, см. GlobalStringsHeapsAdd.
  • <Если время последней записи было не раньше в мс. (INT)> - (необязательный аргумент) (планируется к реализации) Сохранение будет выполняться только если последнее автоматическое или вызванное этой функцией сохранение было не ранее указанного количества миллисекунд назад. По умолчанию, 0, выполняется безусловное сохранение.

Возвращаемое значение

Возвращает 1, если сохранение выполнено успешно (или не требуется, так как предыдущее было выполнено недавно), 0, если сохранение не удалось выполнить (к примеру, из-за того, что файл был занят).

Примеры

GlobalStringsSaveToFile(Массив,"Temp\Массивы\Current.bin");