tr.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

tr(1) tr(1)

NAME

tr - translate characters

SYNOPSIS

tr [-Acs] string1 string2

tr -s [-Ac] string1

tr -d [-Ac] string1

tr -ds [-Ac] string1 string1

DESCRIPTION

tr copies the standard input to the standard output with substitution or deletion of selected characters.

Input characters from string1 are replaced with the corresponding characters in string2 . If necessary,

string1 and string2 can be quoted to avoid pattern matching by the shell.

tr recognizes the following command line options:

-A Translates on a byte-by-byte basis. When this ﬂag is speciﬁed

tr does not support

extended characters.

-c Complements the set of characters in string1 , which is the set of all characters in

the current character set, as deﬁned by the current setting of

LC_CTYPE, except for

those actually speciﬁed in the string1 argument. These characters are placed in the

array in ascending collation sequence, as deﬁned by the current setting of

LC_COLLATE.

-d Deletes all occurrences of input characters or collating elements found in the array

speciﬁed in string1 .

-c and -d are both speciﬁed, all characters except those speciﬁed by string1 are

deleted. The contents of string2 are ignored, unless

-s is also speciﬁed. Note, how-

ever, that the same string cannot be used for both the -d and the -s ﬂags; when

both ﬂags are speciﬁed, both string1 (used for deletion) and string2 (used for

squeezing) are required.

-d is not speciﬁed, each input character or collating element found in the array

speciﬁed by string1 is replaced by the character or collating element in the same

relative position speciﬁed by string2 .

-s Replaces any character speciﬁed in string1 that occurs as a string of two or more

repeating characters as a single instance of the character in string2 .

If the string2 contains a character class, the argument’s array contains all of the

characters in that character class. For example:

tr -s ’[:space:]’

In a case conversion, however, the string2 array contains only those characters

deﬁned as the second characters in each of the

toupper or tolower character

pairs, as appropriate. For example:

tr -s ’[:upper:]’’[:lower:]’

The following abbreviation conventions can be used to introduce ranges of characters, repeated characters

or single-character collating elements into the strings:

c1-c2 or

[c1-c2 ]

Stands for the range of collating elements c1 through c2, inclusive, as deﬁned by the

current setting of the LC_COLLATE locale category.

[:class :]or

[[:class :]]

Stands for all the characters belonging to the deﬁned character class, as deﬁned by

the current setting of LC_CTYPE locale category. The following character class

names will be accepted when speciﬁed in string1 : alnum, alpha, blank, cntrl.

digit, graph, lower, print, punct, space, upper,orxdigit, Character

classes are expanded in collation order.

When the

-d and -s ﬂags are speciﬁed together, any of the character class names

are accepted in string2 ; otherwise, only character class names lower or upper

are accepted in string2 and then only if the corresponding character class (upper

and lower, respectively) is speciﬁed in the same relative position in string1 . Such

a speciﬁcation is interpreted as a request for case conversion.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
tr(1) tr(1) NAME tr - translate characters SYNOPSIS tr [-Acs] string1 string2 tr -s [-Ac] string1 tr -d [-Ac] string1 tr -ds [-Ac] string1 string1 DESCRIPTION tr copies the standard input to the standard output with substitution or deletion of selected characters. Input characters from string1 are replaced with the corresponding characters in string2 . If necessary, string1 and string2 can be quoted to avoid pattern matching by the shell.
PAGE 2
tr(1) tr(1) When [:lower:] appears in string1 and [:upper:] appears in string2 , the arrays contain the characters from the toupper mapping in the LC_CTYPE category of the current locale. When [:upper:] appears in string1 and [:lower:] appears in string2 , the arrays contain the characters from the tolower mapping in the LC_CTYPE category of the current locale.
PAGE 3
tr(1) tr(1) Translate each digit in file1 to a # (number sign), and write the result to file2 . tr "0-9" "[#*]" file2 The * (asterisk) tells tr to repeat the # (number sign) enough times to make the second string as long as the first one. AUTHOR tr was developed by OSF and HP. SEE ALSO ed(1), sh(1), ascii(5), environ(5), lang(5), regexp(5). STANDARDS CONFORMANCE tr: SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.
PAGE 4
(Notes) A (Notes) tA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010