tuple_sumtuple_sumTupleSumTupleSum (Operator)
Name
tuple_sumtuple_sumTupleSumTupleSum
— Return the sum of all elements of a tuple.
Signature
Herror tuple_sum(const Hlong Tuple, double* Sum)
Herror T_tuple_sum(const Htuple Tuple, Htuple* Sum)
Description
tuple_sumtuple_sumTupleSumTupleSumTupleSum
returns the sum of all elements
of the input tuple TupleTupleTupleTupletuple
. All elements of TupleTupleTupleTupletuple
either have to be strings or numbers (integer or floating point numbers).
It is not allowed to mix strings with numerical values. The result
parameter SumSumSumSumsum
will contain a floating point number, if
at least one element of TupleTupleTupleTupletuple
is a floating point number.
If all elements of TupleTupleTupleTupletuple
are integer numbers the resulting
sum will also be an integer number. If TupleTupleTupleTupletuple
contains strings,
the concatenation will be used for building the sum.
Exception: Empty input tuple
If the input tuple is empty, the operator returns an empty tuple.
HDevelop In-line Operation
HDevelop provides an in-line operation for tuple_sumtuple_sumTupleSumTupleSumTupleSum
,
which can be used in an expression in the following syntax:
Sum := sum(Tuple)
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
TupleTupleTupleTupletuple
(input_control) tuple(-array) →
HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Input tuple.
SumSumSumSumsum
(output_control) tuple(-array) →
HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Sum of tuple elements.
Alternatives
tuple_meantuple_meanTupleMeanTupleMeanTupleMean
,
tuple_deviationtuple_deviationTupleDeviationTupleDeviationTupleDeviation
,
tuple_mintuple_minTupleMinTupleMinTupleMin
,
tuple_maxtuple_maxTupleMaxTupleMaxTupleMax
,
tuple_lengthtuple_lengthTupleLengthTupleLengthTupleLength
,
tuple_mediantuple_medianTupleMedianTupleMedianTupleMedian
See also
tuple_cumultuple_cumulTupleCumulTupleCumulTupleCumul
Module
Foundation