create_dictT_create_dictCreateDictCreateDictcreate_dict (Operator)

Name

create_dictT_create_dictCreateDictCreateDictcreate_dict — Erzeugen eines neuen Dictionaries.

Signatur

Beschreibung

create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict erzeugt ein neues, leeres Dictionary und gibt dessen Handle in DictHandleDictHandleDictHandleDictHandledictHandledict_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_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object und set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple gespeichert und können über die Operatoren get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object und get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_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_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple oder set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object gespeichert wurden, weiterverwendet werden. Dabei gelten folgende Besonderheiten:

• Objekte: Die Kopien sind Referenzen auf die Originale, wie in copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj. Insbesondere wirken sich Änderungen durch die Operatoren set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval oder overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_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 "deep copy").

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_dictCreateDictCreateDictCreateDictcreate_dict liefert den Wert TRUE, sofern kein Allokierungsfehler auftritt.

Nachfolger

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object

Siehe auch

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleSetDictTupleset_dict_tuple, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleGetDictTupleget_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectSetDictObjectset_dict_object, get_dict_objectget_dict_objectGetDictObjectGetDictObjectGetDictObjectget_dict_object, get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParamget_dict_param

Modul

Foundation