Caltech Library logo

USAGE

range [OPTIONS] START_INTEGER END_INTEGER [INCREMENT_INTEGER]

DESCRIPTION

range is a simple utility for shell scripts that emits a list of integers starting with the first command line argument and ending with the last integer command line argument. It is a subset of functionality found in the Unix seq command.

If the first argument is greater than the last then it counts down otherwise it counts up.

OPTIONS

Below are a set of options available.

    -e, -end            The ending integer.
    -examples           display example(s)
    -generate-manpage   generate man page
    -generate-markdown  generate markdown documentation
    -h, -help           display help
    -inc, -increment    The non-zero integer increment value.
    -l, -license        display license
    -nl, -newline       if true add a trailing newline
    -quiet              suppress error messages
    -random             Pick a range value from range
    -s, -start          The starting integer.
    -v, -version        display version

EXAMPLES

Create a range of integers one through five

range 1 5

Yields 1 2 3 4 5

Create a range of integer negative two to six

range -- -2 6

Yields -2 -1 0 1 2 3 4 5 6

Create a range of even integers two to ten

range -increment=2 2 10

Yields 2 4 6 8 10

Create a descending range of integers ten down to one

range 10 1

Yields 10 9 8 7 6 5 4 3 2 1

Pick a random integer between zero and ten

range -random 0 10

Yields a random integer from 0 to 10

range v0.0.25