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