Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 an-
     other.  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  sup-
     ported, including numerous variants.

     If  the  input  number  system  is 'all', the number system will be autode-
     tected.

     numconv is a command line interface to libuninum a library  for  converting
     between textual representations of numbers and machine-internal representa-
     tions.  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  lo-
	    cale.

     -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 cur-
     rent 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/li-
     censes/gpl.txt)

numconv 			 September 2007 		      NUMCONV(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=numconv&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help