.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "RANGE 1"
.TH RANGE 1 "2020-06-09" "perl v5.30.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
numrange \- Print out a range of numbers for use in for loops and such.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBnumrange\fR [\-dhV] /<expression>/
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBnumrange\fR
will print out a list of numbers based on an expression that you specify.  This
is useful for making a list of numbers for use in for loops and so on.
Ranges are inclusive.
Ranges of
numbers are specified using the .. operator, like this /20..50/, which means all
integers from 20 to 50 inclusive.  More complex expressions can be generated using the commas
and the 'i' increment operator.
.SH "OPTIONS"
.IX Header "OPTIONS"
.Vb 6
\&    \-e <set> Exclude the <set> of numbers from the range output.  <set>
\&       is a set of numbers separated by commas.
\&    \-n <n> Use <n> as the separator between numbers.  By default, it
\&       will use a space.  Use \*(Aq\en\*(Aq or \e\en for a newline character or
\&       use the \-N option.
\&    \-N  Just a quick option for using a newline as the separator.
\&
\&    \-h  Help: You\*(Aqre looking at it.
\&    \-V  Increase verbosity.
\&    \-d  Debug mode.  For developers
.Ve
.SH "EXAMPLES"
.IX Header "EXAMPLES"
.Vb 3
\&   All numbers from 1 to 10.
\&    $ numrange /1..10/
\&    1 2 3 4 5 6 7 8 9 10
\&
\&   From 10 to 1. Counting down.
\&    $ numrange /10..1/
\&    10 9 8 7 6 5 4 3 2 1
\&
\&   From 1 to 10 and from 15 to 20.
\&    $ numrange /1..10,15..20/
\&    1 2 3 4 5 6 7 8 9 10 15 16 17 18 19 20
\&
\&   Even numbers from 0 to 10
\&    $ numrange /0..10i2/
\&    0 2 4 6 8 10
\&
\&   Odd numbers.  Notice the starting number in the range expression.
\&    $ numrange /1..10i2/
\&    1 3 5 7 9
\&
\&   Factors of 3 between 99 and 120.
\&    $ numrange /99..120i3/
\&    99 102 105 108 111 114 117 120
\&
\&   Decimal numbers
\&    $ numrange /1.1..2.5i0.1/
\&    1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 2 2.1 2.2 2.3 2.4 2.5
\&
\&   And negative numbers too.
\&    $ numrange /1.0..\-2.0i0.3/
\&    1 0.7 0.4 0.1 \-0.2 \-0.5 \-0.8 \-1.1 \-1.4 \-1.7 \-2
\&
\&   You can also pad numbers when you are counting up.  This is
\&   a trick of how the Perl programming language deals with ranges:
\&   
\&    $ numrange /01..15/
\&    01 02 03 04 05 06 07 08 09 10 11 12 13 14 15
.Ve
.SH "BUGS"
.IX Header "BUGS"
Even though you can do zero padding on simple ranges, like 001..100,
it will not pad zeros on complex ranges like 001..100i2, or for counting
downwards.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBseq\fR\|(1), \fBnumaverage\fR\|(1), \fBnumbound\fR\|(1), \fBnuminterval\fR\|(1), \fBnumnormalize\fR\|(1), \fBnumgrep\fR\|(1), \fBnumprocess\fR\|(1), \fBnumsum\fR\|(1), \fBnumrandom\fR\|(1), \fBnumround\fR\|(1)
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
numrange is part of the num-utils package, which is copyrighted by
Suso Banderas and released under the \s-1GPL\s0 license.  Please read
the \s-1COPYING\s0 and \s-1LICENSE\s0 files that came with the num-utils package
.PP
.Vb 2
\&  Developers can read the GOALS file and contact me about providing
\&submitions or help for the project.
.Ve
.SH "MORE INFO"
.IX Header "MORE INFO"
More info on numrange can be found at:
.IP "\fBhttp://suso.suso.org/xulu/Num\-utils\fR" 1
.IX Item "http://suso.suso.org/xulu/Num-utils"