unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



trbsd(1)							     trbsd(1)



NAME

  trbsd	- Translates characters

SYNOPSIS

  trbsd	[-Acs] string1 string2

  trbsd	-d  [-Ac] string1

  The trbsd command copies characters from the standard	input to the standard
  output with substitution or deletion of selected characters.

OPTIONS

  -A  Translates on a byte-by-byte basis.  When	you specify this option,
      trbsd does not support extended characters.

  -c  Complements (inverts) the	set of characters in string1 with respect to
      the universe of characters whose codes are 001 through 377 octal if you
      specify -A, and all characters if	you do not specify -A.

  -d  Deletes all characters in	string1	from output.

  -s  Changes characters that are repeated output characters in	string2	into
      single characters.

DESCRIPTION

  Input	characters from	string1	are replaced with the corresponding charac-
  ters in string2. The trbsd command cannot handle an ASCII NUL	(\000) in
  string1 or string2; it always	deletes	NUL from the input.

  The tr command is a System V compatible version of trbsd.

  Abbreviations	such as	a-z, standing for a string of characters whose ASCII
  codes	run from character a to	character z, inclusive,	can be used to intro-
  duce ranges of characters.  Note that	brackets are not special characters.

  Use the escape character \ (backslash) to remove the special meaning from
  any character	in a string.  Use the \	followed by 1, 2, or 3 octal digits
  for the code of a character.

  If a given character appears more than once in string1, the character	in
  string2 corresponding	to its last appearance in string1 will be used in the
  translation.








EXAMPLES

   1.  To translate braces into	parentheses, enter:
	    trbsd '{}' '()' <&lt;textfile >&gt;newfile

       This translates each { (left brace) to a	( (left	parenthesis) and each
       } (right	brace) to a ) (right parenthesis).  All	other characters
       remain unchanged.

   2.  To translate lowercase ASCII characters to uppercase, enter:
	    trbsd a-z A-Z <&lt;textfile >&gt;newfile

   3.  The two strings can be of different lengths:
	    trbsd 0-9 #	<&lt;textfile >&gt;newfile

       This translates each digit to a # (number sign);	if string2 is too
       short, it is padded to the length of string1 by duplicating its last
       character.

   4.  To translate each string	of digits to a single #	(number	sign), enter:
	    trbsd -s 0-9 # <&lt;textfile >&gt;newfile

   5.  To translate all	ASCII characters that are not specified, enter:
	    trbsd -c ' -~' 'A-_' <&lt;textfile >&gt;newfile

       This translates each nonprinting	ASCII character	to the corresponding
       control key letter (\001	translates to A, \002 to B, and	so on).
       ASCII DEL (\177), the character that follows ~ (tilde), translates to
       a ? (question mark).

SEE ALSO

  Commands:  ed(1), sh(1), tr(1)

  Files:  ascii(5)