ClassesClassesClassesClasses | | | | Operators

tuple_select_masktuple_select_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask (Operator)


tuple_select_masktuple_select_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask — Select in mask specified elements of a tuple.


tuple_select_mask( : : Tuple, Mask : Selected)

Herror tuple_select_mask(const Hlong Tuple, const Hlong Mask, Hlong* Selected)

Herror T_tuple_select_mask(const Htuple Tuple, const Htuple Mask, Htuple* Selected)

Herror tuple_select_mask(const HTuple& Tuple, const HTuple& Mask, Hlong* Selected)

Herror tuple_select_mask(const HTuple& Tuple, const HTuple& Mask, HTuple* Selected)

void TupleSelectMask(const HTuple& Tuple, const HTuple& Mask, HTuple* Selected)

HTuple HTuple::TupleSelectMask(const HTuple& Mask) const

void HOperatorSetX.TupleSelectMask(
[in] VARIANT Tuple, [in] VARIANT Mask, [out] VARIANT* Selected)

VARIANT HTupleX.TupleSelectMask(
[in] VARIANT Tuple, [in] VARIANT Mask)

static void HOperatorSet.TupleSelectMask(HTuple tuple, HTuple mask, out HTuple selected)

HTuple HTuple.TupleSelectMask(HTuple mask)


tuple_select_masktuple_select_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask selects one or more single elements of the tuple TupleTupleTupleTupleTupletuple and returns them with SelectedSelectedSelectedSelectedSelectedselected. For every element MaskMaskMaskMaskMaskmask determines the corresponding element to select. If the value is greater than 0, the appropriate element is selected. Thus the length of the two input tuples has to be equal and MaskMaskMaskMaskMaskmask may only contain integer or float values.

Exception: Empty input tuples

If both input tuples are empty, the operator returns an empty tuple. If only one of the input tuples is empty and the other is not, an exception is raised.

HDevelop In-line Operation

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

Selected := select_mask(Tuple, Mask)



TupleTupleTupleTupleTupletuple (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Input tuple.

MaskMaskMaskMaskMaskmask (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

> 0 specifies the elements to select.

SelectedSelectedSelectedSelectedSelectedselected (output_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Selected tuple elements.


tuple_first_ntuple_first_nTupleFirstNtuple_first_nTupleFirstNTupleFirstN, tuple_last_ntuple_last_nTupleLastNtuple_last_nTupleLastNTupleLastN, tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelect, tuple_concattuple_concatTupleConcattuple_concatTupleConcatTupleConcat, tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect, tuple_select_rangetuple_select_rangeTupleSelectRangetuple_select_rangeTupleSelectRangeTupleSelectRange, tuple_select_ranktuple_select_rankTupleSelectRanktuple_select_rankTupleSelectRankTupleSelectRank

See also




ClassesClassesClassesClasses | | | | Operators