<!-- This comment will put IE 6, 7 and 8 in quirks mode -->
<!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/xhtml;charset=UTF-8"/>
<title>ICU 4.4: NumberFormat Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javaScript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body onload='searchBox.OnSelectItem(0);'>
<!-- Generated by Doxygen 1.6.1 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li class="current"><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<img id="MSearchSelect" src="search/search.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</div>
</li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="classes.html"><span>Data Structure Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Data Fields</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>NumberFormat Class Reference</h1><!-- doxytag: class="NumberFormat" --><!-- doxytag: inherits="Format" -->
<p>Abstract base class for all number formats.
<a href="#_details">More...</a></p>
<p><code>#include <<a class="el" href="numfmt_8h_source.html">numfmt.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for NumberFormat:</div>
<div class="dynsection">
<div class="center">
<img src="classNumberFormat.gif" usemap="#NumberFormat_map" alt=""/>
<map id="NumberFormat_map" name="NumberFormat_map">
<area href="classFormat.html" alt="Format" shape="rect" coords="165,112,320,136"/>
<area href="classUObject.html" alt="UObject" shape="rect" coords="165,56,320,80"/>
<area href="classUMemory.html" alt="UMemory" shape="rect" coords="165,0,320,24"/>
<area href="classChoiceFormat.html" alt="ChoiceFormat" shape="rect" coords="0,224,155,248"/>
<area href="classDecimalFormat.html" alt="DecimalFormat" shape="rect" coords="165,224,320,248"/>
<area href="classRuleBasedNumberFormat.html" alt="RuleBasedNumberFormat" shape="rect" coords="330,224,485,248"/>
</map>
</div>
</div>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ad0cc3a5ee54a7520ea911a93bc1d2316">EStyles</a> { <br/>
<b>kNumberStyle</b>,
<b>kCurrencyStyle</b>,
<b>kPercentStyle</b>,
<b>kScientificStyle</b>,
<br/>
<b>kIsoCurrencyStyle</b>,
<b>kPluralCurrencyStyle</b>,
<b>kStyleCount</b>
<br/>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Constants for various number format styles. </p>
<a href="classNumberFormat.html#ad0cc3a5ee54a7520ea911a93bc1d2316">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#aac1d8bfe4ccd2cdf6fa1a933b2df75a1">EAlignmentFields</a> { <br/>
<b>kIntegerField</b>,
<b>kFractionField</b>,
<b>kDecimalSeparatorField</b>,
<b>kExponentSymbolField</b>,
<br/>
<b>kExponentSignField</b>,
<b>kExponentField</b>,
<b>kGroupingSeparatorField</b>,
<b>kCurrencyField</b>,
<br/>
<b>kPercentField</b>,
<b>kPermillField</b>,
<b>kSignField</b>,
<a class="el" href="classNumberFormat.html#aac1d8bfe4ccd2cdf6fa1a933b2df75a1a193401497626cb3ca7f4f9baabe1c123">INTEGER_FIELD</a> = kIntegerField,
<br/>
<b>FRACTION_FIELD</b> = kFractionField
<br/>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Alignment Field constants used to construct a <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields...">FieldPosition</a> object. </p>
<a href="classNumberFormat.html#aac1d8bfe4ccd2cdf6fa1a933b2df75a1">More...</a><br/></td></tr>
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ab9364f134c85197678bdb68352f2ee15">~NumberFormat</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#ab9364f134c85197678bdb68352f2ee15"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a97f4f81efd4747024deaf88ceb4d80a3">operator==</a> (const <a class="el" href="classFormat.html">Format</a> &other) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return true if the given <a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> objects are semantically equal. <a href="#a97f4f81efd4747024deaf88ceb4d80a3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a53e27d424735198566d90eb30401ec36">format</a> (const <a class="el" href="classFormattable.html">Formattable</a> &obj, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPosition.html">FieldPosition</a> &pos, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an object to produce a string. <a href="#a53e27d424735198566d90eb30401ec36"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a6a5fcafaeefe33a9c8326e3b6eb8aa55">format</a> (const <a class="el" href="classFormattable.html">Formattable</a> &obj, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> *posIter, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an object to produce a string. <a href="#a6a5fcafaeefe33a9c8326e3b6eb8aa55"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#aae2d85a1f97ae55faf249a4a0f429976">parseObject</a> (const <a class="el" href="classUnicodeString.html">UnicodeString</a> &source, <a class="el" href="classFormattable.html">Formattable</a> &result, <a class="el" href="classParsePosition.html">ParsePosition</a> &parse_pos) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parse a string to produce an object. <a href="#aae2d85a1f97ae55faf249a4a0f429976"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ad0d0bf658489e6a530a6c7716ef44320">format</a> (double number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a double number. <a href="#ad0d0bf658489e6a530a6c7716ef44320"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#aaa05c67fc637d9127756d854581a17fc">format</a> (int32_t number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a long number. <a href="#aaa05c67fc637d9127756d854581a17fc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#acfd48a8b10451ea0dd4fcc3cfb121b4b">format</a> (int64_t number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an int64 number. <a href="#acfd48a8b10451ea0dd4fcc3cfb121b4b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a7078d52baaa94ddf6e0680a4bc2f542a">format</a> (double number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPosition.html">FieldPosition</a> &pos) const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a double number. <a href="#a7078d52baaa94ddf6e0680a4bc2f542a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a2e24260eda61044d532a577f0f711e7a">format</a> (double number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> *posIter, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a double number. <a href="#a2e24260eda61044d532a577f0f711e7a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#acaaca11795df052b165e82261b7825f1">format</a> (int32_t number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPosition.html">FieldPosition</a> &pos) const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a long number. <a href="#acaaca11795df052b165e82261b7825f1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a917ebc57480c4244941f7750356e7596">format</a> (int32_t number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> *posIter, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an int32 number. <a href="#a917ebc57480c4244941f7750356e7596"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ac64ccd4841f822f601f2533e63e0592b">format</a> (int64_t number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPosition.html">FieldPosition</a> &pos) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an int64 number. <a href="#ac64ccd4841f822f601f2533e63e0592b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a1879e7057949f13eb626eafc4d184c1f">format</a> (int64_t number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> *posIter, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an int64 number. <a href="#a1879e7057949f13eb626eafc4d184c1f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a96cdaf515b3b3ea1d2fa685f97b4b53e">format</a> (const <a class="el" href="classStringPiece.html">StringPiece</a> &number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> *posIter, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a decimal number. <a href="#a96cdaf515b3b3ea1d2fa685f97b4b53e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a692963dfb668c207add70f31da4dd77e">format</a> (const DigitList &number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> *posIter, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a decimal number. <a href="#a692963dfb668c207add70f31da4dd77e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a3f66a13580f2e17ace127cd13956a2c7">format</a> (const DigitList &number, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="classFieldPosition.html">FieldPosition</a> &pos, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a decimal number. <a href="#a3f66a13580f2e17ace127cd13956a2c7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a67d754f52d336d911454e97ba32654de">format</a> (const <a class="el" href="classFormattable.html">Formattable</a> &obj, <a class="el" href="classUnicodeString.html">UnicodeString</a> &appendTo, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Redeclared <a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> method. <a href="#a67d754f52d336d911454e97ba32654de"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ab2c59c0b036a413b6735c6d50b88ae25">parse</a> (const <a class="el" href="classUnicodeString.html">UnicodeString</a> &text, <a class="el" href="classFormattable.html">Formattable</a> &result, <a class="el" href="classParsePosition.html">ParsePosition</a> &parsePosition) const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return a long if possible (e.g. <a href="#ab2c59c0b036a413b6735c6d50b88ae25"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a01ac6e0a7a47b2d8e387752d1a024b29">parse</a> (const <a class="el" href="classUnicodeString.html">UnicodeString</a> &text, <a class="el" href="classFormattable.html">Formattable</a> &result, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parse a string as a numeric value, and return a <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> numeric object. <a href="#a01ac6e0a7a47b2d8e387752d1a024b29"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classFormattable.html">Formattable</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a08bffcf90d1cc63882ab686b6b271f9b">parseCurrency</a> (const <a class="el" href="classUnicodeString.html">UnicodeString</a> &text, <a class="el" href="classFormattable.html">Formattable</a> &result, <a class="el" href="classParsePosition.html">ParsePosition</a> &pos) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parses text from the given string as a currency amount. <a href="#a08bffcf90d1cc63882ab686b6b271f9b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a680f60d204c0d00bb06f65d7c3ea716a">isParseIntegerOnly</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return true if this format will parse numbers as integers only. <a href="#a680f60d204c0d00bb06f65d7c3ea716a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ac9b8eb834f6d18a61661cff71b954e52">setParseIntegerOnly</a> (<a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> value)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets whether or not numbers should be parsed as integers only. <a href="#ac9b8eb834f6d18a61661cff71b954e52"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a6fe9bf9d863b9c85ba8f61699e2bbd5b">isGroupingUsed</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if grouping is used in this format. <a href="#a6fe9bf9d863b9c85ba8f61699e2bbd5b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a42f1ff1c899ec393a87ef24cfdfdd0a1">setGroupingUsed</a> (<a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> newValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set whether or not grouping will be used in this format. <a href="#a42f1ff1c899ec393a87ef24cfdfdd0a1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a1b06a7feabb695be2e5f16a60a377cf3">getMaximumIntegerDigits</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the maximum number of digits allowed in the integer portion of a number. <a href="#a1b06a7feabb695be2e5f16a60a377cf3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a561c13b71c338e6b68729c786d2a3a09">setMaximumIntegerDigits</a> (int32_t newValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the maximum number of digits allowed in the integer portion of a number. <a href="#a561c13b71c338e6b68729c786d2a3a09"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#aa821c67615bf12bf1e8f1157108f6ad0">getMinimumIntegerDigits</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the minimum number of digits allowed in the integer portion of a number. <a href="#aa821c67615bf12bf1e8f1157108f6ad0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a92a1454c564b66707d0145a123f65cf3">setMinimumIntegerDigits</a> (int32_t newValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the minimum number of digits allowed in the integer portion of a number. <a href="#a92a1454c564b66707d0145a123f65cf3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ae2d2e103f14b46234f6dc90125c98eb1">getMaximumFractionDigits</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the maximum number of digits allowed in the fraction portion of a number. <a href="#ae2d2e103f14b46234f6dc90125c98eb1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#abb97d22c2d628aab87d695c6f66e8dbb">setMaximumFractionDigits</a> (int32_t newValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the maximum number of digits allowed in the fraction portion of a number. <a href="#abb97d22c2d628aab87d695c6f66e8dbb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a11eb09d7b8f01e40766898f4614598a2">getMinimumFractionDigits</a> (void) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the minimum number of digits allowed in the fraction portion of a number. <a href="#a11eb09d7b8f01e40766898f4614598a2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a454c39db13cb0dde930e9249ee726db5">setMinimumFractionDigits</a> (int32_t newValue)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the minimum number of digits allowed in the fraction portion of a number. <a href="#a454c39db13cb0dde930e9249ee726db5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a1dbc762d377858e70de924aacc59d113">setCurrency</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *theCurrency, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &ec)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the currency used to display currency amounts. <a href="#a1dbc762d377858e70de924aacc59d113"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#acc485325edc696f35f73cbdad75eed59">getCurrency</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the currency used to display currency amounts. <a href="#acc485325edc696f35f73cbdad75eed59"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="utypes_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a63c193a4db6a1552073bf069d5d31749">getDynamicClassID</a> (void) const =0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a unique class ID POLYMORPHICALLY. <a href="#a63c193a4db6a1552073bf069d5d31749"></a><br/></td></tr>
<tr><td colspan="2"><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a2483fa1e87f3600395ff0c8f364f7b6f">createInstance</a> (<a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the default number format for the current default locale. <a href="#a2483fa1e87f3600395ff0c8f364f7b6f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a3aa6fc5e68d9d646998dbf8c91b939e2">createInstance</a> (const <a class="el" href="classLocale.html">Locale</a> &inLocale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the default number format for the specified locale. <a href="#a3aa6fc5e68d9d646998dbf8c91b939e2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a1ff932f61eb4814182bf7f76daec125c">createInstance</a> (const <a class="el" href="classLocale.html">Locale</a> &desiredLocale, <a class="el" href="classNumberFormat.html#ad0cc3a5ee54a7520ea911a93bc1d2316">EStyles</a> choice, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &success)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates the specified decimal format style of the desired locale. <a href="#a1ff932f61eb4814182bf7f76daec125c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a0c5d7b55f149281ed063e6bf631e1433">createCurrencyInstance</a> (<a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a currency format for the current default locale. <a href="#a0c5d7b55f149281ed063e6bf631e1433"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#aafc5e5013c7ff22c53195bc30e63b845">createCurrencyInstance</a> (const <a class="el" href="classLocale.html">Locale</a> &inLocale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a currency format for the specified locale. <a href="#aafc5e5013c7ff22c53195bc30e63b845"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a033f486287d03fc07ccf422992a3e894">createPercentInstance</a> (<a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a percentage format for the current default locale. <a href="#a033f486287d03fc07ccf422992a3e894"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ac0b6f6d8fc351a0aad06910dfe043f91">createPercentInstance</a> (const <a class="el" href="classLocale.html">Locale</a> &inLocale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a percentage format for the specified locale. <a href="#ac0b6f6d8fc351a0aad06910dfe043f91"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#aed63bba10230ae92fc98f50031eadf75">createScientificInstance</a> (<a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a scientific format for the current default locale. <a href="#aed63bba10230ae92fc98f50031eadf75"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classNumberFormat.html">NumberFormat</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#aa26a23ba85c6dac9b8f429d1fe7d695f">createScientificInstance</a> (const <a class="el" href="classLocale.html">Locale</a> &inLocale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a scientific format for the specified locale. <a href="#aa26a23ba85c6dac9b8f429d1fe7d695f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static const <a class="el" href="classLocale.html">Locale</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a8f18e4922ee902adabdd355311fd11ae">getAvailableLocales</a> (int32_t &count)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the set of Locales for which NumberFormats are installed. <a href="#a8f18e4922ee902adabdd355311fd11ae"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="umisc_8h.html#ab5905d79ed3b979840cee1d5fd48b4fb">URegistryKey</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a83e8d5a07d0b2c1444c051ab442e6c3e">registerFactory</a> (<a class="el" href="classNumberFormatFactory.html">NumberFormatFactory</a> *toAdopt, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Register a new <a class="el" href="classNumberFormatFactory.html" title="A NumberFormatFactory is used to register new number formats.">NumberFormatFactory</a>. <a href="#a83e8d5a07d0b2c1444c051ab442e6c3e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ab6ecd9973fd855a9028af8cadbf0a4c3">unregister</a> (<a class="el" href="umisc_8h.html#ab5905d79ed3b979840cee1d5fd48b4fb">URegistryKey</a> key, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &status)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Unregister a previously-registered <a class="el" href="classNumberFormatFactory.html" title="A NumberFormatFactory is used to register new number formats.">NumberFormatFactory</a> using the key returned from the register call. <a href="#ab6ecd9973fd855a9028af8cadbf0a4c3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classStringEnumeration.html">StringEnumeration</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a29addeb994249b22539ef1659d4017c7">getAvailableLocales</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return a <a class="el" href="classStringEnumeration.html" title="Base class for 'pure' C++ implementations of uenum api.">StringEnumeration</a> over the locales available at the time of the call, including registered locales. <a href="#a29addeb994249b22539ef1659d4017c7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="utypes_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#acfeb8972959e9383b026761d0e9e1e5e">getStaticClassID</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the class ID for this class. <a href="#acfeb8972959e9383b026761d0e9e1e5e"></a><br/></td></tr>
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a456d960b53c9f61acbf443f5fd56e7dc">NumberFormat</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Default constructor for subclass use only. <a href="#a456d960b53c9f61acbf443f5fd56e7dc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#aabbf4f0a039756b6ba100aadc7cede99">NumberFormat</a> (const <a class="el" href="classNumberFormat.html">NumberFormat</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy constructor. <a href="#aabbf4f0a039756b6ba100aadc7cede99"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classNumberFormat.html">NumberFormat</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#a8b9d5c0937f4da69d9a229fd10f8ec38">operator=</a> (const <a class="el" href="classNumberFormat.html">NumberFormat</a> &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Assignment operator. <a href="#a8b9d5c0937f4da69d9a229fd10f8ec38"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classNumberFormat.html#ae79eb815aa14fa432eec4307a3e2bc28">getEffectiveCurrency</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *result, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &ec) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the currency in effect for this formatter. <a href="#ae79eb815aa14fa432eec4307a3e2bc28"></a><br/></td></tr>
<tr><td colspan="2"><h2>Friends</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a38693e4c03f052ff23a839c69f3b4dee"></a><!-- doxytag: member="NumberFormat::ICUNumberFormatFactory" ref="a38693e4c03f052ff23a839c69f3b4dee" args="" -->
class </td><td class="memItemRight" valign="bottom"><b>ICUNumberFormatFactory</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a5e0c68fe83aa739ffb329bb90ba5ebd3"></a><!-- doxytag: member="NumberFormat::ICUNumberFormatService" ref="a5e0c68fe83aa739ffb329bb90ba5ebd3" args="" -->
class </td><td class="memItemRight" valign="bottom"><b>ICUNumberFormatService</b></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Abstract base class for all number formats. </p>
<p>Provides interface for formatting and parsing a number. Also provides methods for determining which locales have number formats, and what their names are. </p>
<p><a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> helps you to format and parse numbers for any locale. Your code can be completely independent of the locale conventions for decimal points, thousands-separators, or even the particular decimal digits used, or whether the number format is even decimal. </p>
<p>To format a number for the current <a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region...">Locale</a>, use one of the static factory methods: </p>
<pre>
<div class="fragment"><pre class="fragment"> <span class="keywordtype">double</span> myNumber = 7.0;
<a class="code" href="classUnicodeString.html" title="UnicodeString is a string class that stores Unicode characters directly and provides...">UnicodeString</a> myString;
<a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c" title="Error code to replace exception handling, so that the code is compatible with all...">UErrorCode</a> success = <a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78caa43dbfc9499c5f911d04e1a0ca3bf6f9" title="No error, no warning.">U_ZERO_ERROR</a>;
<a class="code" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a>* nf = <a class="code" href="classNumberFormat.html#a2483fa1e87f3600395ff0c8f364f7b6f" title="Returns the default number format for the current default locale.">NumberFormat::createInstance</a>(success)
nf-><a class="code" href="classNumberFormat.html#a53e27d424735198566d90eb30401ec36" title="Format an object to produce a string.">format</a>(myNumber, myString);
cout << " Example 1: " << myString << endl;
</pre></div>
</pre><p> If you are formatting multiple numbers, it is more efficient to get the format and use it multiple times so that the system doesn't have to fetch the information about the local language and country conventions multiple times. </p>
<pre>
<div class="fragment"><pre class="fragment"> <a class="code" href="classUnicodeString.html" title="UnicodeString is a string class that stores Unicode characters directly and provides...">UnicodeString</a> myString;
<a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c" title="Error code to replace exception handling, so that the code is compatible with all...">UErrorCode</a> success = <a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78caa43dbfc9499c5f911d04e1a0ca3bf6f9" title="No error, no warning.">U_ZERO_ERROR</a>;
nf = <a class="code" href="classNumberFormat.html#a2483fa1e87f3600395ff0c8f364f7b6f" title="Returns the default number format for the current default locale.">NumberFormat::createInstance</a>( success );
int32_t a[] = { 123, 3333, -1234567 };
<span class="keyword">const</span> int32_t a_len = <span class="keyword">sizeof</span>(a) / <span class="keyword">sizeof</span>(a[0]);
myString.<a class="code" href="classUnicodeString.html#aee0fec9568ee616e330627bf371eda8d" title="Remove all characters from the UnicodeString object.">remove</a>();
<span class="keywordflow">for</span> (int32_t i = 0; i < a_len; i++) {
nf-><a class="code" href="classNumberFormat.html#a53e27d424735198566d90eb30401ec36" title="Format an object to produce a string.">format</a>(a[i], myString);
myString += <span class="stringliteral">" ; "</span>;
}
cout << <span class="stringliteral">" Example 2: "</span> << myString << endl;
</pre></div>
</pre><p> To format a number for a different <a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region...">Locale</a>, specify it in the call to <a class="el" href="classNumberFormat.html#a2483fa1e87f3600395ff0c8f364f7b6f" title="Returns the default number format for the current default locale.">createInstance()</a>. </p>
<pre>
<div class="fragment"><pre class="fragment"> nf = <a class="code" href="classNumberFormat.html#a2483fa1e87f3600395ff0c8f364f7b6f" title="Returns the default number format for the current default locale.">NumberFormat::createInstance</a>( Locale::FRENCH, success );
</pre></div>
</pre><p> You can use a <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> to parse also. </p>
<pre>
<div class="fragment"><pre class="fragment"> <a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c" title="Error code to replace exception handling, so that the code is compatible with all...">UErrorCode</a> success;
<a class="code" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> result(-999); <span class="comment">// initialized with error code</span>
nf-><a class="code" href="classNumberFormat.html#ab2c59c0b036a413b6735c6d50b88ae25" title="Return a long if possible (e.g.">parse</a>(myString, result, success);
</pre></div>
</pre><p> Use createInstance to get the normal number format for that country. There are other static factory methods available. Use getCurrency to get the currency number format for that country. Use getPercent to get a format for displaying percentages. With this format, a fraction from 0.53 is displayed as 53%. </p>
<p>Starting from ICU 4.2, you can use <a class="el" href="classNumberFormat.html#a2483fa1e87f3600395ff0c8f364f7b6f" title="Returns the default number format for the current default locale.">createInstance()</a> by passing in a 'style' as parameter to get the correct instance. For example, use createInstance(...kNumberStyle...) to get the normal number format, createInstance(...kPercentStyle...) to get a format for displaying percentage, createInstance(...kScientificStyle...) to get a format for displaying scientific number, createInstance(...kCurrencyStyle...) to get the currency number format, in which the currency is represented by its symbol, for example, "$3.00". createInstance(...kIsoCurrencyStyle...) to get the currency number format, in which the currency is represented by its ISO code, for example "USD3.00". createInstance(...kPluralCurrencyStyle...) to get the currency number format, in which the currency is represented by its full name in plural format, for example, "3.00 US dollars" or "1.00 US dollar". </p>
<p>You can also control the display of numbers with such methods as getMinimumFractionDigits. If you want even more control over the format or parsing, or want to give your users more control, you can try casting the <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> you get from the factory methods to a DecimalNumberFormat. This will work for the vast majority of countries; just remember to put it in a try block in case you encounter an unusual one. </p>
<p>You can also use forms of the parse and format methods with <a class="el" href="classParsePosition.html" title="ParsePosition is a simple class used by Format and its subclasses to keep track of...">ParsePosition</a> and <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields...">FieldPosition</a> to allow you to: </p>
<ul type="round">
<li>
(a) progressively parse through pieces of a string. </li>
<li>
(b) align the decimal point and other areas. </li>
</ul>
<p>For example, you can align numbers in two ways. </p>
<p>If you are using a monospaced font with spacing for alignment, you can pass the <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields...">FieldPosition</a> in your format call, with field = INTEGER_FIELD. On output, getEndIndex will be set to the offset between the last character of the integer and the decimal. Add (desiredSpaceCount - getEndIndex) spaces at the front of the string. </p>
<p>If you are using proportional fonts, instead of padding with spaces, measure the width of the string in pixels from the start to getEndIndex. Then move the pen by (desiredPixelWidth - widthToAlignmentPoint) before drawing the text. It also works where there is no decimal, but possibly additional characters at the end, e.g. with parentheses in negative numbers: "(12)" for -12. </p>
<p><em>User subclasses are not supported.</em> While clients may write subclasses, such code will not necessarily work and will not be guaranteed to work stably from release to release.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002795">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="numfmt_8h_source.html#l00163">163</a> of file <a class="el" href="numfmt_8h_source.html">numfmt.h</a>.</p>
<hr/><h2>Member Enumeration Documentation</h2>
<a class="anchor" id="aac1d8bfe4ccd2cdf6fa1a933b2df75a1"></a><!-- doxytag: member="NumberFormat::EAlignmentFields" ref="aac1d8bfe4ccd2cdf6fa1a933b2df75a1" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classNumberFormat.html#aac1d8bfe4ccd2cdf6fa1a933b2df75a1">NumberFormat::EAlignmentFields</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Alignment Field constants used to construct a <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields...">FieldPosition</a> object. </p>
<p>Signifies that the position of the integer part or fraction part of a formatted number should be returned.</p>
<p>Note: as of ICU 4.4, the values in this enum have been extended to support identification of all number format fields, not just those pertaining to alignment.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields...">FieldPosition</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002798">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="aac1d8bfe4ccd2cdf6fa1a933b2df75a1a193401497626cb3ca7f4f9baabe1c123"></a><!-- doxytag: member="INTEGER_FIELD" ref="aac1d8bfe4ccd2cdf6fa1a933b2df75a1a193401497626cb3ca7f4f9baabe1c123" args="" -->INTEGER_FIELD</em> </td><td>
<p>These constants are provided for backwards compatibility only. </p>
<p>Please use the C++ style constants defined above. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002843">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="numfmt_8h_source.html#l00201">201</a> of file <a class="el" href="numfmt_8h_source.html">numfmt.h</a>.</p>
</div>
</div>
<a class="anchor" id="ad0cc3a5ee54a7520ea911a93bc1d2316"></a><!-- doxytag: member="NumberFormat::EStyles" ref="ad0cc3a5ee54a7520ea911a93bc1d2316" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classNumberFormat.html#ad0cc3a5ee54a7520ea911a93bc1d2316">NumberFormat::EStyles</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Constants for various number format styles. </p>
<p>kNumberStyle specifies a normal number style of format. kCurrencyStyle specifies a currency format using currency symbol name, such as in "$1.00". kPercentStyle specifies a style of format to display percent. kScientificStyle specifies a style of format to display scientific number. kISOCurrencyStyle specifies a currency format using ISO currency code, such as in "USD1.00". kPluralCurrencyStyle specifies a currency format using currency plural names, such as in "1.00 US dollar" and "3.00 US dollars". </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000175">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.2 </dd></dl>
<p>Definition at line <a class="el" href="numfmt_8h_source.html#l00179">179</a> of file <a class="el" href="numfmt_8h_source.html">numfmt.h</a>.</p>
</div>
</div>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="ab9364f134c85197678bdb68352f2ee15"></a><!-- doxytag: member="NumberFormat::~NumberFormat" ref="ab9364f134c85197678bdb68352f2ee15" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual NumberFormat::~NumberFormat </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destructor. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002799">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a456d960b53c9f61acbf443f5fd56e7dc"></a><!-- doxytag: member="NumberFormat::NumberFormat" ref="a456d960b53c9f61acbf443f5fd56e7dc" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">NumberFormat::NumberFormat </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Default constructor for subclass use only. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002840">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aabbf4f0a039756b6ba100aadc7cede99"></a><!-- doxytag: member="NumberFormat::NumberFormat" ref="aabbf4f0a039756b6ba100aadc7cede99" args="(const NumberFormat &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">NumberFormat::NumberFormat </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classNumberFormat.html">NumberFormat</a> & </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Copy constructor. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002841">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="aafc5e5013c7ff22c53195bc30e63b845"></a><!-- doxytag: member="NumberFormat::createCurrencyInstance" ref="aafc5e5013c7ff22c53195bc30e63b845" args="(const Locale &inLocale, UErrorCode &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createCurrencyInstance </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classLocale.html">Locale</a> & </td>
<td class="paramname"> <em>inLocale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a currency format for the specified locale. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>inLocale</em> </td><td>the given locale. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002817">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a0c5d7b55f149281ed063e6bf631e1433"></a><!-- doxytag: member="NumberFormat::createCurrencyInstance" ref="a0c5d7b55f149281ed063e6bf631e1433" args="(UErrorCode &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createCurrencyInstance </td>
<td>(</td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a currency format for the current default locale. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002816">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a1ff932f61eb4814182bf7f76daec125c"></a><!-- doxytag: member="NumberFormat::createInstance" ref="a1ff932f61eb4814182bf7f76daec125c" args="(const Locale &desiredLocale, EStyles choice, UErrorCode &success)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createInstance </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classLocale.html">Locale</a> & </td>
<td class="paramname"> <em>desiredLocale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classNumberFormat.html#ad0cc3a5ee54a7520ea911a93bc1d2316">EStyles</a> </td>
<td class="paramname"> <em>choice</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>success</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates the specified decimal format style of the desired locale. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>desiredLocale</em> </td><td>the given locale. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>choice</em> </td><td>the given style. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>success</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> instance. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000181">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.2 </dd></dl>
</div>
</div>
<a class="anchor" id="a3aa6fc5e68d9d646998dbf8c91b939e2"></a><!-- doxytag: member="NumberFormat::createInstance" ref="a3aa6fc5e68d9d646998dbf8c91b939e2" args="(const Locale &inLocale, UErrorCode &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createInstance </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classLocale.html">Locale</a> & </td>
<td class="paramname"> <em>inLocale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the default number format for the specified locale. </p>
<p>The default format is one of the styles provided by the other factory methods: getNumberInstance, getCurrencyInstance or getPercentInstance. Exactly which one is locale dependant. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>inLocale</em> </td><td>the given locale. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002815">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a2483fa1e87f3600395ff0c8f364f7b6f"></a><!-- doxytag: member="NumberFormat::createInstance" ref="a2483fa1e87f3600395ff0c8f364f7b6f" args="(UErrorCode &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createInstance </td>
<td>(</td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the default number format for the current default locale. </p>
<p>The default format is one of the styles provided by the other factory methods: getNumberInstance, getCurrencyInstance or getPercentInstance. Exactly which one is locale dependant. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002814">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ac0b6f6d8fc351a0aad06910dfe043f91"></a><!-- doxytag: member="NumberFormat::createPercentInstance" ref="ac0b6f6d8fc351a0aad06910dfe043f91" args="(const Locale &inLocale, UErrorCode &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createPercentInstance </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classLocale.html">Locale</a> & </td>
<td class="paramname"> <em>inLocale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a percentage format for the specified locale. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>inLocale</em> </td><td>the given locale. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002819">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a033f486287d03fc07ccf422992a3e894"></a><!-- doxytag: member="NumberFormat::createPercentInstance" ref="a033f486287d03fc07ccf422992a3e894" args="(UErrorCode &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createPercentInstance </td>
<td>(</td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a percentage format for the current default locale. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002818">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aa26a23ba85c6dac9b8f429d1fe7d695f"></a><!-- doxytag: member="NumberFormat::createScientificInstance" ref="aa26a23ba85c6dac9b8f429d1fe7d695f" args="(const Locale &inLocale, UErrorCode &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createScientificInstance </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classLocale.html">Locale</a> & </td>
<td class="paramname"> <em>inLocale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a scientific format for the specified locale. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>inLocale</em> </td><td>the given locale. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002821">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aed63bba10230ae92fc98f50031eadf75"></a><!-- doxytag: member="NumberFormat::createScientificInstance" ref="aed63bba10230ae92fc98f50031eadf75" args="(UErrorCode &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classNumberFormat.html">NumberFormat</a>* NumberFormat::createScientificInstance </td>
<td>(</td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a scientific format for the current default locale. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002820">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a67d754f52d336d911454e97ba32654de"></a><!-- doxytag: member="NumberFormat::format" ref="a67d754f52d336d911454e97ba32654de" args="(const Formattable &obj, UnicodeString &appendTo, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classUnicodeString.html">UnicodeString</a> & NumberFormat::format </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFormattable.html">Formattable</a> & </td>
<td class="paramname"> <em>obj</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Redeclared <a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> method. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>obj</em> </td><td>The object to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output parameter set to a failure error code when a failure occurs. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002809">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented from <a class="el" href="classFormat.html#af3f0b157f07d6e9f908da69c99239600">Format</a>.</p>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#a1df3b8b4b32453583e6cef2aa74c5d97">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#aaf9c44cbcc2b7f0279dcc6f121b8bf13">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#ae97cffb5bc4fca4e5f7d89b41a333983">RuleBasedNumberFormat</a>.</p>
<p>Definition at line <a class="el" href="numfmt_8h_source.html#l01040">1040</a> of file <a class="el" href="numfmt_8h_source.html">numfmt.h</a>.</p>
<p>References <a class="el" href="classNumberFormat.html#a53e27d424735198566d90eb30401ec36">format()</a>.</p>
</div>
</div>
<a class="anchor" id="a3f66a13580f2e17ace127cd13956a2c7"></a><!-- doxytag: member="NumberFormat::format" ref="a3f66a13580f2e17ace127cd13956a2c7" args="(const DigitList &number, UnicodeString &appendTo, FieldPosition &pos, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">const DigitList & </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"> <em>pos</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a decimal number. </p>
<p>The number is a DigitList wrapper onto a floating point decimal number. The default implementation in <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> converts the decimal number to a double and formats that. Subclasses of <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> that want to specifically handle big decimal numbers must override this method. class <a class="el" href="classDecimalFormat.html" title="DecimalFormat is a concrete subclass of NumberFormat that formats decimal numbers...">DecimalFormat</a> does so.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The number, a DigitList format Decimal Floating Point. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pos</em> </td><td>On input: an alignment field, if desired. On output: the offsets of the alignment field. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000323">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a1afb44274993754d2099fe78f24c95c5">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a692963dfb668c207add70f31da4dd77e"></a><!-- doxytag: member="NumberFormat::format" ref="a692963dfb668c207add70f31da4dd77e" args="(const DigitList &number, UnicodeString &appendTo, FieldPositionIterator *posIter, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">const DigitList & </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> * </td>
<td class="paramname"> <em>posIter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a decimal number. </p>
<p>The number is a DigitList wrapper onto a floating point decimal number. The default implementation in <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> converts the decimal number to a double and formats that. Subclasses of <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> that want to specifically handle big decimal numbers must override this method. class <a class="el" href="classDecimalFormat.html" title="DecimalFormat is a concrete subclass of NumberFormat that formats decimal numbers...">DecimalFormat</a> does so.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The number, a DigitList format Decimal Floating Point. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>posIter</em> </td><td>On return, can be used to iterate over positions of fields generated by this format call. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000322">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#af1eef78b146ce1ee5ee6c8c580e602ca">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a96cdaf515b3b3ea1d2fa685f97b4b53e"></a><!-- doxytag: member="NumberFormat::format" ref="a96cdaf515b3b3ea1d2fa685f97b4b53e" args="(const StringPiece &number, UnicodeString &appendTo, FieldPositionIterator *posIter, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classStringPiece.html">StringPiece</a> & </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> * </td>
<td class="paramname"> <em>posIter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a decimal number. </p>
<p>Subclasses must implement this method. The syntax of the unformatted number is a "numeric string" as defined in the Decimal Arithmetic Specification, available at <a href="http://speleotrove.com/decimal">http://speleotrove.com/decimal</a></p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The unformatted number, as a string, to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>posIter</em> </td><td>On return, can be used to iterate over positions of fields generated by this format call. Can be NULL. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000180">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 4.4 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a92b6cd5af73a8183eb3a3322db4a2c61">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a1879e7057949f13eb626eafc4d184c1f"></a><!-- doxytag: member="NumberFormat::format" ref="a1879e7057949f13eb626eafc4d184c1f" args="(int64_t number, UnicodeString &appendTo, FieldPositionIterator *posIter, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">int64_t </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> * </td>
<td class="paramname"> <em>posIter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an int64 number. </p>
<p>Subclasses must implement this method.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>posIter</em> </td><td>On return, can be used to iterate over positions of fields generated by this format call. Can be NULL. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000179">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 4.4 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a12d61d1634942c8fd8dbc99e379eac64">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="ac64ccd4841f822f601f2533e63e0592b"></a><!-- doxytag: member="NumberFormat::format" ref="ac64ccd4841f822f601f2533e63e0592b" args="(int64_t number, UnicodeString &appendTo, FieldPosition &pos) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">int64_t </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"> <em>pos</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an int64 number. </p>
<p>(Not abstract to retain compatibility with earlier releases, however subclasses should override this method as it just delegates to format(int32_t number...);</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pos</em> </td><td>On input: an alignment field, if desired. On output: the offsets of the alignment field. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002808">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#a066409675f3c1ec30237668f7e3a80f0">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#a4239fefb073af94327ccdac88bb5bf3e">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#adf7cb11d07aac568236df549488e0b03">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a917ebc57480c4244941f7750356e7596"></a><!-- doxytag: member="NumberFormat::format" ref="a917ebc57480c4244941f7750356e7596" args="(int32_t number, UnicodeString &appendTo, FieldPositionIterator *posIter, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> * </td>
<td class="paramname"> <em>posIter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an int32 number. </p>
<p>Subclasses must implement this method.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>posIter</em> </td><td>On return, can be used to iterate over positions of fields generated by this format call. Can be NULL. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000178">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 4.4 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a78ad4a93bb4af259f0909b5f4c207312">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="acaaca11795df052b165e82261b7825f1"></a><!-- doxytag: member="NumberFormat::format" ref="acaaca11795df052b165e82261b7825f1" args="(int32_t number, UnicodeString &appendTo, FieldPosition &pos) const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"> <em>pos</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a long number. </p>
<p>Concrete subclasses must implement these pure virtual methods.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pos</em> </td><td>On input: an alignment field, if desired. On output: the offsets of the alignment field. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002807">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Implemented in <a class="el" href="classChoiceFormat.html#a4c31ee3278dc0afb02e83127d4677161">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#aa2bab620a29369c545e85d544d73ad05">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#ad18c54375913d2426aae02a4328c3187">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a2e24260eda61044d532a577f0f711e7a"></a><!-- doxytag: member="NumberFormat::format" ref="a2e24260eda61044d532a577f0f711e7a" args="(double number, UnicodeString &appendTo, FieldPositionIterator *posIter, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">double </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> * </td>
<td class="paramname"> <em>posIter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a double number. </p>
<p>Subclasses must implement this method.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>posIter</em> </td><td>On return, can be used to iterate over positions of fields generated by this format call. Can be NULL. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000177">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 4.4 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a15bb0a7e2c377a4bc0a3d786694f30d9">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a7078d52baaa94ddf6e0680a4bc2f542a"></a><!-- doxytag: member="NumberFormat::format" ref="a7078d52baaa94ddf6e0680a4bc2f542a" args="(double number, UnicodeString &appendTo, FieldPosition &pos) const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">double </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"> <em>pos</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a double number. </p>
<p>Concrete subclasses must implement these pure virtual methods.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pos</em> </td><td>On input: an alignment field, if desired. On output: the offsets of the alignment field. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002806">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Implemented in <a class="el" href="classChoiceFormat.html#a3488103b67c452ace7cac7f6da452e72">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#aed19f9279def60133b3122a2435ea568">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#a246ec02e8f3d84efc98f449f84ace6ab">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="acfd48a8b10451ea0dd4fcc3cfb121b4b"></a><!-- doxytag: member="NumberFormat::format" ref="acfd48a8b10451ea0dd4fcc3cfb121b4b" args="(int64_t number, UnicodeString &appendTo) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">int64_t </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an int64 number. </p>
<p>These methods call the <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> pure virtual <a class="el" href="classNumberFormat.html#a53e27d424735198566d90eb30401ec36" title="Format an object to produce a string.">format()</a> methods with the default <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields...">FieldPosition</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002805">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a7bd1ea414645fcce54268b47d38c84ae">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="aaa05c67fc637d9127756d854581a17fc"></a><!-- doxytag: member="NumberFormat::format" ref="aaa05c67fc637d9127756d854581a17fc" args="(int32_t number, UnicodeString &appendTo) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a long number. </p>
<p>These methods call the <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> pure virtual <a class="el" href="classNumberFormat.html#a53e27d424735198566d90eb30401ec36" title="Format an object to produce a string.">format()</a> methods with the default <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields...">FieldPosition</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002804">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#a5c48a05a17d3f3e33bd18d1674c90c66">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#a353940a76151b71b954fcfb37a0f9611">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#a920e08de6b0aca3f83b1e6c35dff9ad9">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="ad0d0bf658489e6a530a6c7716ef44320"></a><!-- doxytag: member="NumberFormat::format" ref="ad0d0bf658489e6a530a6c7716ef44320" args="(double number, UnicodeString &appendTo) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">double </td>
<td class="paramname"> <em>number</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> a double number. </p>
<p>These methods call the <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> pure virtual <a class="el" href="classNumberFormat.html#a53e27d424735198566d90eb30401ec36" title="Format an object to produce a string.">format()</a> methods with the default <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields...">FieldPosition</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>number</em> </td><td>The value to be formatted. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002803">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#af4a83c08f52e73d89efa3ae68b938e0d">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#ac5b6d7339b4ea565dee15147cd29df09">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#afe15fa9d2566bb4339e105f59f64f974">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a6a5fcafaeefe33a9c8326e3b6eb8aa55"></a><!-- doxytag: member="NumberFormat::format" ref="a6a5fcafaeefe33a9c8326e3b6eb8aa55" args="(const Formattable &obj, UnicodeString &appendTo, FieldPositionIterator *posIter, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFormattable.html">Formattable</a> & </td>
<td class="paramname"> <em>obj</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPositionIterator.html">FieldPositionIterator</a> * </td>
<td class="paramname"> <em>posIter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an object to produce a string. </p>
<p>This method handles <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> objects with numeric types. If the <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> object type is not a numeric type, then it returns a failing UErrorCode.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>obj</em> </td><td>The object to format. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>posIter</em> </td><td>On return, can be used to iterate over positions of fields generated by this format call. Can be NULL. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000176">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 4.4 </dd></dl>
<p>Reimplemented from <a class="el" href="classFormat.html#a820c1ea5bf5fd4f65de463a74ddf113e">Format</a>.</p>
</div>
</div>
<a class="anchor" id="a53e27d424735198566d90eb30401ec36"></a><!-- doxytag: member="NumberFormat::format" ref="a53e27d424735198566d90eb30401ec36" args="(const Formattable &obj, UnicodeString &appendTo, FieldPosition &pos, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classUnicodeString.html">UnicodeString</a>& NumberFormat::format </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFormattable.html">Formattable</a> & </td>
<td class="paramname"> <em>obj</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>appendTo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"> <em>pos</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> an object to produce a string. </p>
<p>This method handles <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> objects with numeric types. If the <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> object type is not a numeric type, then it returns a failing UErrorCode.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>obj</em> </td><td>The object to format. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>appendTo</em> </td><td>Output parameter to receive result. Result is appended to existing contents. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pos</em> </td><td>On input: an alignment field, if desired. On output: the offsets of the alignment field. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output param filled with success/failure status. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Reference to 'appendTo' parameter. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002801">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Implements <a class="el" href="classFormat.html#a12ffb857c5c9a553270dfe9a71fbd8e9">Format</a>.</p>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#a4282d9e61550d4abb84d5c6f1ce29f6f">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#a9cd8dc27d2e975c453b12e123225da17">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#a640cf2259d20cc8f03736f6fe0d18d1b">RuleBasedNumberFormat</a>.</p>
<p>Referenced by <a class="el" href="numfmt_8h_source.html#l01040">format()</a>.</p>
</div>
</div>
<a class="anchor" id="a29addeb994249b22539ef1659d4017c7"></a><!-- doxytag: member="NumberFormat::getAvailableLocales" ref="a29addeb994249b22539ef1659d4017c7" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classStringEnumeration.html">StringEnumeration</a>* NumberFormat::getAvailableLocales </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return a <a class="el" href="classStringEnumeration.html" title="Base class for 'pure' C++ implementations of uenum api.">StringEnumeration</a> over the locales available at the time of the call, including registered locales. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>a <a class="el" href="classStringEnumeration.html" title="Base class for 'pure' C++ implementations of uenum api.">StringEnumeration</a> over the locales available at the time of the call </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002825">Stable:</a></b></dt><dd>ICU 2.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a8f18e4922ee902adabdd355311fd11ae"></a><!-- doxytag: member="NumberFormat::getAvailableLocales" ref="a8f18e4922ee902adabdd355311fd11ae" args="(int32_t &count)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static const <a class="el" href="classLocale.html">Locale</a>* NumberFormat::getAvailableLocales </td>
<td>(</td>
<td class="paramtype">int32_t & </td>
<td class="paramname"> <em>count</em></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the set of Locales for which NumberFormats are installed. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>Output param to receive the size of the locales </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002822">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="acc485325edc696f35f73cbdad75eed59"></a><!-- doxytag: member="NumberFormat::getCurrency" ref="acc485325edc696f35f73cbdad75eed59" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* NumberFormat::getCurrency </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the currency used to display currency amounts. </p>
<p>This may be an empty string for some subclasses. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>a 3-letter null-terminated ISO code indicating the currency in use, or a pointer to the empty string. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002837">Stable:</a></b></dt><dd>ICU 2.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a63c193a4db6a1552073bf069d5d31749"></a><!-- doxytag: member="NumberFormat::getDynamicClassID" ref="a63c193a4db6a1552073bf069d5d31749" args="(void) const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="utypes_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> NumberFormat::getDynamicClassID </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a unique class ID POLYMORPHICALLY. </p>
<p>Pure virtual override. This method is to implement a simple version of RTTI, since not all C++ compilers support genuine RTTI. Polymorphic <a class="el" href="classNumberFormat.html#a97f4f81efd4747024deaf88ceb4d80a3" title="Return true if the given Format objects are semantically equal.">operator==()</a> and <a class="el" href="classFormat.html#a4e7ebd5cfd390c35e2bda88257f8b51a" title="Clone this object polymorphically.">clone()</a> methods call this method. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The class ID for this object. All objects of a given class have the same class ID. Objects of other classes have different class IDs. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002839">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Implements <a class="el" href="classFormat.html#ac961d410d174518e5a3ebb8bbef45cd7">Format</a>.</p>
<p>Implemented in <a class="el" href="classChoiceFormat.html#a3bb9d296446885cca90a38e477ef5527">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#a29d58da07dee220c1661ec37397babb2">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#aa570fa8ffe7f29c9d6d7ab4b3303fa2a">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="ae79eb815aa14fa432eec4307a3e2bc28"></a><!-- doxytag: member="NumberFormat::getEffectiveCurrency" ref="ae79eb815aa14fa432eec4307a3e2bc28" args="(UChar *result, UErrorCode &ec) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::getEffectiveCurrency </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>result</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>ec</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the currency in effect for this formatter. </p>
<p>Subclasses should override this method as needed. Unlike <a class="el" href="classNumberFormat.html#acc485325edc696f35f73cbdad75eed59" title="Gets the currency used to display currency amounts.">getCurrency()</a>, this method should never return "". </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>output parameter for null-terminated result, which must have a capacity of at least 4 </dd></dl>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000325">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a9ff71ee7d761b1f802aa7e5d899ebe5c">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="ae2d2e103f14b46234f6dc90125c98eb1"></a><!-- doxytag: member="NumberFormat::getMaximumFractionDigits" ref="ae2d2e103f14b46234f6dc90125c98eb1" args="(void) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t NumberFormat::getMaximumFractionDigits </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the maximum number of digits allowed in the fraction portion of a number. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the maximum number of digits allowed in the fraction portion of a number. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#abb97d22c2d628aab87d695c6f66e8dbb" title="Sets the maximum number of digits allowed in the fraction portion of a number.">setMaximumFractionDigits</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002832">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a1b06a7feabb695be2e5f16a60a377cf3"></a><!-- doxytag: member="NumberFormat::getMaximumIntegerDigits" ref="a1b06a7feabb695be2e5f16a60a377cf3" args="(void) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t NumberFormat::getMaximumIntegerDigits </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the maximum number of digits allowed in the integer portion of a number. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the maximum number of digits allowed in the integer portion of a number. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#a561c13b71c338e6b68729c786d2a3a09" title="Sets the maximum number of digits allowed in the integer portion of a number.">setMaximumIntegerDigits</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002828">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a11eb09d7b8f01e40766898f4614598a2"></a><!-- doxytag: member="NumberFormat::getMinimumFractionDigits" ref="a11eb09d7b8f01e40766898f4614598a2" args="(void) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t NumberFormat::getMinimumFractionDigits </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the minimum number of digits allowed in the fraction portion of a number. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the minimum number of digits allowed in the fraction portion of a number. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#a454c39db13cb0dde930e9249ee726db5" title="Sets the minimum number of digits allowed in the fraction portion of a number.">setMinimumFractionDigits</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002834">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aa821c67615bf12bf1e8f1157108f6ad0"></a><!-- doxytag: member="NumberFormat::getMinimumIntegerDigits" ref="aa821c67615bf12bf1e8f1157108f6ad0" args="(void) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t NumberFormat::getMinimumIntegerDigits </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the minimum number of digits allowed in the integer portion of a number. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the minimum number of digits allowed in the integer portion of a number. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#a92a1454c564b66707d0145a123f65cf3" title="Sets the minimum number of digits allowed in the integer portion of a number.">setMinimumIntegerDigits</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002830">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="acfeb8972959e9383b026761d0e9e1e5e"></a><!-- doxytag: member="NumberFormat::getStaticClassID" ref="acfeb8972959e9383b026761d0e9e1e5e" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="utypes_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> NumberFormat::getStaticClassID </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return the class ID for this class. </p>
<p>This is useful for comparing to a return value from <a class="el" href="classNumberFormat.html#a63c193a4db6a1552073bf069d5d31749" title="Returns a unique class ID POLYMORPHICALLY.">getDynamicClassID()</a>. Note that, because <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a> is an abstract base class, no fully constructed object will have the class ID returned by <a class="el" href="classNumberFormat.html#acfeb8972959e9383b026761d0e9e1e5e" title="Return the class ID for this class.">NumberFormat::getStaticClassID()</a>. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The class ID for all objects of this class. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002838">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#adaeccf67d5eac282b6b3c4ccf020e9b5">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#a2c44dda0c6621b3ff10b120fd760ea88">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#a3f59d38e1adfa24dd9b33b1996c018b8">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a6fe9bf9d863b9c85ba8f61699e2bbd5b"></a><!-- doxytag: member="NumberFormat::isGroupingUsed" ref="a6fe9bf9d863b9c85ba8f61699e2bbd5b" args="(void) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> NumberFormat::isGroupingUsed </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns true if grouping is used in this format. </p>
<p>For example, in the English locale, with grouping on, the number 1234567 might be formatted as "1,234,567". The grouping separator as well as the size of each group is locale dependant and is determined by sub-classes of <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a>. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#a42f1ff1c899ec393a87ef24cfdfdd0a1" title="Set whether or not grouping will be used in this format.">setGroupingUsed</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002826">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a680f60d204c0d00bb06f65d7c3ea716a"></a><!-- doxytag: member="NumberFormat::isParseIntegerOnly" ref="a680f60d204c0d00bb06f65d7c3ea716a" args="(void) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> NumberFormat::isParseIntegerOnly </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return true if this format will parse numbers as integers only. </p>
<p>For example in the English locale, with ParseIntegerOnly true, the string "1234." would be parsed as the integer value 1234 and parsing would stop at the "." character. Of course, the exact format accepted by the parse operation is locale dependant and determined by sub-classes of <a class="el" href="classNumberFormat.html" title="Abstract base class for all number formats.">NumberFormat</a>. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if this format will parse numbers as integers only. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002812">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="numfmt_8h_source.html#l01034">1034</a> of file <a class="el" href="numfmt_8h_source.html">numfmt.h</a>.</p>
</div>
</div>
<a class="anchor" id="a8b9d5c0937f4da69d9a229fd10f8ec38"></a><!-- doxytag: member="NumberFormat::operator=" ref="a8b9d5c0937f4da69d9a229fd10f8ec38" args="(const NumberFormat &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classNumberFormat.html">NumberFormat</a>& NumberFormat::operator= </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classNumberFormat.html">NumberFormat</a> & </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Assignment operator. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002842">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented from <a class="el" href="classFormat.html#a7a5276a88c488462eea3a508b71f4d9c">Format</a>.</p>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#a2873dacc65a6fd80c8111711a6f0c3b4">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#a80ae4009d0a89aaa339e38328c5f5f31">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#ae492ee51caf11c6244a9ca9b6ddaecda">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a97f4f81efd4747024deaf88ceb4d80a3"></a><!-- doxytag: member="NumberFormat::operator==" ref="a97f4f81efd4747024deaf88ceb4d80a3" args="(const Format &other) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> NumberFormat::operator== </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFormat.html">Format</a> & </td>
<td class="paramname"> <em>other</em></td>
<td> ) </td>
<td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return true if the given <a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> objects are semantically equal. </p>
<p>Objects of different subclasses are considered unequal. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the given <a class="el" href="classFormat.html" title="Base class for all formats.">Format</a> objects are semantically equal. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002800">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#a68b2c94926681294a2fe0d1c7cf52975">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#a3d3a2d71fcf817ddc1473e9e5c59756c">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#a2068e1cbee7eb25feaecb6c160a958a1">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a01ac6e0a7a47b2d8e387752d1a024b29"></a><!-- doxytag: member="NumberFormat::parse" ref="a01ac6e0a7a47b2d8e387752d1a024b29" args="(const UnicodeString &text, Formattable &result, UErrorCode &status) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::parse </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFormattable.html">Formattable</a> & </td>
<td class="paramname"> <em>result</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parse a string as a numeric value, and return a <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> numeric object. </p>
<p>This method parses integers only if IntegerOnly is set.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>text</em> </td><td>The text to be parsed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>result</em> </td><td><a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> to be set to the parse result. If parse fails, return contents are undefined. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>Output parameter set to a failure error code when a failure occurs. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> object of numeric type. The caller owns this an must delete it. NULL on failure. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#a680f60d204c0d00bb06f65d7c3ea716a" title="Return true if this format will parse numbers as integers only.">NumberFormat::isParseIntegerOnly</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002811">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classChoiceFormat.html#aa1d8199f4ac3743ffb19f9deec3648f9">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#a9c0309ac314fe3ec8a7cc4b50b99940a">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#a90cc5cec4399cea7c3f1e600ca800ebb">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="ab2c59c0b036a413b6735c6d50b88ae25"></a><!-- doxytag: member="NumberFormat::parse" ref="ab2c59c0b036a413b6735c6d50b88ae25" args="(const UnicodeString &text, Formattable &result, ParsePosition &parsePosition) const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::parse </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFormattable.html">Formattable</a> & </td>
<td class="paramname"> <em>result</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classParsePosition.html">ParsePosition</a> & </td>
<td class="paramname"> <em>parsePosition</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return a long if possible (e.g. </p>
<p>within range LONG_MAX, LONG_MAX], and with no decimals), otherwise a double. If IntegerOnly is set, will stop at a decimal point (or equivalent; e.g. for rational numbers "1 2/3", will stop after the 1). </p>
<p>If no object can be parsed, index is unchanged, and NULL is returned. </p>
<p>This is a pure virtual which concrete subclasses must implement.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>text</em> </td><td>The text to be parsed. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>result</em> </td><td><a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> to be set to the parse result. If parse fails, return contents are undefined. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>parsePosition</em> </td><td>The position to start parsing at on input. On output, moved to after the last successfully parse character. On parse failure, does not change. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> object of numeric type. The caller owns this an must delete it. NULL on failure. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002810">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Implemented in <a class="el" href="classChoiceFormat.html#af39ef720dd6a46678563da4f4f185bdd">ChoiceFormat</a>, <a class="el" href="classDecimalFormat.html#afe6f4084b4a6ccff6977501d90011fa4">DecimalFormat</a>, and <a class="el" href="classRuleBasedNumberFormat.html#a16c9b8e02cf8bb2f5c5d122143dbeb60">RuleBasedNumberFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a08bffcf90d1cc63882ab686b6b271f9b"></a><!-- doxytag: member="NumberFormat::parseCurrency" ref="a08bffcf90d1cc63882ab686b6b271f9b" args="(const UnicodeString &text, Formattable &result, ParsePosition &pos) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classFormattable.html">Formattable</a>& NumberFormat::parseCurrency </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFormattable.html">Formattable</a> & </td>
<td class="paramname"> <em>result</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classParsePosition.html">ParsePosition</a> & </td>
<td class="paramname"> <em>pos</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parses text from the given string as a currency amount. </p>
<p>Unlike the <a class="el" href="classNumberFormat.html#ab2c59c0b036a413b6735c6d50b88ae25" title="Return a long if possible (e.g.">parse()</a> method, this method will attempt to parse a generic currency name, searching for a match of this object's locale's currency display names, or for a 3-letter ISO currency code. This method will fail if this format is not a currency format, that is, if it does not contain the currency pattern symbol (U+00A4) in its prefix or suffix.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>text</em> </td><td>the string to parse </td></tr>
<tr><td valign="top"></td><td valign="top"><em>result</em> </td><td>output parameter to receive result. This will have its currency set to the parsed ISO currency code. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pos</em> </td><td>input-output position; on input, the position within text to match; must have 0 <= pos.getIndex() < text.length(); on output, the position after the last matched character. If the parse fails, the position in unchanged upon output. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a reference to result </dd></dl>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000324">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#aa83789398c1b9baa69aa31a5391eadf2">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="aae2d85a1f97ae55faf249a4a0f429976"></a><!-- doxytag: member="NumberFormat::parseObject" ref="aae2d85a1f97ae55faf249a4a0f429976" args="(const UnicodeString &source, Formattable &result, ParsePosition &parse_pos) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::parseObject </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classUnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"> <em>source</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classFormattable.html">Formattable</a> & </td>
<td class="paramname"> <em>result</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classParsePosition.html">ParsePosition</a> & </td>
<td class="paramname"> <em>parse_pos</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Parse a string to produce an object. </p>
<p>This methods handles parsing of numeric strings into <a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> objects with numeric types. </p>
<p>Before calling, set parse_pos.index to the offset you want to start parsing at in the source. After calling, parse_pos.index indicates the position after the successfully parsed text. If an error occurs, parse_pos.index is unchanged. </p>
<p>When parsing, leading whitespace is discarded (with successful parse), while trailing whitespace is left as is. </p>
<p>See <a class="el" href="classFormat.html#aa53bea97b986c2f21e5638aa30aa08b7" title="Parse a string to produce an object.">Format::parseObject()</a> for more.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>source</em> </td><td>The string to be parsed into an object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>result</em> </td><td><a class="el" href="classFormattable.html" title="Formattable objects can be passed to the Format class or its subclasses for formatting...">Formattable</a> to be set to the parse result. If parse fails, return contents are undefined. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>parse_pos</em> </td><td>The position to start parsing at. Upon return this param is set to the position after the last character successfully parsed. If the source is not parsed successfully, this param will remain unchanged. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A newly created Formattable* object, or NULL on failure. The caller owns this and should delete it when done. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002802">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Implements <a class="el" href="classFormat.html#aa53bea97b986c2f21e5638aa30aa08b7">Format</a>.</p>
</div>
</div>
<a class="anchor" id="a83e8d5a07d0b2c1444c051ab442e6c3e"></a><!-- doxytag: member="NumberFormat::registerFactory" ref="a83e8d5a07d0b2c1444c051ab442e6c3e" args="(NumberFormatFactory *toAdopt, UErrorCode &status)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="umisc_8h.html#ab5905d79ed3b979840cee1d5fd48b4fb">URegistryKey</a> NumberFormat::registerFactory </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classNumberFormatFactory.html">NumberFormatFactory</a> * </td>
<td class="paramname"> <em>toAdopt</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Register a new <a class="el" href="classNumberFormatFactory.html" title="A NumberFormatFactory is used to register new number formats.">NumberFormatFactory</a>. </p>
<p>The factory will be adopted. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>toAdopt</em> </td><td>the <a class="el" href="classNumberFormatFactory.html" title="A NumberFormatFactory is used to register new number formats.">NumberFormatFactory</a> instance to be adopted </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>the in/out status code, no special meanings are assigned </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a registry key that can be used to unregister this factory </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002823">Stable:</a></b></dt><dd>ICU 2.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a1dbc762d377858e70de924aacc59d113"></a><!-- doxytag: member="NumberFormat::setCurrency" ref="a1dbc762d377858e70de924aacc59d113" args="(const UChar *theCurrency, UErrorCode &ec)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::setCurrency </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>theCurrency</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>ec</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the currency used to display currency amounts. </p>
<p>This takes effect immediately, if this format is a currency format. If this format is not a currency format, then the currency is used if and when this object becomes a currency format. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>theCurrency</em> </td><td>a 3-letter ISO code indicating new currency to use. It need not be null-terminated. May be the empty string or NULL to indicate no currency. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ec</em> </td><td>input-output error code </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002836">Stable:</a></b></dt><dd>ICU 3.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a4c87fca5e0d14886bdaa4e0969f814e5">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a42f1ff1c899ec393a87ef24cfdfdd0a1"></a><!-- doxytag: member="NumberFormat::setGroupingUsed" ref="a42f1ff1c899ec393a87ef24cfdfdd0a1" args="(UBool newValue)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::setGroupingUsed </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td>
<td class="paramname"> <em>newValue</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set whether or not grouping will be used in this format. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>newValue</em> </td><td>True, grouping will be used in this format. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd>getGroupingUsed </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002827">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="abb97d22c2d628aab87d695c6f66e8dbb"></a><!-- doxytag: member="NumberFormat::setMaximumFractionDigits" ref="abb97d22c2d628aab87d695c6f66e8dbb" args="(int32_t newValue)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::setMaximumFractionDigits </td>
<td>(</td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>newValue</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the maximum number of digits allowed in the fraction portion of a number. </p>
<p>maximumFractionDigits must be >= minimumFractionDigits. If the new value for maximumFractionDigits is less than the current value of minimumFractionDigits, then minimumFractionDigits will also be set to the new value. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>newValue</em> </td><td>the new value to be set. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#ae2d2e103f14b46234f6dc90125c98eb1" title="Returns the maximum number of digits allowed in the fraction portion of a number...">getMaximumFractionDigits</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002833">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#a383f882e65849d2cf59550c875f61f1d">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a561c13b71c338e6b68729c786d2a3a09"></a><!-- doxytag: member="NumberFormat::setMaximumIntegerDigits" ref="a561c13b71c338e6b68729c786d2a3a09" args="(int32_t newValue)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::setMaximumIntegerDigits </td>
<td>(</td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>newValue</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the maximum number of digits allowed in the integer portion of a number. </p>
<p>maximumIntegerDigits must be >= minimumIntegerDigits. If the new value for maximumIntegerDigits is less than the current value of minimumIntegerDigits, then minimumIntegerDigits will also be set to the new value.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>newValue</em> </td><td>the new value for the maximum number of digits allowed in the integer portion of a number. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#a1b06a7feabb695be2e5f16a60a377cf3" title="Returns the maximum number of digits allowed in the integer portion of a number.">getMaximumIntegerDigits</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002829">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#aaf3692b04cf2fafbc536bcdaf9caea25">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a454c39db13cb0dde930e9249ee726db5"></a><!-- doxytag: member="NumberFormat::setMinimumFractionDigits" ref="a454c39db13cb0dde930e9249ee726db5" args="(int32_t newValue)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::setMinimumFractionDigits </td>
<td>(</td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>newValue</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the minimum number of digits allowed in the fraction portion of a number. </p>
<p>minimumFractionDigits must be <= maximumFractionDigits. If the new value for minimumFractionDigits exceeds the current value of maximumFractionDigits, then maximumIntegerDigits will also be set to the new value </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>newValue</em> </td><td>the new value to be set. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#a11eb09d7b8f01e40766898f4614598a2" title="Returns the minimum number of digits allowed in the fraction portion of a number...">getMinimumFractionDigits</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002835">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#acb6abe86ebcfd4bb0b91dec005da9d7b">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="a92a1454c564b66707d0145a123f65cf3"></a><!-- doxytag: member="NumberFormat::setMinimumIntegerDigits" ref="a92a1454c564b66707d0145a123f65cf3" args="(int32_t newValue)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::setMinimumIntegerDigits </td>
<td>(</td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>newValue</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the minimum number of digits allowed in the integer portion of a number. </p>
<p>minimumIntegerDigits must be <= maximumIntegerDigits. If the new value for minimumIntegerDigits exceeds the current value of maximumIntegerDigits, then maximumIntegerDigits will also be set to the new value. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>newValue</em> </td><td>the new value to be set. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#aa821c67615bf12bf1e8f1157108f6ad0" title="Returns the minimum number of digits allowed in the integer portion of a number.">getMinimumIntegerDigits</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002831">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Reimplemented in <a class="el" href="classDecimalFormat.html#acda98ebc96abd54c9d796e90231f3bf9">DecimalFormat</a>.</p>
</div>
</div>
<a class="anchor" id="ac9b8eb834f6d18a61661cff71b954e52"></a><!-- doxytag: member="NumberFormat::setParseIntegerOnly" ref="ac9b8eb834f6d18a61661cff71b954e52" args="(UBool value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void NumberFormat::setParseIntegerOnly </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td>
<td class="paramname"> <em>value</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets whether or not numbers should be parsed as integers only. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>set True, this format will parse numbers as integers only. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classNumberFormat.html#a680f60d204c0d00bb06f65d7c3ea716a" title="Return true if this format will parse numbers as integers only.">isParseIntegerOnly</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002813">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ab6ecd9973fd855a9028af8cadbf0a4c3"></a><!-- doxytag: member="NumberFormat::unregister" ref="ab6ecd9973fd855a9028af8cadbf0a4c3" args="(URegistryKey key, UErrorCode &status)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> NumberFormat::unregister </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umisc_8h.html#ab5905d79ed3b979840cee1d5fd48b4fb">URegistryKey</a> </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Unregister a previously-registered <a class="el" href="classNumberFormatFactory.html" title="A NumberFormatFactory is used to register new number formats.">NumberFormatFactory</a> using the key returned from the register call. </p>
<p>Key becomes invalid after a successful call and should not be used again. The <a class="el" href="classNumberFormatFactory.html" title="A NumberFormatFactory is used to register new number formats.">NumberFormatFactory</a> corresponding to the key will be deleted. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the registry key returned by a previous call to registerFactory </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>the in/out status code, no special meanings are assigned </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>TRUE if the factory for the key was successfully unregistered </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002824">Stable:</a></b></dt><dd>ICU 2.6 </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="numfmt_8h_source.html">numfmt.h</a></li>
</ul>
</div>
<!--- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Defines</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on 16 Mar 2010 for ICU 4.4 by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
f51238514e2abe817779ad2fe01b0759
>
files
>
142
