uniname(1) [debian man page]
uniname(1) General Commands Manual uniname(1) 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 off- set, 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 Pri- vate 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 apprpriate. If a byte offset is used, the character offsets shown are with respect to the beginning of the section of the file exam- ined 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)
Check Out this Related Man Page
unidesc(1) General Commands Manual unidesc(1) NAME
unidesc - Describe the contents of a Unicode text file SYNOPSIS
unidesc ([option flags]) (<file name>) If no input file name is supplied, unidesc reads from the standard input. DESCRIPTION
unidesc describes the content of a Unicode text file by reporting the character ranges to which different portions of the text belong. 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/). For each range of characters, unidesc prints the character or byte offset of the beginning of the range, the character or byte offset of the end of the range, and the name of the range. Offsets start from 0. Since the ASCII digits, punctuation, and whitespace characters are frequently used by other writing systems, by default these characters are treated as neutral, that is, as not belonging exclusively to any particular character range. These characters are treated as belonging to the range of whatever characters precede them. If the input begins with neutral characters, they are treated as belonging to the range of whatever characters follow them. If the file consists entirely of neutral characters, the range is identified as Neutral followed by Basic Latin in square brackets. A magic number identifying the Unicode encoding is not part of the Unicode standard, so pure Unicode files do not contain a magic number. However, informal conventions have arisen for this purpose. If the command line flag -m is given, unidesc will attempt to identify the Unicode subtype by examining the first few bytes of the input. If the input is identified as one of the two acceptable types, UTF-8 or native order UTF-32, it will then proceed to describe the contents of the input. Otherwise, it will report what it has learned and exit. Note that if the file does contain a magic number, you must use the -m flag. Without this flag unidesc assumes that the input consists of pure Unicode with the character data beginning immediately. It will therefore be thrown off by the magic number. By default, input is expected to be UTF-8. Native order UTF-32 is also acceptable. UTF-32 may be specified via the command line flag -u or, if the command line flag -m is given, via the magic number. COMMAND LINE FLAGS
-b Give file offsets in bytes rather than characters. -d Treat the ASCII digits as belonging exclusively to the Basic Latin range. -h Print usage information. -L List the Unicode ranges alphabetically. -l List the Unicode ranges by codepoint. -m Check the file's magic number to determine the Unicode subtype. -p Treat ASCII punctuation as belonging exclusively to the Basic Latin range. -r Instead of listing ranges as they are encountered, just list the ranges detected after all input has been read. -u Input is native order UTF-32. -v Print version information. -w Treat ASCII whitespace as belonging exclusively to the Basic Latin range. SEE ALSO
uniname REFERENCES
Unicode Standard, version 5.0 AUTHOR
Bill Poser billposer@alum.mit.edu LICENSE
GNU General Public License June, 2007 unidesc(1)