math::roman(3tcl) Tcl Math Library math::roman(3tcl)
______________________________________________________________________________
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
bugs and other problems. Please report such in the category math ::
roman of the Tcllib Trackers [http://core.tcl.tk/tcllib/reportlist].
Please also report any ideas for enhancements you may have for either
package and/or documentation.
When proposing code changes, please provide unified diffs, i.e the out-
put of diff -u.
Note further that attachments are strongly preferred over inlined
patches. Attachments can be made by going to the Edit form of the
ticket immediately after its creation, and then using the left-most
button in the secondary navigation bar.
KEYWORDS
conversion, integer, roman numeral
CATEGORY
Mathematics
COPYRIGHT
Copyright (c) 2005 Kenneth Green <kenneth.green@gmail.com>
tcllib 1.0 math::roman(3tcl)