clear_handle — Gibt den Inhalt eines Handles frei.
clear_handle( : : Handle : )
clear_handle gibt den Inhalt des Handles Handle frei.
Das Handle ist danach in einem freigegebenen Zustand und kann nicht mehr
mit anderen Operatoren verwendet werden.
In der Regel werden Handles automatisch freigegeben, wenn alle Referenzen
in allen Tupeln überschrieben wurden.
clear_handle kann eingesetzt werden, um ein Handle zu einem
definierten Zeitpunkt freizugeben, auch wenn es noch Referenzen auf
dieses Handle gibt.
clear_handle gibt Handles beliebigen Typs frei und kann daher
anstelle von typspezifischen Freigabeoperatoren wie clear_matrix oder
clear_shape_model verwendet werden.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Handle (input_control, Zustand wird modifiziert) tuple(-array) → (handle)
Das freizugebende Handle.
Sind die Parameterwerte korrekt, d.h. enthält Handle ein Handle,
dann liefert clear_handle den Wert 2 (
H_MSG_TRUE)
.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Foundation