Translate characters (POSIX)
tr [-cs] [-r filename] string1 string2 tr [-cs] [-r filename] string1 tr -d [-c] [-r filename] string1 tr -ds [-c] [-r filename] string1 string2
- Complement the set of characters in string1 with respect to the universe of characters from 00 through FF hex. Characters in string1 are copied unchanged while all other characters are translated.
- Delete all input characters in string1 (or not in string1 for -dc).
- -r filename
- (BlackBerry PlayBook OS extension) Translate the named file in place (don't use stdin/stdout).
- Squeeze all output strings of one or more instances of a single character
in string1 to a single instance of the corresponding character
If you don't specify string2, tr squeezes instances of the characters in string1 to a single instance of that character.
- Translation character string (translate from).
- Translation character string (translate to).
The tr utility copies the standard input to the standard output with substitution or deletion of selected characters. The options specified and the string1 and string2 operands control translations that occur while copying characters.
The default behavior is to replace each input character found in string1 with the character at the same position in string2, while copying characters not in string1 unchanged.
When string2 is shorter than string1, string2 is extended to the length of string1 by duplicating the last character of string2. If string2 is explicitly a string of zero length, it's padded with NUL characters.
Conventions for string1 and string2
Use the following conventions in string1 or string2 or both to specify characters, character ranges, character classes, or collating elements:
- Represents that character.
- \ octal
- A backslash followed by 1, 2, or 3 octal digits represents a character with that encoded value.
- \ character
- A backslash followed by any character except an octal digit represents that character.
- c - c
- Represents the range of characters between the range endpoints, inclusive.
- [ c - c ]
- (BlackBerry PlayBook OS extension) The System V method of representing a range of characters.
- [: class :]
- Represents all characters belonging to the defined character class.
Allowable names for class are:
alnum, alpha, blank, cntrl, digit, graph, lower, print, punct, space, upper, xdigit
- [. cs .]
- Represents a collating symbol. Multicharacter collating symbols must be represented as collating symbols to distinguish them from a string of the same characters. This implementation allows an arbitrary string to be treated as a collating symbol (BlackBerry PlayBook OS extension).
- [ x * n ]
- Represents n repeated occurrences of the character or collating symbol x. This expression is valid only in string2. If n is omitted or is zero, it's interpreted as large enough to extend the string2-based sequence to the length of the string1-based sequence. If n has a leading zero, it's interpreted as an octal value. Otherwise, it's interpreted as a decimal value.
Convert all lowercase characters in the input to the corresponding uppercase characters:
tr '[:lower:]' '[:upper:]' <file1 >file2
tr '[a-z]' '[A-Z]' <file1 >file2
Create a list of all words in file1 one per line in file2 where a word is taken to be a maximal string of letters (octal 012 is the code for newline):
tr -cs '[:alpha:]' '[\012*]' <file 1 >file2
Convert a DOS file into a UNIX file:
tr -d '\15' <infile >outfile
- An error occurred.