remove_dict_keyT_remove_dict_keyRemoveDictKeyRemoveDictKeyremove_dict_key (算子名称)
名称
remove_dict_keyT_remove_dict_keyRemoveDictKeyRemoveDictKeyremove_dict_key — Remove keys from a dictionary.
参数签名
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
(
Windows only)
def remove_dict_key(dict_handle: HHandle, key: MaybeSequence[Union[str, int]]) -> None
描述
remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKeyremove_dict_key removes the keys specified in KeyKeyKeyKeykeykey from
the dictionary passed in DictHandleDictHandleDictHandleDictHandledictHandledict_handle and releases
all the (tuple or object) data associated with those keys.
If an error occurs while processing one or more keys (in particular
if a key is invalid), the operator attempts to continue removing
as many keys as possible before reporting an appropriate failure.
运行信息
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
参数表
DictHandleDictHandleDictHandleDictHandledictHandledict_handle (input_control, state is modified) dict → HDict, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Dictionary handle.
Number of elements:
DictHandle == 1
KeyKeyKeyKeykeykey (input_control) string(-array) → HTupleMaybeSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Key to remove.
Restriction:
length(Key) > 0
例程 (HDevelop)
* Remove all keys
get_dict_param (Dict, 'keys', [], Keys)
remove_dict_key (Dict, Keys)
结果
If all the operator parameters are valid, remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyRemoveDictKeyremove_dict_key returns
2 (
H_MSG_TRUE)
. Otherwise an exception is raised.
可能的前置算子
create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict
可能的后置算子
get_dict_paramget_dict_paramGetDictParamGetDictParamGetDictParamget_dict_param
参考其它
create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict,
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
模块
Foundation