series
Definition: | object res = series(object start, object increment, integer count = 2, integer op = '+') |
Description: |
Create a sequence as a series starting from a given object.
start: the initial value from which to start increment: the value to recursively add to start to get new elements.count: the number of items in the returned sequence. The default is 2. op: the operation used to build the series, either '+' (the default) or '*'. Returns either 0 on failure or a sequence containing the series. |
pwa/p2js: | Supported, though naturally I’m much more of a tagset() person. |
Comments: |
The first item in the returned series is always start .
A linear series is formed by adding increment to start .A geometric series is formed by multiplying increment by start .
If count is negative, or if start op increment is invalid, 0 is returned.Otherwise, returns a sequence of length count , starting with start and whose adjacent
elements differ by increment .
|
Example: |
s = series( 1, 4, 5) -- s is {1, 5, 9, 13, 17} s = series( 1, 2, 6, '*') -- s is {1, 2, 4, 8, 16, 32} s = series({1,2,3}, 4, 2) -- s is {{1,2,3}, {5,6,7}} s = series({1,2,3}, {4,-1,10}, 2) -- s is {{1,2,3}, {5,1,13}} |
Implementation: | See builtins\pseries.e (an autoinclude) for details of the actual implementation. |
See Also: | tagset |