


math::roman(1.0)                                 math::roman(1.0)


______________________________________________________________________________

NAME
       math::roman - Tools for creating and manipulating roman numerals

SYNOPSIS
       package require Tcl  8.3

       package require math::roman  ?1.0?

       ::math::roman::toroman i

       ::math::roman::tointeger r

       ::math::roman::sort list

       ::math::roman::expr args

_________________________________________________________________

DESCRIPTION
       ::math::roman is a pure-Tcl library for converting between integers and
       roman numerals. It also provides utility functions for sorting and per-
       forming arithmetic on roman numerals.

       This   code   was   originally  harvested  from  the  Tcler's  wiki  at
       http://wiki.tcl.tk/1823 and as such is free for any use  for  any  pur-
       pose.  Many  thanks to the ingeneous folk who devised these clever rou-
       tines and generously contributed them to the Tcl community.

       While written and tested under Tcl 8.3, I expect this library will work
       under all 8.x versions of Tcl.

COMMANDS
       ::math::roman::toroman i
              Convert  an  integer  to roman numerals. The result is always in
              upper case. The value zero is converted to an empty string.

       ::math::roman::tointeger r
              Convert a roman numeral into an integer.

       ::math::roman::sort list
              Sort a list of roman numerals from smallest to largest.

       ::math::roman::expr args
              Evaluate an expression where the operands are all  roman  numer-
              als.

       Of  these  commands  both toroman and tointeger are exported for easier
       use. The other two are not, as they could interfer or be confused  with
       existing Tcl commands.

BUGS, IDEAS, FEEDBACK
       This  document,  and the package it describes, will undoubtedly contain



Tcl Math Library               math                             1





math::roman(1.0)                                 math::roman(1.0)


       bugs and other problems.  Please report such in the  category  math  ::
       roman     of     the     Tcllib     SF     Trackers     [http://source-
       forge.net/tracker/?group_id=12883].  Please also report any  ideas  for
       enhancements you may have for either package and/or documentation.

KEYWORDS
       conversion, integer, roman numeral

CATEGORY
       Mathematics

COPYRIGHT
       Copyright (c) 2005 Kenneth Green <kenneth.green@gmail.com>












































Tcl Math Library               math                             2


