/usr/share/doc/rmagic/html/numfmts.html

<!doctype html public "-//W3C//DTD HTML 4.0 Transitional//EN">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=iso8859-1" />
        <meta name="AUTHOR" content="This page created by Wadsack-Allen Digital Goup" />
        <title>Report Magic for Analog Documentation - Number Format Specification</title>
<style type="text/css">
<!--
body {
    font-family: Verdana, Arial, Helvetica, sans-serif; 
    font-size:11pt;
}

p {
    font-family: Verdana, Arial, Helvetica, sans-serif; 
    font-size:11pt;
}

a {
    text-decoration:normal;
}

h1 {
    font-family: Tahoma, Arial, Helvetica, sans-serif; 
    font-size:24pt; 
    font-weight:bold;
}

h2 {
    font-family: Tahoma, Arial, Helvetica, sans-serif; 
    font-size:18pt; 
    font-weight:bold;
}

h3 {
    font-family: Tahoma, Arial, Helvetica, sans-serif; 
    font-size:16pt; 
    font-weight:bold;
}

h4 {
    font-family: Verdana, Arial, Helvetica, sans-serif; 
    font-size:14pt; 
    font-weight:bold
}

dl {
    font-family: Verdana, Arial, Helvetica, sans-serif; 
    font-size:10pt;
}

ul {
    font-family: Verdana, Arial, Helvetica, sans-serif; 
    font-size:10pt;
}

ol {
    font-family: Verdana, Arial, Helvetica, sans-serif; 
    font-size:10pt;
}

.fineprint {
    font-family:Arial, Helvetica; 
    font-size:8pt;
}

.fineprint a {
    color:#000099;
    font-weight:bold;
}

code {
    font-family: "Courier New", Courier, Monospaced, System; 
}
pre {
    font-family: "Courier New", Courier, Monospaced, System; 
}

.note  { 
	background-color: #f50000; 
	margin-right: 2em; 
	margin-left: 2em; 
	padding-right: 2px; 
	padding-left: 2px; 
	border: solid 1px #c50000; 
}

.term  { 
	background-color: #f5f5f5; 
	margin-right: 2em; 
	margin-left: 2em; 
	padding-right: 2px; 
	padding-left: 2px; 
	border: solid 1px silver;
	font-family: monospace,courier,fixedsys;
	font-size: 8pt;
}
-->
</style>
    </head>

    <body bgcolor="#ffffff" text="#000000" link="#000099" vlink="#cc3399" alink="#003399">
        <table border="0" cellspacing="0" cellpadding="0" summary="Layout table">
            <tr>
                <td align="center"><a href="http://www.reportmagic.org/"><img src="images/title.gif" width="288" height="66" alt="Report Magic for Analog" border="0" /></a> </td>

                <td rowspan="2" align="left" valign="top"><img src="images/logo.gif" width="138" height="150" alt="Documentation" /> </td>
            </tr>

            <tr>
                <td align="left" valign="top" width="291">
                    <h1>Number Format Specification</h1>
                </td>
            </tr>
        </table>
        

<p>Report Magic allows you to customize number formats in some places, 
most notably for localization. Wherever number formats are allowed, the
following discusses how they are applied.</p>

<p>The number format is made up of recognized symbols. Note that however 
these may be localized in your language, they should appear exactly as 
shown here. (e.g. "<code>.</code>" is a decimal point, even if it will 
be shown as "<code>,</code>" when localized for your language.)</p>

<dl>
<dt><code>#</code></dt>
<dd>Represents an optional digit. When placed right of the decimal point
means that zero or more digits (whatever exists in the number) will be 
written after the decimal point. No decimal point will be written if the 
number has no fractional portion.</dd>

<dt><code>0</code></dt>
<dd>Represents a single, required digit at the location in the format
string. To the right of the decimal, rounds or guarantees that the number
shows that many digits of it's fractional portion. To the left of the 
decimal point, padds the number with 0's as necessary.</dd>

<dt><code>.</code></dt>
<dd>Represents the location of the decimal point between the number
parts. This character will be localized to whatever character is used
in the locale to separate integral and fractional componenets of a number.</dd>

<dt><code>,</code></dt>
<dd>To the left of the decimal point (or end of the format, if no decimal point
is given) tells where to place a separator character in the integral portion 
of the number. For example, many languages split the integral portion into
thousands, using a separator: 1,234,556. This character will be localized to
whatever characters is used in the locale for this separation.</dd>

<dt><code>%</code><dt>
<dd>Specifies the location of the percent symbol in the format. This symbol will
be localized (where applicable). The number is not divided by 100. It is assumed
to already represent a percent quantity/</dd>

<dt><code>$</code><dt>
<dd>Specifies the location of the currency symbol in the format. This symbol will
be localized (where applicable). No conversion is done on the value, it is assumed
to already represent the value in the locale's currency.</dd>

</dl>


<p>The following examples may help to clarify the format specification:</p>
<table border="0" cellspacing="4">
<tr>
	<th>Input Value</th>
	<th>Format</th>
	<th>Output Value</th>
</tr>
<tr>
	<td>87.4</td>
	<td>#.#</td>
	<td>87.4</td>
</tr>
<tr>
	<td>87.4</td>
	<td>#</td>
	<td>87</td>
</tr>
<tr>
	<td>87.4</td>
	<td>#.#0</td>
	<td>87.40</td>
</tr>
<tr>
	<td>87.4</td>
	<td>#.#%</td>
	<td>87.4%</td>
</tr>
<tr>
	<td>87.4</td>
	<td>$#.#0</td>
	<td>$87.40</td>
</tr>
<tr>
	<td>1234.47</td>
	<td>#,###.#</td>
	<td>1,234.47</td>
</tr>
<tr>
	<td>1234.47</td>
	<td>#.0</td>
	<td>1234.5</td>
</tr>
</table>


 
        

        <div style="text-align: center; border-top: 2px solid black; border-bottom: 2px solid black; margin-top: 4px; margin-bottom: 6px; padding-top: 4px; padding-bottom:6px;">
            [<a href="index.html">Introduction</a>]&nbsp;[<a href="map.html">Documentation&nbsp;map</a>]&nbsp;[<a href="siteindex.html">Index</a>]&nbsp;[<a href="faq.html">Frequently Asked Questions</a>]&nbsp;[<a href="license.html">License</a>]
        </div>
        
        <span class="fineprint">Send questions or comments to <a href="mailto:dgsupport@wadsack-allen.com">Wadsack-Allen Digital Group Support</a>.<br />
         <a href="http://reportmagic.org/">Report Magic</a> 2.21 Documentation. Copyright &copy; 1999-2003 <a href="http://wadsack-allen.com/">Wadsack-Allen</a>. All Rights Reserved.</span>
    </body>
</html>
rmagic 2.21-5 / usr / share / doc / rmagic / html / numfmts.html
