plan9-ascii(1) [debian man page]

ASCII(1)						      General Commands Manual							  ASCII(1)

NAME

       ascii, unicode - interpret ASCII, Unicode characters

SYNOPSIS

       ascii [ -8 ] [ -oxdbn ] [ -nct ] [ text ]

       unicode [ -nt ] hexmin-hexmax

       unicode [ -t ] hex [ ...  ]

       unicode [ -n ] characters

       look hex /lib/unicode

DESCRIPTION

       Ascii prints the ASCII values corresponding to characters and vice versa; under the -8 option, the ISO Latin-1 extensions (codes 0200-0377)
       are included.  The values are interpreted in a settable numeric base; -o specifies octal, -d decimal, -x hexadecimal (the default), and -bn
       base n.

       With  no  arguments, ascii prints a table of the character set in the specified base.  Characters of text are converted to their ASCII val-
       ues, one per line. If, however, the first text argument is a valid number in the specified base, conversion goes the opposite way.  Control
       characters are printed as two- or three-character mnemonics.  Other options are:

       -n     Force numeric output.

       -c     Force character output.

       -t     Convert from numbers to running text; do not interpret control characters or insert newlines.

       Unicode	is  similar; it converts between UTF and character values from the Unicode Standard (see utf(7)).  If given a range of hexadecimal
       numbers, unicode prints a table of the specified Unicode characters -- their values and UTF representations.  Otherwise it translates  from
       UTF  to numeric value or vice versa, depending on the appearance of the supplied text; the -n option forces numeric output to avoid ambigu-
       ity with numeric characters.  If converting to UTF , the characters are printed one per line unless the -t flag is set, in which  case  the
       output is a single string containing only the specified characters.  Unlike ascii, unicode treats no characters specially.

       The output of ascii and unicode may be unhelpful if the characters printed are not available in the current font.

       The  file /lib/unicode contains a table of characters and descriptions, sorted in hexadecimal order, suitable for look(1) on the lower case
       hex values of characters.

EXAMPLES

       ascii -d
	      Print the ASCII table base 10.

       unicode p
	      Print the hex value of `p'.

       unicode 2200-22f1
	      Print a table of miscellaneous mathematical symbols.

       look 039 /lib/unicode
	      See the start of the Greek alphabet's encoding in the Unicode Standard.

FILES

       /lib/unicode
	      table of characters and descriptions.

SOURCE

       /src/cmd/ascii.c
       /src/cmd/unicode.c

SEE ALSO

       look(1), tcs(1), utf(7), font(7)

																	  ASCII(1)

UNICODE(1)                                                    General Commands Manual                                                   UNICODE(1)

NAME

       unicode - command line unicode database query tool

SYNOPSIS

       unicode [options] string

DESCRIPTION

       This manual page documents the unicode command.

       unicode is a command line unicode database query tool.

OPTIONS

       -h     --help

              Show help and exit.

       -x     --hexadecimal

              Assume string to be a hexadecimal number

       -d     --decimal

              Assume string to be a decimal number

       -r     --regexp

              Assume string to be a regular expression

       -s     --string

              Assume string to be a sequence of characters

       -a     --auto

              Try to guess type of string from one of the above (default)

       -mMAXCOUNT
              --max=MAXCOUNT

              Maximal number of codepoints to display, default: 20; use 0 for unlimited

       -iCHARSET
              --io=IOCHARSET

              I/O  character  set. For maximal pleasure, run unicode on UTF-8 capable terminal and specify IOCHARSET to be UTF-8. unicode tries to
              guess this value from your locale, so with properly set up locale, you should not need to specify it.

       -cADDCHARSET
              --charset-add=ADDCHARSET

              Show hexadecimal reprezentation of displayed characters in this additional charset.

       -CUSE_COLOUR
              --colour=USE_COLOUR

              USE_COLOUR is one of on off auto

              --colour=on will use ANSI colour codes to colourise the output

              --colour=off won't use colours.

              --colour=auto will test if standard output is a tty, and use colours only when it is.

              --color is a synonym of --colour

       -v     --verbose

              Be more verbose about displayed characters, e.g. display Unihan information, if available.

       -w     --wikipedia

              Spawn browser pointing to Wikipedia entry about the character.

USAGE

       unicode tries to guess the type of an argument. For example, you can use any of the following to display  information  about  U+00E1  LATIN
       SMALL LETTER A WITH ACUTE (a):

       unicode 00E1

       unicode U+00E1

       unicode a

       unicode 'latin small letter a with acute'

       You  can  specify  a range of characters as argumets, unicode will show these characters in nice tabular format, aligned to 256-byte bound-
       aries.  Use two dots ".." to indicate the range, e.g.

       unicode 0450..0520

       will display the whole cyrillic and hebrew blocks (characters from U+0400 to U+05FF)

       unicode 0400..

       will display just characters from U+0400 up to U+04FF

BUGS

       Tabular format does not deal well with full-width, combining, control and RTL characters.

SEE ALSO

       ascii(1)

AUTHOR

       Radovan Garabik <garabik @ kassiopeia.juls.savba.sk>

                                                                    2003-01-31                                                          UNICODE(1)