rs - reshape a data array
rs [-[[csCS][x][kKgGw][N]tTeEnyjhHmz]] [rows [cols]]
rs reads the standard input, interpreting each line as a row
entries in an array, transforms the array according to the options,
and writes it on the standard output. With no arguments it transforms
stream input into a columnar format convenient for
The shape of the input array is deduced from the number of
lines and the
number of columns on the first line. If that shape is inconvenient, a
more useful one might be obtained by skipping some of the
input with the
-k option. Other options control interpretation of the input columns.
The shape of the output array is influenced by the rows and
which should be positive integers. If only one of
them is a
positive integer, rs computes a value for the other which
all of the data. When necessary, missing data are supplied in a
manner specified by the options and surplus data are deleted. There are
options to control presentation of the output columns, including transposition
of the rows and columns.
The options are as follows:
-cx Input columns are delimited by the single character
x. A missing
x is taken to be `^I'.
-sx Like -c, but maximal strings of x are delimiters.
-Cx Output columns are delimited by the single character
x. A missing
x is taken to be `^I'.
-Sx Like -C, but padded strings of x are delimiters.
-t Fill in the rows of the output array using the
columns of the input
array, that is, transpose the input while honoring any rows
and cols specifications.
-T Print the pure transpose of the input, ignoring any
rows or cols
-kN Ignore the first N lines of input.
-KN Like -k, but print the ignored lines.
-gN The gutter width (inter-column space), normally 2,
is taken to be
-GN The gutter width has N percent of the maximum column
-e Consider each line of input as an array entry.
-E Consider each character of input as an array entry.
-n On lines having fewer entries than the first line,
use null entries
to pad out the line. Normally, missing entries are taken
from the next line of input.
-y If there are too few entries to make up the output
pad the output by recycling the input from the beginning. Normally,
the output is padded with blanks.
-h Print the shape of the input array and do nothing
shape is just the number of lines and the number of
the first line.
-H Like -h, but also print the length of each line.
-j Right adjust entries within columns.
-wN The width of the display, normally 80, is taken to
be the positive
-m Do not trim excess delimiters from the ends of the
-z Adapt column widths to fit the largest entries appearing in them.
With no arguments, rs transposes its input, and assumes one
per input line unless the first non-ignored line is longer
than the display
width. Option letters which take numerical arguments
missing number as zero unless otherwise indicated.
rs can be used as a filter to convert the stream output of
(e.g., spell, du, file, look, nm, who, and wc(1)) into
``window'' format, as in
$ who | rs
This function has been incorporated into the ls(1) program,
most programs with similar output rs suffices.
To convert stream input into vector output and back again,
$ rs 1 0 | rs 0 1
A 10 by 10 array of random numbers from 1 to 100 and its
transpose can be
$ jot -r 100 | rs 10 10 | tee array | rs -T > tarray
In the editor vi(1), a file consisting of a multi-line vector with 9 elements
per line can undergo insertions and deletions, and
then be neatly
reshaped into 9 columns with
:1,$!rs 0 9
Finally, to sort a database by the first line of each 4-line
$ rs -eC 0 4 | sort | rs -c 0 1
jot(1), pr(1), sort(1), vi(1)
Handles only two dimensional arrays.
The algorithm currently reads the whole file into memory, so
do not fit in memory will not be reshaped.
Fields cannot be defined yet on character positions.
Re-ordering of columns is not yet possible.
There are too many options.
OpenBSD 3.6 December 30, 1993
[ Back ]