Manual page for TR(1V)
tr - translate characters
SYNOPSIS
tr
[ -cds ]
[
string1
[
string2
] ]
SYSTEM V SYNOPSIS
/usr/5bin/tr
[ -cds ]
[
string1
[
string2
] ]
AVAILABILITY
The System V version of this command is available with the
System V
software installation option. Refer to
[a manual with the abbreviation INSTALL]
for information on how to install optional software.
DESCRIPTION
tr
copies the standard input to the standard output with substitution or
deletion of selected characters. The arguments
string1
and
string2
are considered sets of
characters.
Any input character found in
string1
is mapped into the character in the corresponding position within
string2.
When
string2
is short, it is padded to the length of
string1
by duplicating its last character.
In either string the notation:
-
a-b
denotes a range of characters from
a
to
b
in increasing
ASCII
order.
The character
\,
followed by 1, 2 or 3 octal digits stands for the character whose
ASCII
code is given by those digits.
As with the shell, the escape character
\,
followed by any other character, escapes any special meaning for that
character.
SYSTEM V DESCRIPTION
When
string2
is short, characters in
string1
with no corresponding character in
string2
are not translated.
In either string the following abbreviation conventions
introduce ranges of characters or repeated characters into
the strings. Note: in the System V version, square brackets are
required to specify a range.
- [a-z]
-
Stands for the string of characters whose
ASCII
codes run
from character
a
to character
z,
inclusive.
- [a*n]
-
Stands for
n
repetitions of
a.
If the first digit of
n
is
0,
n
is considered octal; otherwise,
n
is taken to be decimal.
A zero or missing
n
is taken to be huge;
this facility is useful for padding
string2.
OPTIONS
Any combination of the options
-c,
-d,
or
-s
may be used:
- -c
-
Complement the set of characters
in
string1
with respect to the universe of characters whose
ASCII
codes are 01
through 0377 octal;
- -d
-
Delete all input characters
in
string1.
- -s
-
Squeeze all strings of repeated output characters that are in
string2
to single characters.
EXAMPLE
The following example creates a list of all the words in
filename1
one per line in
filename2,
where a word is taken to be a maximal string of alphabetics.
The second string is quoted to protect
`\'
from the shell.
012 is the
ASCII
code for
NEWLINE.
tr -cs A-Za-z '\012' <filename1>filename2
In the System V version, this would be specified as:
tr -cs '[A-Z][a-z]' '[\012*]' <filename1>filename2
SEE ALSO
ed.1
expand.1
ascii.7
BUGS
Will not handle
ASCII NUL
in
string1
or
string2.
tr
always deletes
NUL
from input.
Created by unroff & hp-tools.
© somebody (See intro for details). All Rights Reserved.
Last modified 11/5/97