PureBasic

FindMapElement()

Синтаксис

*Result = FindMapElement(Map() , Key$)

Описание


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

Параметры

Map() Имя Хеш-карты, созданной с помощью функции NewMap, текущий элемент которой будет изменён. Вы должны указать скобки после имени Хеш-карты.
Key$ Ключ связанный с искомым элементом.

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

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

Пример

NewMap Country.s()

Country("US") = "United States"
Country("FR") = "France"
Country("GE") = "Germany"

If FindMapElement(Country(), "US")
    Debug "'US' находится в списке стран."
Else
    Debug "'US' НЕ находится в списке стран !"
EndIf

If FindMapElement(Country(), "UK")
    Debug "'UK' находится в списке стран."
Else
    Debug "'UK' НЕ находится в списке стран !"
EndIf

См. также

AddMapElement(), DeleteMapElement(), MapKey()

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

Все

<- DeleteMapElement() - Оглавление Map - FreeMap()->