tr(1) [plan9 man page]

TR(1)							      General Commands Manual							     TR(1)

NAME

       tr - translate characters

SYNOPSIS

       tr [ -cds ] [ string1 [ string2 ] ]

DESCRIPTION

       Tr  copies  the standard input to the standard output with substitution or deletion of selected characters (runes).  Input characters found
       in string1 are mapped into the corresponding characters of string2.  When string2 is short it is padded to the length of string1 by  dupli-
       cating its last character.  Any combination of the options -cds may be used:

       -c     Complement string1: replace it with a lexicographically ordered list of all other characters.

       -d     Delete from input all characters in string1.

       -s     Squeeze repeated output characters that occur in string2 to single characters.

       In  either  string a noninitial sequence -x, where x is any character (possibly quoted), stands for a range of characters: a possibly empty
       sequence of codes running from the successor of the previous code up through the code for x.  The character followed by 1,  2  or  3  octal
       digits  stands for the character whose 16-bit value is given by those digits.  The character sequence followed by 1, 2, 3, or 4 hexadecimal
       digits stands for the character whose 16-bit value is given by those digits.  A followed by any other character stands for that character.

EXAMPLES

       Replace all upper-case ASCII letters by lower-case.

	      tr A-Z a-z <mixed >lower

       Create a list of all the words in one per line in where a word is taken to be a maximal string of  alphabetics.	 String2  is  given  as  a
       quoted newline.

	      tr -cs A-Za-z '
	      ' <file1 >file2

SOURCE

       /sys/src/cmd/tr.c

SEE ALSO

       sed(1)

																	     TR(1)

tr(1)							      General Commands Manual							     tr(1)

Name
       tr - translate characters

Syntax
       tr [-cds] [string1[string2]]

Description
       The  command copies the standard input to the standard output with substitution or deletion of selected characters.  Input characters found
       in string1 are mapped into the corresponding characters of string2.  When string2 is short it is padded to the length of string1 by  dupli-
       cating  its  last character.  Any combination of the options -cds may be used: -c complements the set of characters in string1 with respect
       to the universe of characters whose ASCII codes are 0 through 0377 octal; -d deletes all input  characters  in  string1;  -s  squeezes  all
       strings of repeated output characters that are in string2 to single characters.

       In  either string the notation a-b means a range of characters from a to b in increasing ASCII order.  The backslash character () followed
       by 1, 2 or 3 octal digits stands for the character whose ASCII code is given by those digits.  A  followed by any other  character  stands
       for that character.

       The  following  example creates a list of all the words in `file1' one per line in `file2', 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 '12' <file1 >file2

Options
       -c   Translates complements:  string1 to those not in string1.

       -d   Deletes all characters in string1 from output.

       -s   Squeezes succession of a character in string1 to one in output.

Restrictions
       `', `0', and `00' are equivalent for NUL character.

       `12' is treated as octal 12 and not a NUL followed by characters 1 and 2.

See Also
       ed(1), ascii(7), expand(1)

																	     tr(1)