tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMask (Operator)

Name

tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMask — Select in mask specified elements of a tuple.

Signature

tuple_select_mask( : : Tuple, Mask : Selected)

tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMask selects one or more single elements of the tuple TupleTupleTupleTupletuple and returns them with SelectedSelectedSelectedSelectedselected. For every element MaskMaskMaskMaskmask 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 MaskMaskMaskMaskmask 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_maskTupleSelectMaskTupleSelectMaskTupleSelectMask, which can be used in an expression in the following syntax:

Selected := select_mask(Tuple, Mask)

Execution Information

Multithreading type: independent (runs in parallel even with exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.