diff options
Diffstat (limited to 'static/v10/man1/cut.1')
| -rw-r--r-- | static/v10/man1/cut.1 | 137 |
1 files changed, 137 insertions, 0 deletions
diff --git a/static/v10/man1/cut.1 b/static/v10/man1/cut.1 new file mode 100644 index 00000000..6394f788 --- /dev/null +++ b/static/v10/man1/cut.1 @@ -0,0 +1,137 @@ +.TH CUT 1 +.CT 1 files +.SH NAME +cut, paste \- rearrange columns of data +.SH SYNOPSIS +.B cut +.BI -c list +[ +.I file ... +] +.PP +.B cut +.BI -f list +[ +.BI -d char +] +[ +.I file ... +] +.PP +.B paste +[ +.B -s +] +[ +.BI -d chars +] +.I file ... +.SH DESCRIPTION +.I Cut +selects fields from each line of the +.I files +(standard input default). +In data base parlance, it +projects a relation. +The fields +can be fixed length, +as on a punched card (option +.BR -c ), +or be marked with a delimiter character (option +.BR -f ). +.PP +The meanings of the options follow. +A +.I list +is an increasing sequence of integers separated by commas, or by +.B - +to indicate a range, for example +.L 1,3-5,7. +.TF -d\ char\ \ +.PD +.TP +.BI -c list +The +.I list +specifies character +positions. +.TP +.BI -f list +The +.I list +specifies field numbers. +.TP +.BI -d char +The character +is the delimiter for option +.BR -f . +Default is tab. +.TP +.B -s +Suppress lines with no delimiter characters. +Normally such lines pass through untouched under option +.BR -f . +.PP +.I Paste +concatenates corresponding lines of the input +.I files +and places the result on the standard output. +The file name +.L - +refers to the standard input. +Lines are glued together with +characters taken circularly from the set +.I chars. +The set may contain the special escape sequences +.B \en +(newline), +.B \et +(tab), +.B \e\e +(backslash), and +.B \e0 +(empty string, not a null character). +The options are +.TP +.BI -d chars +The output separator characters. +Default is a tab. +.TP +.B -s +Paste together lines of one file, +treating every line as if it came from a distinct input. +.SH EXAMPLES +.TP +.L +cut -d: -f1,3 /etc/passwd +Print map from login names to userids, see +.IR passwd (5). +.TP +.L +NAME=`who am i | cut -f1 -d" "` +Set +.L NAME +to current login name (subtly different from +.IR getuid (1)). +.PP +.EX +ls | paste - - - - +ls | paste -s '-d\et\en' - +.EE +.ns +.IP +4-column and 2-column file listing +.SH SEE ALSO +.IR gre (1), +.IR awk (1), +.IR sed (1), +.IR pr (1), +.IR column (1) +.SH BUGS +.I Cut +should handle disordered lists under option +.BR -f . +.br +In default of file names, +.I paste +should read the the standard input. |
