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
       another.	 For example, it can  convert  from  Roman  Numerals  such  as
       "CCLVI"	to ordinary Western numbers such as "256" or from Western num-
       bers 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 autode-
       tected.

       numconv is a command line interface to libuninum	a library for convert-
       ing  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 cur-
	      rent locale.

       -m     When generating Roman numerals, use unit characters with	super-
	      script 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  In-
       dian 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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | AUTHOR | LICENSE

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

home | help