ClearList()

Syntaxe

ClearList(Liste())

Efface tous les éléments de la liste et libère la mémoire utilisée. Après l'appel de cette fonction, la liste reste utilisable, mais elle ne contient plus d'éléments.

Arguments

Liste()

Le nom de la liste, créée à l'aide de la commande NewList. Les parenthèses sont obligatoires après le nom de la liste.

Valeur de retour

Cette fonction n'a pas de valeur de retour.

Remarques

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