create_dictT_create_dictCreateDictCreateDictcreate_dict (Operator)

Name

create_dictT_create_dictCreateDictCreateDictcreate_dict — Erzeugen eines neuen Dictionaries.

Signatur

Beschreibung

create_dictcreate_dictCreateDictCreateDictcreate_dict erzeugt ein neues, leeres Dictionary und gibt dessen Handle in DictHandleDictHandleDictHandledictHandledict_handle zurück.

Ein Dictionary ist ein Objekt, das ähnlich einem assoziativem Array (Wörterbuch) aufgebaut ist. Es erlaubt eine beliebige Anzahl von Daten zu speichern, welche mit Hilfe eines eindeutigen Schlüssels (String oder Integer) identifiziert werden. Jeder Schlüssel kann entweder einen Tupeldaten-Parameter oder ein ikonisches Objekt referenzieren. Diese Daten werden in dem Dictionary mit Hilfe der Operatoren set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object und set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple gespeichert und können über die Operatoren get_dict_objectget_dict_objectGetDictObjectGetDictObjectget_dict_object und get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple wieder ausgelesen werden.

Die Daten, welche in dem Dictionary referenziert werden, sind stets Kopien ihrer Originale. Damit können die originalen Daten, nachdem sie in dem Dictionary durch die Operatoren set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple oder set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object gespeichert wurden, weiterverwendet werden. Dabei gelten folgende Besonderheiten:

• Objekte: Die Kopien sind Referenzen auf die Originale, wie in copy_objcopy_objCopyObjCopyObjcopy_obj. Insbesondere wirken sich Änderungen durch die Operatoren set_grayvalset_grayvalSetGrayvalSetGrayvalset_grayval oder overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionoverpaint_region auch auf das im Dictionary gespeicherte Objekt aus.

• Handles: Beim Speichern eines Handles in einem Dictionary wird nur der Handle-Wert, nicht aber das Handle-Objekt selbst kopiert (keine "tiefe Kopie").

HDevelop Inline-Operation

HDevelop unterstützt eine Inline-Operation für create_dictcreate_dictCreateDictCreateDictcreate_dict, die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden kann:

DictHandle := dict{}

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.

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

Beispiel (HDevelop)

Dicts := []
for idx := 0 to 4 by 1
  create_dict (DictHandle)
  Dicts[idx] := DictHandle
endfor
* ...

Ergebnis

create_dictcreate_dictCreateDictCreateDictcreate_dict liefert den Wert 2 ( H_MSG_TRUE) , sofern kein Allokierungsfehler auftritt.

Nachfolger

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object

Siehe auch

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object, get_dict_objectget_dict_objectGetDictObjectGetDictObjectget_dict_object, get_dict_paramget_dict_paramGetDictParamGetDictParamget_dict_param

Modul

Foundation