tr.1 - 9base - revived minimalist port of Plan 9 userland to Unix | |
git clone git://git.suckless.org/9base | |
Log | |
Files | |
Refs | |
README | |
LICENSE | |
--- | |
tr.1 (1729B) | |
--- | |
1 .TH TR 1 | |
2 .SH NAME | |
3 tr \- translate characters | |
4 .SH SYNOPSIS | |
5 .B tr | |
6 [ | |
7 .B -cds | |
8 ] | |
9 [ | |
10 .I string1 | |
11 [ | |
12 .I string2 | |
13 ] | |
14 ] | |
15 .SH DESCRIPTION | |
16 .I Tr | |
17 copies the standard input to the standard output with | |
18 substitution or deletion of selected characters (runes). | |
19 Input characters found in | |
20 .I string1 | |
21 are mapped into the corresponding characters of | |
22 .IR string2 . | |
23 When | |
24 .I string2 | |
25 is short it is padded to the length of | |
26 .I string1 | |
27 by duplicating its last character. | |
28 Any combination of the options | |
29 .B -cds | |
30 may be used: | |
31 .TP | |
32 .B -c | |
33 Complement | |
34 .IR string1 : | |
35 replace it with a lexicographically ordered | |
36 list of all other characters. | |
37 .TP | |
38 .B -d | |
39 Delete from input all characters in | |
40 .IR string1 . | |
41 .TP | |
42 .B -s | |
43 Squeeze repeated output characters that occur in | |
44 .I string2 | |
45 to single characters. | |
46 .PP | |
47 In either string a noninitial sequence | |
48 .BI - x\f1, | |
49 where | |
50 .I x | |
51 is any character (possibly quoted), stands for | |
52 a range of characters: | |
53 a possibly empty sequence of codes running from | |
54 the successor of the previous code up through | |
55 the code for | |
56 .IR x . | |
57 The character | |
58 .L \e | |
59 followed by 1, 2 or 3 octal digits stands for the | |
60 character whose | |
61 16-bit | |
62 value is given by those digits. | |
63 The character sequence | |
64 .L \ex | |
65 followed by 1, 2, 3, or 4 hexadecimal digits stands | |
66 for the character whose | |
67 16-bit value is given by those digits. | |
68 A | |
69 .L \e | |
70 followed by any other character stands | |
71 for that character. | |
72 .SH EXAMPLES | |
73 Replace all upper-case | |
74 .SM ASCII | |
75 letters by lower-case. | |
76 .IP | |
77 .EX | |
78 tr A-Z a-z <mixed >lower | |
79 .EE | |
80 .PP | |
81 Create a list of all | |
82 the words in | |
83 .L file1 | |
84 one per line in | |
85 .LR file2 , | |
86 where a word is taken to be a maximal string of alphabetics. | |
87 .I String2 | |
88 is given as a quoted newline. | |
89 .IP | |
90 .EX | |
91 tr -cs A-Za-z ' | |
92 \&' <file1 >file2 | |
93 .EE | |
94 .SH SOURCE | |
95 .B \*9/src/cmd/tr.c | |
96 .SH "SEE ALSO" | |
97 .IR sed (1) |