6.2 containers.Map

: m = containers.Map ()

: m = containers.Map (keys, vals)

: m = containers.Map (keys, vals, "UniformValues", is_uniform)

: m = containers.Map ("KeyType", kt, "ValueType", vt)

Создаёт объект класса containers.Map, в котором хранится список пар ключ/значение.

keys — массив уникальных ключей карты. Ключи могут быть числовыми скалярами или строками. Тип числовых ключей может быть одним из следующих: "double", "single", "int32", "uint32", "int64" или "uint64". Другие числовые или логические ключи преобразуются в "double". Один строковый ключ можно указать непосредственно. Несколько строковых ключей указываются в виде массива ячеек со строками.

vals — массив значений карты, число элементов в котором совпадает с числом элементов в keys.

При вызове без входных аргументов создаётся карта по умолчанию со строковым типом ключей и типом значений "any".

Параметр "UniformValues" задаёт, должны ли значения карты иметь строго один и тот же тип. Если is_uniform имеет значение true, все значения, добавляемые в карту, сначала проверяются на соответствие требуемому типу.

При вызове с аргументами "KeyType" и "ValueType" создаётся пустая карта с указанными типами. Входные параметры kt и vt задают соответственно типы ключей и значений карты. Допустимые значения для kt: "char", "double", "single", "int32", "uint32", "int64", "uint64". Допустимые значения для vt: "any", "char", "double", "single", "int32", "uint32", "int64", "uint64", "logical".

Возвращаемое значение m — объект класса containers.Map.

См. также: struct.