Operator Reference

HALCON Operator Reference / Tuple / Arithmetic

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

tuple_addtuple_addTupleAddTupleAddtuple_add (Operator)

tuple_addtuple_addTupleAddTupleAddtuple_add — Add two tuples.

Signature

tuple_add( : : S1, S2 : Sum)

Herror tuple_add(double S1, double S2, double* Sum)

Herror T_tuple_add(const Htuple S1, const Htuple S2, Htuple* Sum)

void TupleAdd(const HTuple& S1, const HTuple& S2, HTuple* Sum)

HTuple HTuple::TupleAdd(const HTuple& S2) const

static void HOperatorSet.TupleAdd(HTuple s1, HTuple s2, out HTuple sum)

HTuple HTuple.TupleAdd(HTuple s2)

def tuple_add(s1: MaybeSequence[Union[float, int, str]], s2: MaybeSequence[Union[float, int, str]]) -> Sequence[Union[float, int, str]]

def tuple_add_s(s1: MaybeSequence[Union[float, int, str]], s2: MaybeSequence[Union[float, int, str]]) -> Union[float, int, str]

Description

tuple_addtuple_addTupleAddTupleAddtuple_add computes the sum of the input tuples S1S1S1s1s1 and S2S2S2s2s2. If both tuples have the same length the corresponding elements of both tuples are added. Otherwise, either S1S1S1s1s1 or S2S2S2s2s2 must have length 1. In this case, the addition is performed for each element of the longer tuple with the single element of the other tuple. If two integer numbers are added, the result is again an integer number. If a floating point number is added to another number, the result is a floating point number. If two strings are added, the addition corresponds to a string concatenation. If a number and a string are added, the number is converted to a string first. Thus, the addition also corresponds to a string concatenation in this case.

Exception: Empty input tuples

If either or both of the input tuples are empty, the operator returns an empty tuple.

HDevelop In-line Operation

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

Sum := S1 + S2

The + operation corresponds to a string concatenation if S1S1S1s1s1 and S2S2S2s2s2 contain strings.

Execution Information

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

Parameters

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

Input tuple 1.

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

Input tuple 2.

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

Sum of the input tuples.

Alternatives

tuple_subtuple_subTupleSubTupleSubtuple_sub

See also

tuple_cumultuple_cumulTupleCumulTupleCumultuple_cumul

Module

Foundation

---

ClassesClasses | | Operators