NUMCONV(1)							   User Commands							NUMCONV(1)

NAME

       numconv - convert numbers from one number system to another

SYNOPSIS

       Numconv <options>

DESCRIPTION

       numconv	is  a  filter  that  converts integers from one number system to another.  For example, it can convert from Roman Numerals such as
       "CCLVI" to ordinary Western numbers such as "256" or from Western numbers to Chinese.  The great majority of number  systems,  both  modern
       and ancient, are supported, including numerous variants.

       If the input number system is 'all', the number system will be autodetected.

       numconv	is  a command line interface to libuninum a library for converting between textual representations of numbers and machine-internal
       representations. Further information about the conversions performed is available in the documentation for this library.

OPTIONS

       -i <input file>
	      Read input from the specified file.

       -o <output file>
	      Write output into the specified file.

       -I     Identify the number system of the input.

       -c     List the available number system cover terms.

       -l     List the available number systems.

       -f <input number system>
	      Specify the number system of the input.

       -t <output number system>
	      Specify the number system of the output.

       -b <input base>
	      Specify the input base for Western numbers. The base must be in the range [1,36].

       -B <output base>
	      Specify the output base for Western numbers. The base must be in the range [1,36].

       -g <output general group size>
	      Specify the size of digit groups other than the ow-order group. The default is 3.

       -G <output low group size>
	      Specify the size of the low-order group of digits. The default is 3.

       -s <output group separator character>
	      Specify character to use as "thousands separator". The default is a comma.

       -L     Set the output grouping parameters, general group size, first group size, and group separator character, according  to  the  current
	      locale.

       -m     When generating Roman numerals, use unit characters with superscript macron for thousands greater than one instead of Ms.

       -h     Print help information.

       -v     Print version information.

EXAMPLES

       To convert from Roman Numerals to ordinary Western numbers:

       numconv -f Roman -t Western_Lower

       To convert from ordinary Western numbers to the variety of number in current use in the People's Republic of China:

       numconv -f Western -t Mandarin_Regular_Simplified

       To convert from ordinary Western numbers to Western numbers in base 2:

       numconv -f Western_Lower -t Western_Lower -B 2

       To convert from Urdu numbers to Hindi numbers with the traditional Indian grouping:

       numconv -f Perso_Arabic -t Devanagari -g 2

SEE ALSO

       libuninum (3)

AUTHOR

       Bill Poser (billposer@alum.mit.edu)

LICENSE

       GNU General Public License, version 2. (http://www.gnu.org/licenses/gpl.txt)

numconv 							  September 2007							NUMCONV(1)