integer_to_handle
— Konvertiert eine Ganzzahl in ein Handle.
Es wird nicht empfohlen, diesen Operator in HDevelop zu verwenden. Er existiert nur aus Gründen der Rückwärtskompatibilität.
integer_to_handle( : : IntegerHandle : Handle)
integer_to_handle
konvertiert den Integer IntegerHandle
, der
ein Handle repräsentiert, in ein Handle und gibt dieses in
Handle
zurück.
Dies erlaubt die Konvertierung von Handles, die mit aktiviertem
Legacy Handle Modus erzeugt wurden, in korrekte Handles.
Falls der Legacy Handle Modus deaktiviert ist (default), wird die automatische
Freigabe für dieses Handle aktiviert. In diesem Fall wird das Handle
automatisch freigegeben, wenn alle Referenzen darauf in allen Handles
überschrieben wurden.
Falls IntegerHandle
in diesem Fall weiterhin verwendet werden soll,
muss eine Referenz auf das zurückgegebene Handle
behalten werden,
um die automatische Freigabe zu unterbinden.
Falls der Legacy Handle Modus aktiviert ist, wird das zurückgegebene
Handle wieder vom Typ Integer sein. Weiterhin muss das Handle in diesem
Fall mit clear_handle
oder dem clear-Operator des entsprechenden
Handletyps freigegeben werden.
Es wird nicht empfohlen, diesen Operator in HDevelop zu verwenden. Er existiert nur aus Gründen der Rückwärtskompatibilität.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
IntegerHandle
(input_control) pointer(-array) →
(integer)
Das zu konvertierende Handle in Integer-Darstellung.
Handle
(output_control) handle(-array) →
(handle)
Das Handle vom korrekten Handle-Typ.
Sind die Parameterwerte korrekt, dann liefert
integer_to_handle
den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Foundation