get_message_tupleget_message_tupleGetMessageTupleget_message_tupleGetMessageTupleGetMessageTuple (Operator)

Name

get_message_tupleget_message_tupleGetMessageTupleget_message_tupleGetMessageTupleGetMessageTuple — Zurückgeben der in einer Nachricht über einen Schüssel referenzierten Tupeldaten.

Signatur

get_message_tuple( : : MessageHandle, Key : TupleData)

Beschreibung

get_message_tupleget_message_tupleGetMessageTupleget_message_tupleGetMessageTupleGetMessageTuple fragt aus einer Nachricht MessageHandleMessageHandleMessageHandleMessageHandleMessageHandlemessageHandle die mit einem Schlüssel KeyKeyKeyKeyKeykey assoziierten Tupeldaten TupleDataTupleDataTupleDataTupleDataTupleDatatupleData ab. Die Tupeldaten müssen zuvor mit Hilfe des Operators set_message_tupleset_message_tupleSetMessageTupleset_message_tupleSetMessageTupleSetMessageTuple in dem Nachrichtenobjekt abgespeichert worden sein.

Falls der spezifizierte Schlüssel KeyKeyKeyKeyKeykey nicht in dem Nachrichtenobjekt hinterlegt ist oder der mit ihm verbundene Eintrag kein Datentupel sondern ein ikonisches Objekt ist, schlägt get_message_tupleget_message_tupleGetMessageTupleget_message_tupleGetMessageTupleGetMessageTuple fehl. Die gespeicherten Schlüsselwörter und die Information über die von ihnen referenzierten Daten kann über den Operator get_message_paramget_message_paramGetMessageParamget_message_paramGetMessageParamGetMessageParam abgefragt 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.

Parameter

MessageHandleMessageHandleMessageHandleMessageHandleMessageHandlemessageHandle (input_control) message → (integer)

Nachrichtenobjekt.

Parameteranzahl: MessageHandle == 1

Restriktion: MessageHandle != 0

KeyKeyKeyKeyKeykey (input_control) string → (string)

Schlüsselwort.

Parameteranzahl: Key == 1

Restriktion: length(Key) > 0

TupleDataTupleDataTupleDataTupleDataTupleDatatupleData (output_control) tuple(-array) → (string / integer / real)

Vom Schlüssel referenzierte Tupeldaten.

Beispiel (HDevelop)

* ...
get_message_param (Message,'key_exists',['simple_string','foo','my_image'],\
                   KeysPresence)
get_message_param (Message,'key_data_type',['simple_string','my_image'],\
                   KeysType)
get_message_tuple (Message,'simple_string',TupleString)

Ergebnis

Im Erfolgsfall gibt get_message_tupleget_message_tupleGetMessageTupleget_message_tupleGetMessageTupleGetMessageTuple 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), Abwesenheit des Schlüssels in der Nachricht oder wenn der Schüssel andere Datentypen als ein Datentupel referenziert.

create_messagecreate_messageCreateMessagecreate_messageCreateMessageCreateMessage, clear_messageclear_messageClearMessageclear_messageClearMessageClearMessage, set_message_tupleset_message_tupleSetMessageTupleset_message_tupleSetMessageTupleSetMessageTuple, set_message_objset_message_objSetMessageObjset_message_objSetMessageObjSetMessageObj, 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