tr(1)                                                       tr(1)



NAME
     tr - translates characters

SYNOPSIS
     tr [-c] [-d] [-s] [string1 [string2]]

ARGUMENTS
     -c   Complements the set of characters in string1 with
          respect to the universe of characters whose ASCII codes
          are 001 through 377 octal.

     -d   Deletes all input characters in string1.

     -s   Squeezes all strings of repeated output characters in
          string2 into single characters.

     string1 [string2]
          Specifies the input characters (string1) and the output
          characters (string2).

          The following abbreviation conventions may be used to
          introduce ranges of characters or repeated characters
          into string1 and string2:

          [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.

          The escape character \ may be used, as in the shell, to
          remove special meaning from any character in a string.
          In addition, \ followed by 1, 2, or 3 octal digits
          stands for the character whose ASCII code is given by
          those digits.

DESCRIPTION
     tr 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.  For the substitution
     to work correctly, string2 must have at least as many
     characters as string1; excess characters in either string
     are ignored by tr.

     Similarly, when using the -c option, string1 must have at
     least as many characters as the complement of string1.




January 1992                                                    1

tr(1)                                                       tr(1)



EXAMPLES
     To create a list of all the words in file1, one per line in
     file2, enter:

        tr -cs "[A-Z][a-z]" "[\012*]" <file1 >file2

     where a word is taken to be a maximal string of alphabetics.
     (The strings are quoted to protect the special characters
     from interpretation by the shell; 012 is the ASCII code for
     newline.)  This was accomplished via the following
     translations:  tr substitutes the newline character for all
     the alphabetics in file1, reconstitutes the alphabetics with
     the -c option, squeezes the newlines to one per occurrence
     with the -s option, and directs the output to file2.

LIMITATIONS
     Won't handle ASCII NUL in string1 or string2; always deletes
     NUL from input.

FILES
     /usr/bin/tr
          Executable file
SEE ALSO
     dd(1), ed(1), sh(1)

     ascii(5) in A/UX Programmer's Reference

     ``Other Text Processing Tools'' in A/UX Text Processing
     Tools


























2                                                    January 1992