ClearList()

Syntax

ClearList(Liste())
Beschreibung
Löscht alle Elemente in dieser Liste und gibt deren Speicherplatz frei. Nach diesem Aufruf ist die Liste noch benutzbar, sie ist jedoch leer (d.h. es befinden sich keine Elemente mehr in ihr).

Parameter

Liste() Der Variablenname der verknüpften Liste, welche mit dem NewList Befehl erstellt wurde. Sie müssen die Klammern nach dem Listennamen immer angeben.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

PureBasic gibt lediglich den Speicher der Elemente frei. Wenn Sie die verknüpfte Liste z.B. dafür benutzt haben, die "Handles" von Objekten - die Sie direkt mit dem OS erstellt haben - zu speichern, dann gibt es keine Möglichkeit, dass PureBasic (oder auch jede andere Programmiersprache) wissen kann, was diese darstellen. In einem solchen Fall, sollten Sie die Elemente der Liste durchgehen und die Objekte selbst freigeben.

Beispiel

  NewList Numbers.w() 

  ; Eine kleine Schleife, um viele Einträge zur Liste hinzufügen
  For i=1 To 100 
    AddElement(Numbers()) 
    Numbers() = i 
  Next 
    
  ; Prüfen, dass auch Einträge zur Liste hinzugefügt wurden
  MessageRequester("Information", "Es sind "+Str(ListSize(Numbers()))+" Elemente in der Liste", #PB_MessageRequester_OK) 
     
  ; Löschen des Listeninhalts und Anzeigen, dass die Liste wirklich leer ist
  ClearList(Numbers()) 
  MessageRequester("Information", "Es sind "+Str(ListSize(Numbers()))+" Elemente in der Liste", #PB_MessageRequester_OK) 

Siehe auch

DeleteElement(), FreeList()

Unterstützte OS

Alle

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