tr 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. .TH TR 1
  2. .SH NAME
  3. tr \- translate characters
  4. .SH SYNOPSIS
  5. .B tr
  6. [
  7. .B -cds
  8. ]
  9. [
  10. .I string1
  11. [
  12. .I string2
  13. ]
  14. ]
  15. .SH DESCRIPTION
  16. .I Tr
  17. copies the standard input to the standard output with
  18. substitution or deletion of selected characters (runes).
  19. Input characters found in
  20. .I string1
  21. are mapped into the corresponding characters of
  22. .IR string2 .
  23. When
  24. .I string2
  25. is short it is padded to the length of
  26. .I string1
  27. by duplicating its last character.
  28. Any combination of the options
  29. .B -cds
  30. may be used:
  31. .TP
  32. .B -c
  33. Complement
  34. .IR string1 :
  35. replace it with a lexicographically ordered
  36. list of all other characters.
  37. .TP
  38. .B -d
  39. Delete from input all characters in
  40. .IR string1 .
  41. .TP
  42. .B -s
  43. Squeeze repeated output characters that occur in
  44. .I string2
  45. to single characters.
  46. .PP
  47. In either string a noninitial sequence
  48. .BI - x\f1,
  49. where
  50. .I x
  51. is any character (possibly quoted), stands for
  52. a range of characters:
  53. a possibly empty sequence of codes running from
  54. the successor of the previous code up through
  55. the code for
  56. .IR x .
  57. The character
  58. .L \e
  59. followed by 1, 2 or 3 octal digits stands for the
  60. character whose
  61. 16-bit
  62. value is given by those digits.
  63. The character sequence
  64. .L \ex
  65. followed by 1, 2, 3, or 4 hexadecimal digits stands
  66. for the character whose
  67. 16-bit value is given by those digits.
  68. A
  69. .L \e
  70. followed by any other character stands
  71. for that character.
  72. .SH EXAMPLES
  73. Replace all upper-case
  74. .SM ASCII
  75. letters by lower-case.
  76. .IP
  77. .EX
  78. tr A-Z a-z <mixed >lower
  79. .EE
  80. .PP
  81. Create a list of all
  82. the words in
  83. .L file1
  84. one per line in
  85. .LR file2 ,
  86. where a word is taken to be a maximal string of alphabetics.
  87. .I String2
  88. is given as a quoted newline.
  89. .IP
  90. .EX
  91. tr -cs A-Za-z '
  92. \&' <file1 >file2
  93. .EE
  94. .SH SOURCE
  95. .B /sys/src/cmd/tr.c
  96. .SH "SEE ALSO"
  97. .IR sed (1)