remove_dict_keyT_remove_dict_keyRemoveDictKeyRemoveDictKey (Operator)
Name
remove_dict_keyT_remove_dict_keyRemoveDictKeyRemoveDictKey
— Löschen eines Schlüssels aus einem Dictionary.
Signatur
Herror T_remove_dict_key(const Htuple DictHandle, const Htuple Key)
void RemoveDictKey(const HTuple& DictHandle, const HTuple& Key)
void HDict::RemoveDictKey(const HTuple& Key) const
void HDict::RemoveDictKey(const HString& Key) const
void HDict::RemoveDictKey(const char* Key) const
void HDict::RemoveDictKey(const wchar_t* Key) const
(Nur Windows)
Beschreibung
remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKey
löscht die in KeyKeyKeyKeykey
übergebenen Schlüssel aus
dem in DictHandleDictHandleDictHandleDictHandledictHandle
übergebenen Dictionary und gibt die vom Schlüssel
referenzierten ikonischen Objekte oder Tupeldaten frei.
Falls ein Fehler während der Verarbeitung eines oder mehrerer Schlüssel
auftritt, beispielsweise weil ein Schlüssel nicht im Dictionary existiert,
wird versucht, so weit wie möglich alle weiteren Schlüssel zu
entfernen bevor der Operator mit dem entsprechenden Fehler zurückkehrt.
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 modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Parameter
DictHandleDictHandleDictHandleDictHandledictHandle
(input_control, Zustand wird modifiziert) dict →
HDict, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Dictionaries.
Parameteranzahl: DictHandle == 1
KeyKeyKeyKeykey
(input_control) string(-array) →
HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Zu löschender Schlüssel.
Restriktion: length(Key) > 0
Beispiel (HDevelop)
* Remove all keys
get_dict_param (Dict, 'keys', [], Keys)
remove_dict_key (Dict, Keys)
Ergebnis
Im Erfolgsfall gibt remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKey
den Wert 2 (H_MSG_TRUE) zurück.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_dictcreate_dictCreateDictCreateDictCreateDict
Nachfolger
get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParam
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
,
get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParam
Modul
Foundation