Sum (GenericNamedArraylist function): Difference between revisions
Jump to navigation
Jump to search
m (→Examples) |
m (→Usage notes) |
||
Line 21: | Line 21: | ||
==Usage notes== | ==Usage notes== | ||
<ul> | |||
<li>The optional <var class="term">itemFunction</var> parameter lets you further manipulate the collection item values | |||
before calculating the sum. | |||
If your collection items are not intrinsic values, you must specify a function that can map the item values to intrinsic values or the method will fail. | |||
<p> | |||
For an example, see the <var>Arraylist</var> <var>Sum</var> [[Sum (Arraylist function)#Usage notes|"Usage notes"]] section. </p> | |||
</ul> | |||
==Examples== | ==Examples== |
Latest revision as of 20:08, 16 July 2012
Calculate sum of items or function of items (FloatNamedArraylist, NamedArraylist, and UnicodeNamedArraylist classes)
[Introduced in Sirius Mods 7.8]
This method returns by default the sum of the values of the items in the collection, or it returns the sum of the items after a specified function has been applied to them.
Syntax
%number = anyNal:Sum[( [itemFunction])]
Syntax terms
%number | A Float variable to contain the numeric result. |
---|---|
anyNal | An FloatNamedArraylist, NamedArraylist, or UnicodeNamedArraylist object. |
itemFunction | A function that operates on the type of the items in the collection. It may be a local method or method variable or a class member (Variable, Property), and it must return an intrinsic (probably Float) value.
The default itemFunction value is the special identity function, This, which simply returns the item value. |
Usage notes
- The optional itemFunction parameter lets you further manipulate the collection item values
before calculating the sum.
If your collection items are not intrinsic values, you must specify a function that can map the item values to intrinsic values or the method will fail.
For an example, see the Arraylist Sum "Usage notes" section.
Examples
b %nl is namedarrayList of float %nl = new %nl('April') = 3000 %nl('May') = 5000 %nl('June') = 8000 print %nl:sum end
The result is:
16000