ClearList()

Syntaxe

ClearList(Liste())
Description
Efface tous les éléments d'une liste et libère la mémoire utilisée.

Arguments

Liste() La liste à utiliser.

Valeur de retour

Aucune.

Remarques

Après l'appel à cette fonction, la liste reste utilisable, mais elle ne contient plus d'éléments. PureBasic libèrera seulement la mémoire occupée par les éléments.
Si la liste a été utilisée pour stocker des objets dynamiques, il n'est pas possible de le détecter (en PureBasic ou dans un autre langage). Dans ce cas, il convient de libérer tous ces objets avant la destruction de la liste.

Exemple

  NewList nombres.w()

  ; Une petite boucle pour ajouter plusieurs éléments à la liste
  For i=1 To 100
    AddElement(nombres())
    nombres() = i
  Next

  ; Preuve que les éléments ont été ajoutés à la liste
  MessageRequester("Information", "Il y a "+Str(ListSize(nombres()))+" éléments dans la liste", #PB_MessageRequester_OK)
 
  ; Effacer la liste et montrer que la liste est vraiment vide
  ClearList(nombres())
  MessageRequester("Information", "Il y a "+Str(ListSize(nombres()))+" élements dans la liste", #PB_MessageRequester_OK)

Voir aussi

DeleteElement(), FreeList()

OS Supportés

Tous

<- ChangeCurrentElement() - List Index - CopyList() ->