get_dict_tuple
— Zurückgeben der in einem Dictionary über einen Schüssel referenzierten
Tupeldaten.
get_dict_tuple( : : DictHandle, Key : Tuple)
get_dict_tuple
fragt aus dem Dictionary
DictHandle
die mit einem Schlüssel Key
assoziierten Tupeldaten Tuple
ab. Die Tupeldaten
müssen zuvor mit Hilfe des Operators set_dict_tuple
in
dem Dictionary abgespeichert worden sein.
Falls der spezifizierte Schlüssel Key
nicht in dem
Dictionary hinterlegt ist oder der mit ihm verbundene Eintrag
kein Datentupel sondern ein ikonisches Objekt ist, schlägt
get_dict_tuple
fehl. Die gespeicherten Schlüssel
und die Information über die von ihnen referenzierten Daten kann
über den Operator get_dict_param
abgefragt werden.
DictHandle
(input_control) dict →
(handle)
Handle des Dictionaries.
Parameteranzahl: DictHandle == 1
Key
(input_control) string →
(string / integer)
Schlüssel.
Parameteranzahl: Key == 1
Restriktion: length(Key) > 0
Tuple
(output_control) tuple(-array) →
(string / integer / real)
Vom Schlüssel referenzierte Tupeldaten.
* ... get_dict_param (Dict, 'key_exists', ['simple_string','foo','my_image'], \ KeysPresence) get_dict_param (Dict, 'key_data_type', ['simple_string','my_image'], \ KeysType) get_dict_tuple (Dict, 'simple_string', TupleString)
Im Erfolgsfall gibt get_dict_tuple
den Wert 2 (H_MSG_TRUE)
zurück. Andernfalls wird eine Fehlerbehandlung
durchgeführt. Mögliche Fehler sind ungültige Parameter
(Dictionary oder Schlüssel), Abwesenheit des Schlüssels in
dem Dictionary oder wenn der Schüssel andere Datentypen als ein
Datentupel referenziert.
create_dict
,
set_dict_tuple
,
set_dict_object
,
get_dict_object
,
remove_dict_key
,
get_dict_param
Foundation