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)