Site Tools


jot
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


jot [2006/08/01 04:13] (current) – created - external edit 127.0.0.1
Line 1: Line 1:
 +# $EPIC: jot.txt,v 1.2 2006/08/01 03:50:35 sthalik Exp $
 +======Synopsis:======
 +$__jot__(<start> <stop> <interval>)
 +
 +======Technical:======
 +   * If the <start> argument is omitted the empty string is returned.
 +   * If the <stop> argument is omitted the empty string is returned.
 +   * If the <interval> argument is omitted the default value of 1 is used.
 +   * If the <interval> argument is 0, the empty string is returned.
 +   * The <interval> argument should be an integer value -- support for fractional numbers will be added in the future.
 +   * The <interval> argument should be positive; but if you specify a negative value, the absolute value of <interval> will be used.
 +   * If <start> is less than <stop>, then consider the sequence \\ [<start>, <start>+<interval>, <start>+<interval>+<interval>, ...  <L>], where <L> is less than or equal to <stop>.
 +   * If <start> is greater than <stop>, then consider the sequence \\ [<start>, <start>-<interval>, <start>-<interval>-<interval>, ...  <L>], where <L> is greater than or equal to <stop>.
 +   * This function returns a list of words that correspond to the elements in the smallest sequence that models the appropriate sequence.
 +
 +======Practical:======
 +This function creates a list of all of the numbers between <start> and <stop>,
 +with a step of <interval> Ranges can be ascending or descending, depending on
 +whether <stop> is greater than or less than <start> You can iterate over the
 +return value with [[FE]] or [[FOR]] i IN.  Another popular use is to pass the
 +return value to $[[chr]]() to create a range of ascii characters.
 +
 +======Returns:======
 +Every <interval>th number between <start> and <stop>, inclusive.
 +
 +======Examples:======
 +<file>
 +$jot(2 6)             returns "2 3 4 5 6"
 +$jot(2 7 2)           returns "2 4 6"
 +$jot(3 -2)            returns "3 2 1 0 -1 -2"
 +$jot(4)               returns ""  (empty string)
 +$jot(4 6 8)           returns "4"
 +$jot(a 4)             returns "0"
 +</file>
  
jot.txt · Last modified: 2006/08/01 04:13 by 127.0.0.1