![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to rs.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSD / contrib / tools / man|
Return to rs.1 CVS log | Up to [CSRG BSD Unix] / 43BSD / contrib / tools / man |
1.1 root 1: .TH RS 1 "14 June 1983"
2: .UC 4
3: .SH NAME
4: rs \- reshape a data array
5: .SH SYNOPSIS
6: \fBrs [ \-[csCS][\fRx\fB][kKgGw][\fRN\fB]tTeEnyjhHm ] [ \fRrows\fB [ \fRcols\fB ] ]\fR
7: .SH DESCRIPTION
8: .I Rs
9: reads the standard input, interpreting each line as a row
10: of blank-separated entries in an array,
11: transforms the array according to the options,
12: and writes it on the standard output.
13: With no arguments it transforms stream input into a columnar
14: format convenient for terminal viewing.
15: .PP
16: The shape of the input array is deduced from the number of lines
17: and the number of columns on the first line.
18: If that shape were inconvenient, a more useful one might be
19: obtained by skipping some of the input with the \fB\-k\fP option.
20: Other options control interpretation of the input columns.
21: .PP
22: The shape of the output array is influenced by the
23: .I rows
24: and
25: .I cols
26: specifications, which should be positive integers.
27: If only one of them is a positive integer,
28: .I rs
29: computes a value for the other which will accommodate
30: all of the data.
31: When necessary, missing data are supplied in a manner
32: specified by the options and surplus data are deleted.
33: There are options to control presentation of the output columns,
34: including transposition of the rows and columns.
35: .PP
36: The options are described below.
37: .IP \fB\-c\fRx
38: Input columns are delimited by the single character \fIx\fP.
39: A missing \fIx\fP is taken to be `^I'.
40: .IP \fB\-s\fRx
41: Like \fB\-c\fR, but maximal strings of \fIx\fP are delimiters.
42: .IP \fB\-C\fRx
43: Output columns are delimited by the single character \fIx\fP.
44: A missing \fIx\fP is taken to be `^I'.
45: .IP \fB\-S\fRx
46: Like \fB\-C\fR, but padded strings of \fIx\fP are delimiters.
47: .IP \fB\-t\fR
48: Fill in the rows of the output array using the columns of the
49: input array, that is, transpose the input while honoring any
50: .I rows
51: and
52: .I cols
53: specifications.
54: .IP \fB\-T\fR
55: Print the pure transpose of the input, ignoring any
56: .I rows
57: or
58: .I cols
59: specification.
60: .IP \fB\-k\fRN
61: Ignore the first \fIN\fR lines of input.
62: .IP \fB\-K\fRN
63: Like \fB\-k\fR, but print the ignored lines.
64: .IP \fB\-g\fRN
65: The gutter width (inter-column space), normally 2, is taken to be \fIN\fR.
66: .IP \fB\-G\fRN
67: The gutter width has \fIN\fR percent of the maximum
68: column width added to it.
69: .IP \fB\-e\fR
70: Consider each line of input as an array entry.
71: .IP \fB\-n\fR
72: On lines having fewer entries than the first line,
73: use null entries to pad out the line.
74: Normally, missing entries are taken from the next line of input.
75: .IP \fB\-y\fR
76: If there are too few entries to make up the output dimensions,
77: pad the output by recycling the input from the beginning.
78: Normally, the output is padded with blanks.
79: .IP \fB\-h\fR
80: Print the shape of the input array and do nothing else.
81: The shape is just the number of lines and the number of
82: entries on the first line.
83: .IP \fB\-H\fR
84: Like \fB\-h\fR, but also print the length of each line.
85: .IP \fB\-j\fR
86: Right adjust entries within columns.
87: .IP \fB\-w\fRN
88: The width of the display, normally 80, is taken to be the positive
89: integer \fIN\fP.
90: .IP \fB\-m\fR
91: Do not trim excess delimiters from the ends of the output array.
92: .PP
93: With no arguments,
94: .I rs
95: transposes its input, and assumes one array entry per input line
96: unless the first non-ignored line is longer than the display width.
97: Option letters which take numerical arguments interpret a missing
98: number as zero unless otherwise indicated.
99: .SH EXAMPLES
100: .de IC
101: .IP
102: .ss 36
103: .ft B
104: ..
105: .de NC
106: .br
107: .ss 12
108: .PP
109: ..
110: .I Rs
111: can be used as a filter to convert the stream output
112: of certain programs (e.g.,
113: .IR spell ,
114: .IR du ,
115: .IR file ,
116: .IR look ,
117: .IR nm ,
118: .IR who ,
119: and
120: .IR wc (1))
121: into a convenient ``window'' format, as in
122: .IC
123: who | rs
124: .NC
125: This function has been incorporated into the
126: .IR ls (1)
127: program, though for most programs with similar output
128: .I rs
129: suffices.
130: .PP
131: To convert stream input into vector output and back again, use
132: .IC
133: rs 1 0 | rs 0 1
134: .NC
135: A 10 by 10 array of random numbers from 1 to 100 and
136: its transpose can be generated with
137: .IC
138: jot \-r 100 | rs 10 10 | tee array | rs \-T > tarray
139: .NC
140: In the editor
141: .IR vi (1),
142: a file consisting of a multi-line vector with 9 elements per line
143: can undergo insertions and deletions,
144: and then be neatly reshaped into 9 columns with
145: .IC
146: :1,$!rs 0 9
147: .NC
148: Finally, to sort a database by the first line of each 4-line field, try
149: .IC
150: rs \-eC 0 4 | sort | rs \-c 0 1
151: .NC
152: .SH SEE ALSO
153: jot(1), vi(1), sort(1), pr(1)
154: .SH AUTHOR
155: John Kunze
156: .SH BUGS
157: Handles only two dimensional arrays.
158:
159: The algorithm currently reads the whole file into memory,
160: so files that do not fit in memory will not be reshaped.
161:
162: Fields cannot be defined yet on character positions.
163:
164: Re-ordering of columns is not yet possible.
165:
166: There are too many options.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.