get_dict_paramT_get_dict_paramGetDictParamGetDictParam (Operator)

Name

get_dict_paramT_get_dict_paramGetDictParamGetDictParam — Abfragen von Parametern oder Informationen eines Dictionaries.

Signatur

Beschreibung

get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParam fragt die aktuellen Werte der Parameter eines Dictionaries oder anderweitige Informationen zum Status eines Dictionaries ab.

Jeder Aufruf von get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParam darf nur einen einzelnen Parameternamen in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName enthalten. Es gibt zwei unterschiedliche Arten von Abfragen:

• Parameter, die auf das gesamte Dictionary angewendet werden. In diesem Fall dürfen keine Schlüssel übergeben werden, d.h. dem Parameter KeyKeyKeyKeykey muss ein leeres Tupel übergeben werden.

• Parameter, die auf einzelne Schlüssel angewendet werden. In diesem Fall müssen die Schlüssel in dem Parameter KeyKeyKeyKeykey übergeben werden, auf die der Parameter angewendet werden soll. Die Schlüssel werden dabei in der gleichen Reihenfolge abgearbeitet wie sie dem Parameter KeyKeyKeyKeykey übergeben werden.

Parameternamen, die unabhängig von Schlüsseln angewendet werden:

'keys'"keys""keys""keys""keys":

Fragt alle Schlüssel ab, für die in dem Dictionary Daten hinterlegt sind, unabhängig von dem Typ der mit ihnen verbundenen Daten. Die Liste der Schlüssel wird über den Parameter GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue als ein Tupel von Strings oder Integern zurückgegeben. Für diese Abfrage muss dem Parameter KeyKeyKeyKeykey ein leeres Tupel übergeben werden.

Parametername, die Schlüssel-spezifisch angewendet werden:

'key_exists'"key_exists""key_exists""key_exists""key_exists":

Gibt 1 zurück, wenn zu dem übergebenen Schlüssel in dem Dictionary Daten hinterlegt sind, sonst 0. Die Ergebnisse werden im Parameter GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue zurückgegeben, jeweils ein Wert pro übergebenem Schlüssel.

'key_data_type'"key_data_type""key_data_type""key_data_type""key_data_type":

Gibt den Wert 'tuple'"tuple""tuple""tuple""tuple" für Schlüssel zurück, die in dem Dictionary Tupeldaten referenzieren. Die Tupeldaten selbst erhält man mit dem Operator get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTuple. Der Wert 'object'"object""object""object""object" wird für Schlüssel zurückgegeben, welche Objektdaten referenzieren. Die Objektdaten selbst werden vom Operator get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObject zurückgegeben. Die Ergebnisse werden im Parameter GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue zurückgegeben, jeweils ein Wert pro Schlüssel. Dieser Parameter kann verwendet werden um dynamisch zu entscheiden, ob get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTuple oder get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObject verwendet werden muss um die Daten eines speziellen Schlüssels zu erhalten.

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.

Parameter

Beispiel (HDevelop)

get_dict_param (Dict, 'keys', [], AllKeys)
get_dict_param (Dict, 'key_data_type', AllKeys, KeysType)

Ergebnis

Wenn alle Parameter und übergebenen Schlüssel gültig sind, gibt get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParam den Wert 2 (H_MSG_TRUE) zurück. Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_dictcreate_dictCreateDictCreateDictCreateDict

Siehe auch

create_dictcreate_dictCreateDictCreateDictCreateDict, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTuple, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObject, get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObject, remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKey

Modul

Foundation