правила . Карта
Тип карты, используемый для простых сопоставлений значений ключа.
Ключи должны иметь тип rules.String .
Помимо методов, перечисленных ниже, карты имеют следующие операторы:
| Оператор | Использование |
|---|---|
x == y | Сравните карты x и y |
x[k] | Оператор индекса, получить значение по имени ключа k |
xk | Получить значение по ключу с именем k |
k in x | Проверьте, существует ли ключ k на карте x |
Методы
разница
diff(map_to_compare) возвращает правила.MapDiff
Возвращает файл Rules.MapDiff , представляющий результат сравнения текущей карты с картой сравнения.
Параметр | |
|---|---|
map_to_compare | Карта, с которой будет сравниваться текущая (вызывающая) Карта. Значение не должно быть нулевым. |
- Возврат
non-null rules.MapDiffОбъект MapDiff, представляющий результат сравнения.
получать
get(key, default_value) возвращает значение
Возвращает значение, связанное с данной строкой ключа поиска.
Для вложенных карт, включающих ключи и вложенные ключи , возвращает значение, связанное с данной строкой вложенного ключа. Подключ идентифицируется с помощью списка, первый элемент которого является ключом верхнего уровня, а последний элемент — это подключ, значение которого необходимо найти и вернуть. См. пример вложенной карты ниже.
Функция требует, чтобы значение по умолчанию возвращалось, если совпадение с данным ключом поиска не найдено.
Параметр | |
|---|---|
ключ | (ненулевые правила.String или ненулевые правила.List ) Либо ключ, указанный в виде строки, либо для вложенных карт — подключ, указанный с использованием синтаксиса списка. |
значение по умолчанию | значение по умолчанию Значение, возвращаемое, если карта не содержит заданный ключ поиска. Может быть любым типом языка правил. |
- Возврат
valueЗначение, соответствующее данномуkey, или возвращаемое значение по умолчанию, указанное вdefault_value, если совпадение с данным ключом не найдено. Поскольку содержимое карты определяется пользователем, тип данных возвращаемогоvalueможет быть любым типом языка правил.
Пример
// "c" is not a key in the supplied Map, returns default value 7.
{"a": 3,"b": 2}.get("c", 7) == 7
// Default result can be any type, e.g. a list such as [1, 1].
{"a": [2, 7], "b": [9, 12]}.get("c", [1, 1]) == [1, 1]
// Return a list on a successful match.
{"a": [2, 7],"b": [9, 12]}.get("b", [1, 1]) == [9, 12]
// For nested Maps, use list ["a", "b"] to specify lookup on sub-key "b".
{"a": {"b": 1},"c": 2}.get(["a", "b"], 7) == 1ключи
keys() возвращает правила.Список
Получите список ключей на карте.
- Возврат
non-null rules.ListСписок ключей.
размер
size() возвращает правила. Целое число
Получите количество записей на карте.
- Возврат
non-null rules.Integerчисло записей.
ценности
values() возвращает правила.Список
Получите список значений на карте.
- Возврат
non-null rules.ListСписок значений.