| 1 |
.\" RCSid "$Id: cnt.1,v 1.4 2019/07/20 00:57:43 greg Exp $"
|
| 2 |
.TH CNT 1 11/15/93 RADIANCE
|
| 3 |
.SH NAME
|
| 4 |
cnt - index counter
|
| 5 |
.SH SYNOPSIS
|
| 6 |
.B cnt
|
| 7 |
[
|
| 8 |
.B \-s
|
| 9 |
]
|
| 10 |
N1
|
| 11 |
[
|
| 12 |
N2 ..
|
| 13 |
]
|
| 14 |
.SH DESCRIPTION
|
| 15 |
.I Cnt
|
| 16 |
counts from 0 to N-1, producing N lines of output.
|
| 17 |
If multiple arguments are given,
|
| 18 |
.I cnt
|
| 19 |
produces a nested array of values where the final counter
|
| 20 |
rotates fastest through its range.
|
| 21 |
The
|
| 22 |
.I \-s
|
| 23 |
option shuffles the output lines, giving a different random
|
| 24 |
order on each invocation.
|
| 25 |
.I Cnt
|
| 26 |
is most useful in conjunction with
|
| 27 |
.I rcalc(1)
|
| 28 |
to produce array values.
|
| 29 |
.SH EXAMPLE
|
| 30 |
To create a 3 by 5 array:
|
| 31 |
.IP "" .2i
|
| 32 |
cnt 3 5
|
| 33 |
.PP
|
| 34 |
To generate a random shuffle of indices 0 through 51:
|
| 35 |
.IP "" .2i
|
| 36 |
cnt -s 52
|
| 37 |
.PP
|
| 38 |
Similar shuffling broken down by suit:
|
| 39 |
.IP "" .2i
|
| 40 |
cnt -s 4 13
|
| 41 |
.SH AUTHOR
|
| 42 |
Greg Ward
|
| 43 |
.SH "SEE ALSO"
|
| 44 |
neaten(1), rcalc(1), rlam(1), rsplit(1), total(1)
|