get_message_tuple
— Zurückgeben der in einer Nachricht über einen Schüssel referenzierten
Tupeldaten.
get_message_tuple( : : MessageHandle, Key : TupleData)
get_message_tuple
fragt aus einer Nachricht
MessageHandle
die mit einem Schlüssel Key
assoziierten Tupeldaten TupleData
ab. Die Tupeldaten
müssen zuvor mit Hilfe des Operators set_message_tuple
in
dem Nachrichtenobjekt abgespeichert worden sein.
Falls der spezifizierte Schlüssel Key
nicht in dem
Nachrichtenobjekt hinterlegt ist oder der mit ihm verbundene Eintrag
kein Datentupel sondern ein ikonisches Objekt ist, schlägt
get_message_tuple
fehl. Die gespeicherten Schlüssel
und die Information über die von ihnen referenzierten Daten kann
über den Operator get_message_param
abgefragt werden.
MessageHandle
(input_control) message →
(handle)
Nachrichtenobjekt.
Parameteranzahl: MessageHandle == 1
Restriktion: MessageHandle != 0
Key
(input_control) string →
(string / integer)
Schlüsselwort oder Integer.
Parameteranzahl: Key == 1
TupleData
(output_control) tuple(-array) →
(string / integer / real / handle)
Vom Schlüssel referenzierte Tupeldaten.
* ... 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)
Im Erfolgsfall gibt get_message_tuple
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_message
,
clear_message
,
set_message_tuple
,
set_message_obj
,
get_message_obj
,
set_message_param
,
get_message_param
,
enqueue_message
,
dequeue_message
Foundation