PureBasic

NextMapElement()

Синтаксис

*Result = NextMapElement(Map())

Описание


Устанавливает внутренний указатель Хеш-карты Map() на следующий элемент, или первый элемент, если ранее была вызвана функция ResetMap(), (этот элемент становится текущим). Эта команда обычно используется для пошагового прохождения по всем элементам Хеш-карты.

Параметры

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

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

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

Пример

NewMap Country.s()

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

ResetMap(Country())
While NextMapElement(Country())
    Debug Country()
Wend

См. также

ResetMap(), MapKey()

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

Все

<- MapSize() - Оглавление Map - PopMapPosition()->