ClearList()

Синтаксис

ClearList(List())

Описание

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

Параметры

List()

Имя Списка, созданного с помощью функции NewList, элементы которого будут удалены. Вы должны указать скобки после имени Списка.

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

Ничего.

Комментарии

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

Пример

NewList Numbers.w()

; Небольшой цикл для добавления множества элементов в Список
For i=1 To 100
    AddElement(Numbers())
    Numbers() = i
Next

; Доказательство того, что элементы были добавлены в Список
MessageRequester("Инфо", "Есть "+Str(ListSize(Numbers()))+" элементов в Списке", #PB_MessageRequester_Ok)

; Очищает Список и показывает, что Список действительно пуст.
ClearList(Numbers())
MessageRequester("Инфо", "Есть "+Str(ListSize(Numbers()))+" элементов в Списке", #PB_MessageRequester_Ok)

См. также

DeleteElement(), FreeList()

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

Все