ClearMap()

Синтаксис

ClearMap(Map())

Описание

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

Параметры

Map()

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

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

Ничего.

Комментарии

PureBasic освободит память только для элементов. Если вы использовали Хеш-карту для чего-то вроде хранения дескрипторов объектов, созданных непосредственно в ОС, нет способа, с помощью которого PureBasic (или любой другой язык) может знать, что собой представляют эти объекты. Поэтому в таких случаях Вы должны пройти по элементам в Хеш-карте и сами удалить объекты.

Пример

NewMap Country.s()

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

; Доказательство того, что элементы добавлены к карте
MessageRequester("Инфо", "Есть "+Str(MapSize(Country()))+" элементов в карте")

; Очищает карту и показывает, что карта действительно пуста
ClearMap(Country())
MessageRequester("Инфо", "Есть "+Str(MapSize(Country()))+" элементов в карте")

См. также

AddMapElement(), DeleteMapElement()

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

Все