Operator Reference

HALCON Operator Reference / Tuple / Data Containers

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

set_dict_objectT_set_dict_objectSetDictObjectSetDictObjectset_dict_object (Operator)

set_dict_objectT_set_dict_objectSetDictObjectSetDictObjectset_dict_object — Add a key/object pair to the dictionary.

Signature

set_dict_object(Object : : DictHandle, Key : )

Herror T_set_dict_object(const Hobject Object, const Htuple DictHandle, const Htuple Key)

void SetDictObject(const HObject& Object, const HTuple& DictHandle, const HTuple& Key)

void HDict::SetDictObject(const HObject& Object, const HTuple& Key) const

void HDict::SetDictObject(const HObject& Object, const HString& Key) const

void HDict::SetDictObject(const HObject& Object, const char* Key) const

void HDict::SetDictObject(const HObject& Object, const wchar_t* Key) const   ( Windows only)

static void HOperatorSet.SetDictObject(HObject objectVal, HTuple dictHandle, HTuple key)

void HDict.SetDictObject(HObject objectVal, HTuple key)

void HDict.SetDictObject(HObject objectVal, string key)

def set_dict_object(object: HObject, dict_handle: HHandle, key: Union[str, int]) -> None

Description

set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object stores an object associated with a key in the dictionary. The dictionary is denoted by the DictHandleDictHandleDictHandledictHandledict_handle parameter.

ObjectObjectObjectobjectValobject is copied by the operation and can thus be immediately reused. Thereby the object data is copied in HALCON's object database, meaning the new object contains a reference to ObjectObjectObjectobjectValobject, see copy_objcopy_objCopyObjCopyObjcopy_obj.

Both an empty object or an object tuple are considered as a valid value that can be associated with the key. If any data (tuple or object) was already associated with given key (KeyKeyKeykeykey), the old data is destroyed by set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object and replaced by ObjectObjectObjectobjectValobject.

The KeyKeyKeykeykey has to be a string or an integer. Strings are treated case sensitive.

The object data for the given key can be retrieved again from the dictionary using get_dict_objectget_dict_objectGetDictObjectGetDictObjectget_dict_object.

HDevelop In-line Operation

HDevelop provides an in-line operation for set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object, which can be used in an expression in the following syntax:

• Dynamic syntax:

  DictHandle.['Key'] := Object

• Static syntax:

  DictHandle.Key := Object

Execution Information

• 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:

• DictHandleDictHandleDictHandledictHandledict_handle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

ObjectObjectObjectobjectValobject (input_object)  object(-array) → objectHObjectHObjectHObjectHobject

Object to be associated with the key.

DictHandleDictHandleDictHandledictHandledict_handle (input_control, state is modified)  dict → HDict, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Dictionary handle.

Number of elements: DictHandle == 1

KeyKeyKeykeykey (input_control)  string → HTupleUnion[str, int]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Key string.

Number of elements: Key == 1

Restriction: length(Key) > 0

Example (HDevelop)

create_dict (Dict)
read_image (Image, 'filename')
set_dict_object (Image, Dict, 'my_image')

Result

If the operation succeeds, set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object returns 2 ( H_MSG_TRUE) . Otherwise an exception is raised. Possible error conditions include invalid parameters (handle or key) or resource allocation error.

Possible Predecessors

create_dictcreate_dictCreateDictCreateDictcreate_dict

Possible Successors

set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple

Alternatives

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple

See also

create_dictcreate_dictCreateDictCreateDictcreate_dict, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple, get_dict_objectget_dict_objectGetDictObjectGetDictObjectget_dict_object, remove_dict_keyremove_dict_keyRemoveDictKeyRemoveDictKeyremove_dict_key, get_dict_paramget_dict_paramGetDictParamGetDictParamget_dict_param

Module

Foundation

---

ClassesClasses | | Operators