HALCON Reference Manual 10.0.2
Table of Contents / Tuple / Selection ClassesClassesClasses | | | Operators

tuple_first_ntuple_first_ntuple_first_nTupleFirstNTupleFirstN (Operator)

Name

tuple_first_ntuple_first_ntuple_first_nTupleFirstNTupleFirstN — Select the first elements of a tuple.

Signature

tuple_first_n( : : Tuple, Index : Selected)

Herror tuple_first_n(const Hlong Tuple, const Hlong Index, Hlong* Selected)

Herror T_tuple_first_n(const Htuple Tuple, const Htuple Index, Htuple* Selected)

Herror tuple_first_n(const HTuple& Tuple, const HTuple& Index, Hlong* Selected)

Herror tuple_first_n(const HTuple& Tuple, const HTuple& Index, HTuple* Selected)

void HOperatorSetX.TupleFirstN(
[in] VARIANT Tuple, [in] VARIANT Index, [out] VARIANT* Selected)

VARIANT HTupleX.TupleFirstN(
[in] VARIANT Tuple, [in] VARIANT Index)

static void HOperatorSet.TupleFirstN(HTuple tuple, HTuple index, out HTuple selected)

HTuple HTuple.TupleFirstN(HTuple index)

Description

tuple_first_ntuple_first_ntuple_first_nTupleFirstNTupleFirstN selects the first elements of TupleTupleTupleTupletuple and returns them with SelectedSelectedSelectedSelectedselected. Thus SelectedSelectedSelectedSelectedselected contains all elements of TupleTupleTupleTupletuple from the first element up to the “n-th” element of TupleTupleTupleTupletuple (including the “n-th” element). The index “n” is determined by the input parameter IndexIndexIndexIndexindex. Thus IndexIndexIndexIndexindex must contain a single integer value (if IndexIndexIndexIndexindex consists of a floating point number, this 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.

Parallelization

Parameters

TupleTupleTupleTupletuple (input_control)  number(-array) HTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Input tuple.

IndexIndexIndexIndexindex (input_control)  number HTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double)

Index of the 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.

Alternatives

tuple_last_ntuple_last_ntuple_last_nTupleLastNTupleLastN, tuple_selecttuple_selecttuple_selectTupleSelectTupleSelect, tuple_last_ntuple_last_ntuple_last_nTupleLastNTupleLastN, tuple_str_bit_selecttuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelect, tuple_concattuple_concattuple_concatTupleConcatTupleConcat

See also

tuple_removetuple_removetuple_removeTupleRemoveTupleRemove

Module

Foundation


Table of Contents / Tuple / Selection ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH