sum (';' LIST )*
Macro
Summary
The sum macro calculates the sum of all numeric values provided in one or more lists. Each element is parsed as a double-precision floating-point number.
Syntax
${sum;<list>[;<list>...]}
Parameters
list- One or more semicolon-separated lists of numeric values
Behavior
- Parses all elements as double-precision numbers
- Calculates the sum of all values
- Returns the total as a string
- Throws exception if any value is not numeric
Examples
Sum a simple list:
${sum;1,2,3,4,5}
# Returns: "15"
Sum multiple lists:
${sum;10,20;30,40}
# Returns: "100"
Sum decimal values:
${sum;1.5,2.5,3.5}
# Returns: "7.5"
Calculate total from properties:
total=${sum;${value1};${value2};${value3}}
Use Cases
- Calculating totals and aggregates
- Summing metric values
- Computing combined sizes or counts
- Mathematical calculations in builds
- Aggregating numeric configuration
Notes
- All values must be numeric
- Returns double-precision result
- See also:
${average}for mean calculation - See also:
${max}and${min}for extremes
See test cases in MacroTestsForDocsExamples.java