space_object:frommap()

object space_object¶

space_object:frommap(map[, option])¶

Конвертация ассоциативного массива в экземпляр кортежа или в таблицу. Ассоциативный массив должен состоять из пар «имя поля = значение». Имена полей и типы значений должны соответствовать именам и типам, ранее заданным для спейса с помощью space_object:format().

Параметры:	space_object (space_object) – ссылка на объект map (field-value-pairs) – ряд пар «поле = значение» в любом порядке. option (boolean) – единственный возможный параметр {table = true|false}; если параметр не указан, или же {table = false}, то возвращается „cdata“ (то есть кортеж); если {table = true}, то возвращается таблица.
возвращает:	кортеж или таблица.
тип возвращаемого значения:
	кортеж или таблица

Возможные ошибки: отсутствует объект спейса space_object, или в спейсе нет формата; «unknown field» (неизвестное поле).

Пример:

-- Создание формата с двумя полями под названиями 'a' и 'b'.
-- Создание спейса с таким форматом.
-- Создание кортежа на основе ассоциативного массива по данному спейсу.
-- Создание таблицы на основе ассоциативного массива по данному спейсу.
tarantool> format1 = {{name='a',type='unsigned'},{name='b',type='scalar'}}
---
...
tarantool> s = box.schema.create_space('test', {format = format1})
---
...
tarantool> s:frommap({b = 'x', a = 123456})
---
- [123456, 'x']
...
tarantool> s:frommap({b = 'x', a = 123456}, {table = true})
---
- - 123456
  - x
...