Provided by: uniutils_2.27-2build1_amd64 bug

NAME

       uniname - Name the characters in a Unicode text file

SYNOPSIS

       uniname ([option flags]) (<file name>)

       If no input file name is supplied, uniname reads from the standard input.

DESCRIPTION

       uniname  names  the  characters in a Unicode text file.  For each character, uniname defaults to printing
       the character offset, the byte offset, the hexadecimal UTF-32 character code, the encoding as a  sequence
       of  hex  byte  values,  the  glyph,  and the character's Unicode name. Command line flags allow undesired
       information to be suppressed.  Glyphs that do not display nicely, such as control characters and  spaces,
       are  not  displayed.   For  the Latin-1 control characters, whose official Unicode name is "control", the
       real name is given. Character and byte offsets both start from 0.

       Where a character does not have a unique Unicode name, as  is  the  case  with  Chinese  characters,  the
       character  is identified as "character in such-and-such a range".  However, if the character is a Chinese
       character listed in Nelson's dictionary, the Nelson number is supplied.

       By default, input is expected to be UTF-8. Native order UTF-32 may be specified via the command line flag
       If invalid UTF8 is encountered, an explanation is printed as to why it is invalid.  -q.

COMMAND LINE FLAGS

       -A     Skip ASCII whitespace characters.

       -a     Skip ASCII characters.

       -B     Skip characters within the Basic Multilingual Plane.

       -b     Suppress printing of byte offset.

       -c     Suppress printing of character offset.

       -e     Suppress printing of encoding.

       -g     Suppress printing of glyph.

       -h     Print usage information.

       -l     Print line number.

       -n     Suppress printing of Unicode name.

       -p     Suppress printing of headers every screenfull.

       -q     Input is native order UTF-32.

       -r     Print Unicode range.  The ranges reported include both official Unicode ranges and the constructed
              language ranges within the Private Use  Areas  registered  with  the  Conscript  Unicode  Registry
              (http://www.evertype.com/standards/csur/).

       -s <character offset>
              Skip to specified character offset.

       -S <byte offset>
              Skip to specified byte offset. Note that even if the file consists of well-formed Unicode there is
              no  guarantee  that  the  byte sequence beginning at an arbitrary byte will be valid Unicode. This
              option is provided for use where other  programs  generate  only  byte  offsets  or  where  it  is
              necessary  to  skip  over damaged Unicode. In most circumstances use of a character offset will be
              more appropriate. If a byte offset is used, the character offsets shown are with  respect  to  the
              beginning of the section of the file examined rather than the beginning of the file.

       -u     Suppress printing of UTF32 code.

       -V     Validate  the input. In this case, nothing is done other than determine whether the input is valid
              UTF-8 Unicode. If it is, no output is produced and the program exits with  status  0.  If  invalid
              UTF-8  is  encountered,  the  program reports the location of the first invalid UTF-8 encountered,
              explains why it is invalid, and exits with status 1.

       -v     Print version information.

SEE ALSO

       unidesc

REFERENCES

       Unicode Standard, version 5.1

AUTHOR

       Bill Poser
       billposer@alum.mit.edu

LICENSE

       GNU General Public License

                                                 February, 2009                                       uniname(1)