numconv(1)

1NUMCONV(1)                       User Commands                      NUMCONV(1)
2
3
4

NAME

6       numconv - convert numbers from one number system to another
7

SYNOPSIS

9       Numconv <options>
10

DESCRIPTION

12       numconv  is  a  filter that converts integers from one number system to
13       another.  For example, it can  convert  from  Roman  Numerals  such  as
14       "CCLVI"  to ordinary Western numbers such as "256" or from Western num‐
15       bers to Chinese.  The great majority of number systems, both modern and
16       ancient, are supported, including numerous variants.
17
18       If  the input number system is 'all', the number system will be autode‐
19       tected.
20
21       numconv is a command line interface to libuninum a library for convert‐
22       ing  between  textual  representations  of numbers and machine-internal
23       representations. Further information about the conversions performed is
24       available in the documentation for this library.
25

OPTIONS

27       -i <input file>
28              Read input from the specified file.
29
30       -o <output file>
31              Write output into the specified file.
32
33       -I     Identify the number system of the input.
34
35       -c     List the available number system cover terms.
36
37       -l     List the available number systems.
38
39       -f <input number system>
40              Specify the number system of the input.
41
42       -t <output number system>
43              Specify the number system of the output.
44
45       -b <input base>
46              Specify  the input base for Western numbers. The base must be in
47              the range [1,36].
48
49       -B <output base>
50              Specify the output base for Western numbers. The base must be in
51              the range [1,36].
52
53       -g <output general group size>
54              Specify  the size of digit groups other than the ow-order group.
55              The default is 3.
56
57       -G <output low group size>
58              Specify the size of the low-order group of digits.  The  default
59              is 3.
60
61       -s <output group separator character>
62              Specify  character  to use as "thousands separator". The default
63              is a comma.
64
65       -L     Set the output grouping parameters, general  group  size,  first
66              group size, and group separator character, according to the cur‐
67              rent locale.
68
69       -m     When generating Roman numerals, use unit characters with  super‐
70              script macron for thousands greater than one instead of Ms.
71
72       -h     Print help information.
73
74       -v     Print version information.
75

EXAMPLES

77       To convert from Roman Numerals to ordinary Western numbers:
78
79       numconv -f Roman -t Western_Lower
80
81       To  convert  from  ordinary Western numbers to the variety of number in
82       current use in the People's Republic of China:
83
84       numconv -f Western -t Mandarin_Regular_Simplified
85
86       To convert from ordinary Western numbers to Western numbers in base 2:
87
88       numconv -f Western_Lower -t Western_Lower -B 2
89
90       To convert from Urdu numbers to  Hindi  numbers  with  the  traditional
91       Indian grouping:
92
93       numconv -f Perso_Arabic -t Devanagari -g 2
94
95

AUTHOR

101       Bill Poser (billposer@alum.mit.edu)
102

LICENSE

104       GNU        General        Public        License,       version       2.
105       (http://www.gnu.org/licenses/gpl.txt)
106
107
108
109numconv                         September 2007                      NUMCONV(1)