set_message_objset_message_objSetMessageObjset_message_objSetMessageObjSetMessageObj (Operator)

Name

set_message_objset_message_objSetMessageObjset_message_objSetMessageObjSetMessageObj — Hinzufügen eines Schlüssel-Objekt-Paares zu einem Nachrichtenobjekt.

Signatur

set_message_obj(ObjectData : : MessageHandle, Key : )

set_message_objset_message_objSetMessageObjset_message_objSetMessageObjSetMessageObj speichert in einer Nachricht ähnlich zu einem assoziativem Array ein ikonisches Objekt in Verbindung mit einem Schlüssel ab. Das Nachrichtenobjekt wird im Parameter MessageHandleMessageHandleMessageHandleMessageHandleMessageHandlemessageHandle übergeben.

ObjectDataObjectDataObjectDataObjectDataObjectDataobjectData wird durch die Operation kopiert (vgl. copy_objcopy_objCopyObjcopy_objCopyObjCopyObj)und kann daher anschließend ohne Seiteneffekte weiterverwendet oder gelöscht werden. Sowohl leere Objekte als auch ikonische Tupelobjekte sind zulässig und können von einem Schlüsselwort referenziert werden. Falls bereits Daten (Tupel oder Objekt) durch das gegebene Schlüsselwort referenziert werden, werden die alten Daten freigegeben und durch ObjectDataObjectDataObjectDataObjectDataObjectDataobjectData ersetzt.

KeyKeyKeyKeyKeykey ist ein nicht leerer String bestehend ausnahmslos aus ASCII-Buchstaben, Zahlen und Unterstrichen, wobei das Schlüsselwort mit einem Buchstaben beginnen muss. Dabei werden Groß-/Kleinschreibung beachtet. Die ikonischen Objekte für den übergebenen Schlüssel können mit Hilfe des Operators get_message_objget_message_objGetMessageObjget_message_objGetMessageObjGetMessageObj aus dem Nachrichtenobjekt wieder ausgelesen werden.

Parallelisierung

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:

MessageHandleMessageHandleMessageHandleMessageHandleMessageHandlemessageHandle

Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.

Parameter

ObjectDataObjectDataObjectDataObjectDataObjectDataobjectData (input_object) object(-array) → object

Vom Schlüssel zu referenzierendes ikonisches Objekt.

MessageHandleMessageHandleMessageHandleMessageHandleMessageHandlemessageHandle (input_control, Zustand wird modifiziert) message → (integer)

Nachrichtenobjekt.

Parameteranzahl: MessageHandle == 1

Restriktion: MessageHandle != 0

KeyKeyKeyKeyKeykey (input_control) string → (string)

Schlüsselwort.

Parameteranzahl: Key == 1

Restriktion: length(Key) > 0

Beispiel (HDevelop)

create_message (Message)
read_image( Image, 'filename')
set_message_obj (Image, Message, 'my_image')

Ergebnis

Im Erfolgsfall gibt set_message_tupleset_message_tupleSetMessageTupleset_message_tupleSetMessageTupleSetMessageTuple den Wert 2 (H_MSG_TRUE) zurück. Andernfalls wird eine Fehlerbehandlung durchgeführt. Mögliche Fehler sind ungültige Parameter (Nachrichtenobjekt oder Schlüssel) oder ein Allokierungsfehler.

Vorgänger

create_messagecreate_messageCreateMessagecreate_messageCreateMessageCreateMessage

Nachfolger

enqueue_messageenqueue_messageEnqueueMessageenqueue_messageEnqueueMessageEnqueueMessage, set_message_tupleset_message_tupleSetMessageTupleset_message_tupleSetMessageTupleSetMessageTuple

Alternativen

set_message_tupleset_message_tupleSetMessageTupleset_message_tupleSetMessageTupleSetMessageTuple

Siehe auch

create_messagecreate_messageCreateMessagecreate_messageCreateMessageCreateMessage, clear_messageclear_messageClearMessageclear_messageClearMessageClearMessage, set_message_tupleset_message_tupleSetMessageTupleset_message_tupleSetMessageTupleSetMessageTuple, get_message_tupleget_message_tupleGetMessageTupleget_message_tupleGetMessageTupleGetMessageTuple, get_message_objget_message_objGetMessageObjget_message_objGetMessageObjGetMessageObj, set_message_paramset_message_paramSetMessageParamset_message_paramSetMessageParamSetMessageParam, get_message_paramget_message_paramGetMessageParamget_message_paramGetMessageParamGetMessageParam, enqueue_messageenqueue_messageEnqueueMessageenqueue_messageEnqueueMessageEnqueueMessage, dequeue_messagedequeue_messageDequeueMessagedequeue_messageDequeueMessageDequeueMessage

Modul

Foundation

Operatoren