Clr, Clear

Schnelles setzen des Inhalts einer Variable, Arrays, Struktur, Struktureigenschaft auf 0.

Obacht bei Datentyp MemoryBlock! Hier sollte die entsprechende Freigabemethode des Objekts aufgerufen werden anstatt nur die Referenz zu löschen, da sonst Speicherleichen zurückbleiben.

Syntax:

  1. Clr Variable - Variablenwert auf Null setzen
  2. Clr Variable() - Alle Elementwerte des Arrays auf Null setzen

Info
Variable schließt auch Variablen ein, die als Struktur dimensioniert wurden. In diesem Fall werden alle Werte in der Struktur gelöscht. Auch einzelne Eigenschaften einer solchen Struktur können auf Null gesetzt werden, sowie auch Arrayelemente oder ganze Arrays einer Struktur.

Beispiel1:

  dim a(100) as byte
  dim b as integer
  dim s as string
 
  clr a(4)  ' element 5 des Arrays "a" auf 0 setzen
  clr a()   ' gesamtes Array "a" auf 0 setzen
  clr b     ' b auf 0 setzen
  clr s     ' string freigeben/auf "" setzen

Beispiel2:

  ' Struktur deklarieren
  struct date
    byte hour
    byte minute
    byte second
    byte wert(5)
  endstruct
  ' Variable als Struktur dimensionieren (anlegen)
  dim d as date
  clr d.hour    ' hour auf 0 setzen
  clr d         ' alle Werte auf 0 setzen
  clr d.wert(3) ' element 4 des array "wert" auf 0 setzen
  clr d.wert()  ' ganzes Array "wert" auf 0 setzen