clear_messageT_clear_messageClearMessageClearMessage (Operator)

Name

clear_messageT_clear_messageClearMessageClearMessage — Zerstören eins Nachrichtenobjektes und Freigeben aller Ressourcen.

Signatur

clear_message( : : MessageHandle : )

Beschreibung

clear_messageclear_messageClearMessageClearMessageClearMessage schließt die Nachrichtenobjekte MessageHandleMessageHandleMessageHandleMessageHandlemessageHandle, welche zuvor mit Hilfe des Operators create_messagecreate_messageCreateMessageCreateMessageCreateMessage oder dequeue_messagedequeue_messageDequeueMessageDequeueMessageDequeueMessage erzeugt wurden. Alle von den Nachrichten gehaltenen Ressourcen werden freigegeben, insbesondere die der gespeicherten Tupeldaten und ikonischen Objekte.

Achtung

Nachdem die Nachrichten durch clear_messageclear_messageClearMessageClearMessageClearMessage zerstört wurden dürfen sie nicht mehr verwendet werden. Die Verwendung von ungültigen Nachrichtenobjekte führt zu undefiniertem Verhalten.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

MessageHandleMessageHandleMessageHandleMessageHandlemessageHandle

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.

Parameter

MessageHandleMessageHandleMessageHandleMessageHandlemessageHandle (input_control, Zustand wird modifiziert) message(-array) → (handle)

Zu zerstörende Nachrichtenobjekte.

Parameteranzahl: MessageHandle >= 1

Restriktion: MessageHandle != 0

Beispiel (HDevelop)

MessageHandles := []
for idx := 0 to 4 by 1
  create_message (MessageHandle)
  MessageHandles[idx]:= MessageHandle
endfor
* ...

Ergebnis

clear_messageclear_messageClearMessageClearMessageClearMessage gibt 2 (H_MSG_TRUE) zurück, wenn die übergebenen Nachrichtenobjekte gültig sind. Andernfalls wird eine Fehlerbehandlung durchgeführt. Falls ein Tupel von Nachrichtenobjekten übergeben wird welches ungültige Referenzen enthält, wird clear_messageclear_messageClearMessageClearMessageClearMessage versuchen so viele Nachrichtenobjekte wie möglich frei zu geben, bevor ein Fehler zurückgegeben wird.

Vorgänger

create_messagecreate_messageCreateMessageCreateMessageCreateMessage, dequeue_messagedequeue_messageDequeueMessageDequeueMessageDequeueMessage

Siehe auch

create_messagecreate_messageCreateMessageCreateMessageCreateMessage, set_message_tupleset_message_tupleSetMessageTupleSetMessageTupleSetMessageTuple, get_message_tupleget_message_tupleGetMessageTupleGetMessageTupleGetMessageTuple, set_message_objset_message_objSetMessageObjSetMessageObjSetMessageObj, get_message_objget_message_objGetMessageObjGetMessageObjGetMessageObj, set_message_paramset_message_paramSetMessageParamSetMessageParamSetMessageParam, get_message_paramget_message_paramGetMessageParamGetMessageParamGetMessageParam, enqueue_messageenqueue_messageEnqueueMessageEnqueueMessageEnqueueMessage, dequeue_messagedequeue_messageDequeueMessageDequeueMessageDequeueMessage

Modul

Foundation

Operatoren