json.txt Дополнение, используемое для чтения и вывода данных в формате JSONLINK

==============================================================================

CONTENTS json-contentsLINK

1. Введение json-intro

2. Предоставляемая функциональность json-functionality

2.1. Команды json-commands

2.2. Функции json-functions

3. Настройки json-options

==============================================================================

1. Введение json-introLINK

Данное дополнение предоставляет возможность загрузки данных в формате JSON из

файлов и сохранения значений переменных. Загружаемые данные кэшируются для

ускорения работы дополнения.

Для работы дополнению требуется frawor. Также рекомендуется использовать

версию Vim, собранную с поддержкой +python. Для загрузки данных дополение

пытается использовать сначала пакет demjson, затем пакет simplejson, затем

пакет json. Последний, вероятно, уже присутствует в системе, если на ней

установлен интерпретатор Python. Note дополнение сохраняет работоспособность

даже при отсутствии +python, но альтернатива на чистом VimScript слишком

медленная и не поддерживает суррогатные пары.

==============================================================================

2. Предоставляемая функциональность json-functionalityLINK

Данное дополнение предоставляет одну команду и четыре функции. Доступ

к функциям можно получить через словарь, являющийся ресурсом «json»

(см. frawor-f-addresource).

------------------------------------------------------------------------------

2.1. Команды json-commandsLINK

json-actionsLINK

:JSONCache {action} ... :JSONCacheLINK

Это единственная команда, которая предоставляется данным

дополнением. Возможные действия:

Действие Описание

show Показывает содержимое кэша в две колонки: имя файла

и дата последнего изменения.

purge Очищает кэш.

------------------------------------------------------------------------------

2.2. Функции json-functionsLINK

Доступ к функциям можно получить только через словарь, являющийся ресурсом

«json» (см. frawor-f-addresource). Всё, что надо для этого сделать — это

добавить «autoload/json» в список зависимостей и затем использовать

s:_r.json.*.

json.load({file}[, {ignorecache}]) json-r-json.loadLINK

Загружает данные в формате JSON из указанного файла. Если присутствует

необязательный аргумент и он не равен нулю, то функция игнорирует кэш,

даже если он существует.

json.loads({string}) json-r-json.loadsLINK

Загружает данные в формате JSON из строки.

json.dump({file}, {data}) json-r-json.dumpLINK

Кодирует данные {data} в формат JSON и сохраняет их в указанный файл.

json.dumps({data}) json-r-json.dumpsLINK

Кодирует данные {data} в формат JSON и возвращает строку с результатом

кодирования.

==============================================================================

3. Настройки json-optionsLINK

b:jsonOptions g:jsonOptionsLINK

g:json_UsePythonLINK

UsePython :: Bool json-o-UsePythonLINK

Если данная настройка равна нулю, то дополнение не будет пытаться

использовать python для загрузки информации.

vim: ft=help:tw=78