Преобразование данных¶

mapping_tools¶

Модуль mapping_tools содержит функции для работы со значениями внутри объектов.

mapping_tools.get_by_path(obj, path[, delimiter])¶

Получает значение из объекта по его пути с заданным разделителем.

Parameters

• obj (table) – объект

• path (string) – путь к объекту

• delimiter (string) – разделитель (. по умолчанию).

Returns

объект

Return type

table

mapping_tools.set_by_path(obj, path, value[, delimiter])¶

Присваивает значение объекту по его пути с заданным разделителем.

Parameters

• obj (table) – объект

• path (string) – путь к объекту

• value (table) – значение объекта

• delimiter (string) – разделитель (. по умолчанию).

Returns

none

mapping_tools.just_get_and_set(source_object, source_path, target_object, target_path)¶

Получает значение из одного объекта и присваивает его другому объекту.

Parameters

• source_object (table) – исходный объект, из которого получают значение

• source_path (string) – путь к исходному объекту

• target_object (table) – целевой объект, которому передается значение исходного объекта

• target_path (string) – путь к целевому объекту

Returns

none

soap¶

Модуль soap содержит функции для преобразования SOAP-запроса в формате XML в объекты Lua и обратно.

soap.encode(data)¶

Преобразует Lua-таблицу в строку с XML-документом.

Parameters

data (table) – Lua-таблица

Returns

XML-документ

Return type

string

soap.decode(doc)¶

Преобразует строку с XML-документом в объекты Lua.

Parameters

doc (string) – XML-документ

Returns

объекты Lua, полученные в результате парсинга XML.

• строка, содержащая указатель на пространство имен (namespace);

• строка с именем метода, переданного в SOAP-запросе (method);

• Lua-таблица, которая содержит значения, переданные в тегах SOAP-запроса (entries).

Return type

string or table

json¶

Функции из модуля json для преобразования строки в формате JSON в объект Lua и обратно.

json.encode(lua_value[, configuration])¶

Преобразует объект Lua в строку в формате JSON.

Parameters

• lua_value (table/scalar) – объект Lua

• configuration – дополнительные опции конфигурации (см. функцию json.cfg())

Returns

JSON-строка

Return type

string

json.decode(string[, configuration])¶

Преобразует JSON-строку в объект Lua.

Parameters

• string (string) – строка в формате JSON

• configuration – дополнительные опции конфигурации (см. функцию json.cfg())

Returns

Lua-таблица

Return type

table

yaml¶

Функция из модуля yaml для преобразования строки в формате YAML в объект Lua.

yaml.encode(lua_value)¶

Преобразует объект Lua в строку в формате YAML.

Parameters

lua_value (table/scalar) – объект Lua

Returns

YAML-строка

Return type

string

table¶

Модуль table содержит функции для работы с таблицами в Lua. Информация о модуле table и доступных функциях приведена в справочнике по встроенным модулям. Кроме того, модуль расширен двумя дополнительными функциями:

• cmpdeeply(got, expected)

• append_table(where, from).

table.cmpdeeply(got, expected[, extra])¶

Сравнение двух таблиц с учетом вложенности.

Parameters

• got (lua-value) – фактический результат

• expected (lua-value) – ожидаемый результат

• extra (table) – таблица, в которой сохраняется путь для различающихся элементов

Returns

результат сравнения, true или false

Return type

boolean

table.append_table(where, from)¶

Копирует один массив в конец другого массива. При этом используется неглубокое (shallow) копирование.

Parameters

• where (table) – целевая таблица, в которую вставляют значения из первой таблицы

• from (table) – таблица, значения которой добавляют в целевую таблицу

Returns

целевая таблица

Return type

table

Константа box.NULL¶

Константа box.NULL представляет собой нулевой указатель (NULL pointer). box.NULL позволяет хранить ключ без значения, в таблицах эта константа является местозаполнителем для значения nil. Имеет тип cdata. Чтобы узнать больше о box.NULL, обратитесь к соответствующему разделу справочника> в документации Tarantool.