LoadJSON()

Синтаксис

Result = LoadJSON(#JSON , FileName$ [, Flags])

Описание

Разбирает (парсит) JSON-данные из файла и создаёт на их основе структуру JSON-данных. Предполагается, что содержимое файла будет закодировано в формате UTF-8. Эта команда не может считывать файлы с другим кодированием символов. После синтаксического анализа, для доступа к содержащимся JSON-значениям может использоваться функция JSONValue().

Параметры

#JSON	Номер для идентификации новой структуры JSON-данных (как объекта в памяти). В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
FileName$	Имя файла, содержащего JSON-данные.
Flags (дополн.)	Если установлено значение #PB_JSON_NoCase, JSON-данные будут проанализированы без учета регистра. Значение по умолчанию - с учётом регистра.

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

Возвращает не нулевое значение, если структура JSON-данных была создана успешно, в противном случае - ноль. Если в качестве параметра #JSON использовалось значение #PB_Any, то в случае успеха будет возвращен сгенерированный Номер.

Комментарии

В случае ошибки, для получения дополнительной информации об ошибке можно использовать функции JSONErrorMessage(), JSONErrorLine() и JSONErrorPosition().

JSON - это формат данных, чувствительный к регистру. Однако в некоторых ситуациях, таких как десериализация (восстановление из байтовой последовательности) структур с помощью ExtractJSONStructure() или подобных команд, может оказаться полезным рассматривать объекты JSON как нечувствительные к регистру. Флаг #PB_JSON_NoCase заставляет все связанные с этим функции обрабатывать ключи в данном объекте как нечувствительные к регистру.

См. также

CreateJSON(), CatchJSON(), ParseJSON(), JSONValue(), FreeJSON(), JSONErrorMessage(), JSONErrorLine(), JSONErrorPosition(), SaveJSON()

Поддерживаемые OS

Все