Operator Reference

HALCON Operator Reference / Tuple / Data Containers
ClassesClasses | | Operators

get_dict_tupleT_get_dict_tupleGetDictTupleGetDictTupleget_dict_tuple (Operator)

get_dict_tupleT_get_dict_tupleGetDictTupleGetDictTupleget_dict_tuple — Retrieve a tuple associated with the key from the dictionary.

Signature

get_dict_tuple( : : DictHandle, Key : Tuple)

Herror T_get_dict_tuple(const Htuple DictHandle, const Htuple Key, Htuple* Tuple)

void GetDictTuple(const HTuple& DictHandle, const HTuple& Key, HTuple* Tuple)

HTuple HDict::GetDictTuple(const HTuple& Key) const

HTuple HDict::GetDictTuple(const HString& Key) const

HTuple HDict::GetDictTuple(const char* Key) const

HTuple HDict::GetDictTuple(const wchar_t* Key) const   ( Windows only)

static void HOperatorSet.GetDictTuple(HTuple dictHandle, HTuple key, out HTuple tuple)

HTuple HDict.GetDictTuple(HTuple key)

HTuple HDict.GetDictTuple(string key)

def get_dict_tuple(dict_handle: HHandle, key: MaybeSequence[Union[str, int]]) -> Sequence[Union[int, float, str]]

def get_dict_tuple_s(dict_handle: HHandle, key: MaybeSequence[Union[str, int]]) -> Union[int, float, str]

Description

get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple retrieves a tuple associated with the KeyKeyKeykeykey from the dictionary denoted by the DictHandleDictHandleDictHandledictHandledict_handle. The tuple has to be previously stored to the dictionary using set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple.

The operator returns the data in the parameter TupleTupleTupletupletuple. The data including strings is copied by the operation, the dictionary can thus be immediately reused.

If the given KeyKeyKeykeykey is not present in the dictionary or if the data associated with the key is not a tuple, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple fails. Presence of keys and information about the data associated with the key can be verified using get_dict_paramget_dict_paramGetDictParamGetDictParamget_dict_param.

Obtaining the values for multiple keys at once is only possible if for each of those keys, the dictionary contains a tuple with a single element.

HDevelop In-line Operation

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

  • Dynamic syntax:

    Tuple := DictHandle.['Key']

  • Static syntax:

    Tuple := DictHandle.Key

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

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

Dictionary handle.

Number of elements: DictHandle == 1

KeyKeyKeykeykey (input_control)  string(-array) → HTupleMaybeSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Key string.

TupleTupleTupletupletuple (output_control)  tuple(-array) → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Tuple value retrieved from the dictionary.

Example (HDevelop)

* ...
get_dict_param (Dict, 'key_exists', ['simple_string','foo','my_image'], \
                KeysPresence)
get_dict_param (Dict, 'key_data_type', ['simple_string','my_image'], \
                KeysType)
get_dict_tuple (Dict, 'simple_string', TupleString)
*
* Access multiple keys, if their tuple all have length 1
get_dict_tuple (Dict, ['key1','key2','key3'], MultipleValues)

Result

If the operation succeeds, get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple returns 2 ( H_MSG_TRUE) . Otherwise an exception is raised. Possible error conditions include invalid parameters (handle or key), the required key not found in the dictionary, or other than tuple data associated with given key.

Possible Predecessors

set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple

Possible Successors

get_dict_tupleget_dict_tupleGetDictTupleGetDictTupleget_dict_tuple, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple, set_dict_tuple_atset_dict_tuple_atSetDictTupleAtSetDictTupleAtset_dict_tuple_at

Alternatives

get_dict_objectget_dict_objectGetDictObjectGetDictObjectget_dict_object

See also

create_dictcreate_dictCreateDictCreateDictcreate_dict, set_dict_tupleset_dict_tupleSetDictTupleSetDictTupleset_dict_tuple, set_dict_objectset_dict_objectSetDictObjectSetDictObjectset_dict_object, 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