AddMapElement()

Синтаксис

*Result = AddMapElement(Map() , Key$ [, Flags])

Описание

Добавляет новый пустой элемент в Хеш-карту Map(), с заданным ключом 'Key$'. Этот новый элемент становится текущим элементом Хеш-карты.

Параметры

Map()	Имя Хеш-карты, созданной с помощью функции NewMap, к которой будет добавлен новый элемент. Вы должны указать скобки после имени Хеш-карты.
Key$	Ключ для нового элемента. В качестве ключа можно использовать не только буквы и цифры, но и множество других знаков.
Flags (дополн.)	Этот параметр может быть одним из следующих значений: #PB_Map_ElementCheck : Проверяет, существует ли элемент с тем же ключом и заменяет его (по умолчанию). #PB_Map_NoElementCheck: Проверка элемента не выполняется, поэтому, если предыдущий элемент с тем же ключом уже присутствует, он будет не заменен, а сохранен в Хеш-карте, и недоступен при прямом доступе. Он останется недоступным до тех пор, пока новый добавленный элемент не будет удален. Такие недостижимые элементы по-прежнему будут перечисляться при перечислении всех элементов карты с помощью функций ForEach или NextMapElement(). Этот режим работает быстрее, но более подвержен ошибкам, поэтому используйте его с осторожностью.

Возвращаемое значение

Возвращает адрес в памяти нового текущего элемента Хеш-карты если он был успешно создан, в противном случае 0. Возвращаемое значение является указателем на новый текущий элемент.

Комментарии

Эта функция не является обязательной при работе с Хеш-картами, поскольку элементы добавляются автоматически при присвоении им значения.

Пример

NewMap Country.s()

; Обычный способ добавления элемента
Country("US") = "United States"

; То же самое с помощью AddMapElement()
AddMapElement(Country(), "FR")
Country() = "France"

ForEach Country()
    Debug Country()
Next

См. также

DeleteMapElement(), ClearMap(), MapSize()

Поддерживаемые OS

Все