HALCON Reference Manual 10.0.2
Name
tuple_select_rangetuple_select_rangetuple_select_rangeTupleSelectRangeTupleSelectRange — Select several elements of a tuple.
tuple_select_rangetuple_select_rangetuple_select_rangeTupleSelectRangeTupleSelectRange selects several consecutive elements of the
input tuple TupleTupleTupleTupletuple and returns them with SelectedSelectedSelectedSelectedselected.
At this, LeftindexLeftindexLeftindexLeftindexleftindex determines the index of the first element
and RightindexRightindexRightindexRightindexrightindex determines the index of the last element to select.
Thus both parameters LeftindexLeftindexLeftindexLeftindexleftindex and RightindexRightindexRightindexRightindexrightindex must
contain a single integer value (any floating point number must
represent an integer value without fraction). Indices of tuple elements
start at 0, that means, the first tuple element has got the index 0.
The result tuple SelectedSelectedSelectedSelectedselected contains every element from the
tuple TupleTupleTupleTupletuple that has got an index between LeftindexLeftindexLeftindexLeftindexleftindex
and RightindexRightindexRightindexRightindexrightindex (including the elements at position
LeftindexLeftindexLeftindexLeftindexleftindex and RightindexRightindexRightindexRightindexrightindex). If the indices are equal,
only one element is selected.
In addition, it is possible that the right index is LeftindexLeftindexLeftindexLeftindexleftindex - 1.
In this case and if the left or right index are valid an empty tuple
is returned. Hence, the index RightindexRightindexRightindexRightindexrightindex must be greater or
equal to LeftindexLeftindexLeftindexLeftindexleftindex - 1.
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
TupleTupleTupleTupletuple (input_control) number(-array) → HTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)
Input tuple.
Index of first element to select.
Index of last element to select.
SelectedSelectedSelectedSelectedselected (output_control) number(-array) → HTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)
Selected tuple elements.
tuple_selecttuple_selecttuple_selectTupleSelectTupleSelect,
tuple_first_ntuple_first_ntuple_first_nTupleFirstNTupleFirstN,
tuple_last_ntuple_last_ntuple_last_nTupleLastNTupleLastN,
tuple_str_bit_selecttuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelect,
tuple_concattuple_concattuple_concatTupleConcatTupleConcat,
tuple_select_ranktuple_select_ranktuple_select_rankTupleSelectRankTupleSelectRank
tuple_removetuple_removetuple_removeTupleRemoveTupleRemove
Foundation
| HALCON Reference Manual 10.0.2 |
Copyright © 1996-2011 MVTec Software GmbH |