tr (Unix)
tr is a command in Unix, Plan 9, Inferno, and Unix-like operating systems. It is an abbreviation of translate or transliterate, indicating its operation of replacing or removing specific characters in its input data set.
The tr command | |
Original author(s) | Douglas McIlroy (AT&T Bell Laboratories) |
---|---|
Developer(s) | Various open-source and commercial developers |
Initial release | November 1973 |
Repository | |
Operating system | Unix, Unix-like, Plan 9, Inferno, OS-9, MSX-DOS, IBM i |
Platform | Cross-platform |
Type | Command |
License | coreutils: GPLv3+ |
Overview
The utility reads a byte stream from its standard input and writes the result to the standard output. As arguments, it takes two sets of characters (generally of the same length), and replaces occurrences of the characters in the first set with the corresponding elements from the second set. For example,
tr 'abcd' 'jkmn'
maps all characters a to j, b to k, c to m, and d to n.
The character set may be abbreviated by using character ranges. The previous example could be written:
tr 'a-d' 'jkmn'
In POSIX-compliant versions of tr
, the set represented by a character range depends on the locale's collating order, so it is safer to avoid character ranges in scripts that might be executed in a locale different from that in which they were written. Ranges can often be replaced with POSIX character sets such as [:alpha:].
The s
flag causes tr
to compress sequences of identical adjacent characters in its output to a single token. For example,
tr -s '\n'
replaces sequences of one or more newline characters with a single newline.
The d
flag causes tr
to delete all tokens of the specified set of characters from its input. In this case, only a single character set argument is used. The following command removes carriage return characters.
tr -d '\r'
The c
flag indicates the complement of the first set of characters. The invocation
tr -cd '[:alnum:]'
therefore removes all non-alphanumeric characters.
Implementations
The original version of tr
was written by Douglas McIlroy and was introduced in Version 4 Unix.[1]
The version of tr
bundled in GNU coreutils was written by Jim Meyering.[2]
The command is also available in the OS-9 shell.[3]
A tr
command is also part of ASCII's MSX-DOS2 Tools for MSX-DOS version 2.[4]
Most versions of tr
, including GNU tr
and classic Unix tr
, operate on single-byte characters and are not Unicode compliant. An exception is the Heirloom Toolchest implementation, which provides basic Unicode support.
The tr command has also been ported to the IBM i operating system.[5]
Ruby and Perl also have an internal tr operator, which operates analogously.[6][7] Tcl's string map command is more general in that it maps strings to strings while tr maps characters to characters.[8]
See also
References
- McIlroy, M. D. (1987). A Research Unix reader: annotated excerpts from the Programmer's Manual, 1971–1986 (PDF) (Technical report). Computing Science. AT&T Bell Laboratories. 139.
- https://linux.die.net/man/1/tr
- Paul S. Dayan (1992). The OS-9 Guru - 1 : The Facts. Galactic Industrial Limited. ISBN 0-9519228-0-7.
- MSX-DOS2 Tools User's Manual by ASCII Corporation
- IBM. "IBM System i Version 7.2 Programming Qshell" (PDF). Retrieved 2020-09-05.
- "tr (String) - APIdock". APIdock. Retrieved 12 August 2015.
- "tr - perldoc.perl.org". perldoc.perl.org. Retrieved 12 August 2015.
- "Tcl Built-In Commands - string manual page". Retrieved 12 August 2015.
External links
The Wikibook Guide to Unix has a page on the topic of: Commands |
- – Commands & Utilities Reference, The Single UNIX Specification, Issue 7 from The Open Group
- tr(1) – Unix 8th Edition manual page.
- – FreeBSD General Commands Manual
- – Solaris 10 User Commands Reference Manual
- – Linux User's Manual – User Commands}
- – Plan 9 Programmer's Manual, Volume 1
- – Inferno General commands Manual
- usage examples at examplenow.com