Your IP : 216.73.216.213
<!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.14"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>ICU 60.1: numberformatter.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">ICU 60.1
 <span id="projectnumber">60.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.14 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */</script>
<div id="main-nav"></div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_73bc6a9bb617ea1bc89a10aa59ce84e4.html">i18n</a></li><li class="navelem"><a class="el" href="dir_0119ce638985e8a1561a00fdb5f76ff6.html">unicode</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#namespaces">Namespaces</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#enum-members">Enumerations</a> </div>
<div class="headertitle">
<div class="title">numberformatter.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>C++ API: Library for localized number formatting introduced in ICU 60.
<a href="#details">More...</a></p>
<div class="textblock"><code>#include "<a class="el" href="utypes_8h_source.html">unicode/utypes.h</a>"</code><br />
<code>#include "<a class="el" href="appendable_8h_source.html">unicode/appendable.h</a>"</code><br />
<code>#include "<a class="el" href="dcfmtsym_8h_source.html">unicode/dcfmtsym.h</a>"</code><br />
<code>#include "<a class="el" href="currunit_8h_source.html">unicode/currunit.h</a>"</code><br />
<code>#include "<a class="el" href="fieldpos_8h_source.html">unicode/fieldpos.h</a>"</code><br />
<code>#include "<a class="el" href="fpositer_8h_source.html">unicode/fpositer.h</a>"</code><br />
<code>#include "<a class="el" href="measunit_8h_source.html">unicode/measunit.h</a>"</code><br />
<code>#include "<a class="el" href="nounit_8h_source.html">unicode/nounit.h</a>"</code><br />
<code>#include "<a class="el" href="plurrule_8h_source.html">unicode/plurrule.h</a>"</code><br />
<code>#include "<a class="el" href="ucurr_8h_source.html">unicode/ucurr.h</a>"</code><br />
<code>#include "<a class="el" href="unum_8h_source.html">unicode/unum.h</a>"</code><br />
</div>
<p><a href="numberformatter_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1Notation.html">icu::number::Notation</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A class that defines the notation style to be used when formatting numbers in <a class="el" href="classicu_1_1number_1_1NumberFormatter.html" title="See the main description in numberformatter.h for documentation and examples. ">NumberFormatter</a>. <a href="classicu_1_1number_1_1Notation.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structicu_1_1number_1_1Notation_1_1NotationUnion_1_1ScientificSettings.html">icu::number::Notation::NotationUnion::ScientificSettings</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1ScientificNotation.html">icu::number::ScientificNotation</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A class that defines the scientific notation style to be used when formatting numbers in <a class="el" href="classicu_1_1number_1_1NumberFormatter.html" title="See the main description in numberformatter.h for documentation and examples. ">NumberFormatter</a>. <a href="classicu_1_1number_1_1ScientificNotation.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1Rounder.html">icu::number::Rounder</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A class that defines the rounding strategy to be used when formatting numbers in <a class="el" href="classicu_1_1number_1_1NumberFormatter.html" title="See the main description in numberformatter.h for documentation and examples. ">NumberFormatter</a>. <a href="classicu_1_1number_1_1Rounder.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structicu_1_1number_1_1Rounder_1_1RounderUnion_1_1FractionSignificantSettings.html">icu::number::Rounder::RounderUnion::FractionSignificantSettings</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structicu_1_1number_1_1Rounder_1_1RounderUnion_1_1IncrementSettings.html">icu::number::Rounder::RounderUnion::IncrementSettings</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1FractionRounder.html">icu::number::FractionRounder</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A class that defines a rounding strategy based on a number of fraction places and optionally significant digits to be used when formatting numbers in <a class="el" href="classicu_1_1number_1_1NumberFormatter.html" title="See the main description in numberformatter.h for documentation and examples. ">NumberFormatter</a>. <a href="classicu_1_1number_1_1FractionRounder.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1CurrencyRounder.html">icu::number::CurrencyRounder</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A class that defines a rounding strategy parameterized by a currency to be used when formatting numbers in <a class="el" href="classicu_1_1number_1_1NumberFormatter.html" title="See the main description in numberformatter.h for documentation and examples. ">NumberFormatter</a>. <a href="classicu_1_1number_1_1CurrencyRounder.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1IncrementRounder.html">icu::number::IncrementRounder</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A class that defines a rounding strategy parameterized by a rounding increment to be used when formatting numbers in <a class="el" href="classicu_1_1number_1_1NumberFormatter.html" title="See the main description in numberformatter.h for documentation and examples. ">NumberFormatter</a>. <a href="classicu_1_1number_1_1IncrementRounder.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1Grouper.html">icu::number::Grouper</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1IntegerWidth.html">icu::number::IntegerWidth</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A class that defines the strategy for padding and truncating integers before the decimal separator. <a href="classicu_1_1number_1_1IntegerWidth.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1impl_1_1SymbolsWrapper.html">icu::number::impl::SymbolsWrapper</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1impl_1_1Padder.html">icu::number::impl::Padder</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structicu_1_1number_1_1impl_1_1MacroProps.html">icu::number::impl::MacroProps</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1NumberFormatterSettings.html">icu::number::NumberFormatterSettings< Derived ></a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">An abstract base class for specifying settings related to number formatting. <a href="classicu_1_1number_1_1NumberFormatterSettings.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1UnlocalizedNumberFormatter.html">icu::number::UnlocalizedNumberFormatter</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="classicu_1_1number_1_1NumberFormatter.html" title="See the main description in numberformatter.h for documentation and examples. ">NumberFormatter</a> that does not yet have a locale. <a href="classicu_1_1number_1_1UnlocalizedNumberFormatter.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1LocalizedNumberFormatter.html">icu::number::LocalizedNumberFormatter</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="classicu_1_1number_1_1NumberFormatter.html" title="See the main description in numberformatter.h for documentation and examples. ">NumberFormatter</a> that has a locale associated with it; this means .format() methods are available. <a href="classicu_1_1number_1_1LocalizedNumberFormatter.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1FormattedNumber.html">icu::number::FormattedNumber</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The result of a number formatting operation. <a href="classicu_1_1number_1_1FormattedNumber.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1number_1_1NumberFormatter.html">icu::number::NumberFormatter</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">See the main description in <a class="el" href="numberformatter_8h.html" title="C++ API: Library for localized number formatting introduced in ICU 60. ">numberformatter.h</a> for documentation and examples. <a href="classicu_1_1number_1_1NumberFormatter.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="namespaces"></a>
Namespaces</h2></td></tr>
<tr class="memitem:namespaceicu"><td class="memItemLeft" align="right" valign="top">  </td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceicu.html">icu</a></td></tr>
<tr class="memdesc:namespaceicu"><td class="mdescLeft"> </td><td class="mdescRight">File <a class="el" href="coll_8h.html" title="C++ API: Collation Service. ">coll.h</a>. <br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:a07ddf4ac13a5c17f72f967b1dd8bd464"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3f">UNumberUnitWidth</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="numberformatter_8h.html#a07ddf4ac13a5c17f72f967b1dd8bd464">UNumberUnitWidth</a></td></tr>
<tr class="memdesc:a07ddf4ac13a5c17f72f967b1dd8bd464"><td class="mdescLeft"> </td><td class="mdescRight">An enum declaring how to render units, including currencies. <a href="#a07ddf4ac13a5c17f72f967b1dd8bd464">More...</a><br /></td></tr>
<tr class="separator:a07ddf4ac13a5c17f72f967b1dd8bd464"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:add0d83db5211578a00a847edabbed102"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9">UNumberSignDisplay</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="numberformatter_8h.html#add0d83db5211578a00a847edabbed102">UNumberSignDisplay</a></td></tr>
<tr class="memdesc:add0d83db5211578a00a847edabbed102"><td class="mdescLeft"> </td><td class="mdescRight">An enum declaring how to denote positive and negative numbers. <a href="#add0d83db5211578a00a847edabbed102">More...</a><br /></td></tr>
<tr class="separator:add0d83db5211578a00a847edabbed102"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a4ed32c7d02790f12deb1d9c9400ef581"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="numberformatter_8h.html#a1e0fe0c910e360dda5cdad3387e5a0c6">UNumberDecimalSeparatorDisplay</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="numberformatter_8h.html#a4ed32c7d02790f12deb1d9c9400ef581">UNumberDecimalMarkDisplay</a></td></tr>
<tr class="memdesc:a4ed32c7d02790f12deb1d9c9400ef581"><td class="mdescLeft"> </td><td class="mdescRight">An enum declaring how to render the decimal separator. <a href="#a4ed32c7d02790f12deb1d9c9400ef581">More...</a><br /></td></tr>
<tr class="separator:a4ed32c7d02790f12deb1d9c9400ef581"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a226f890990b617c4963ba46ee104e143"><td class="memItemLeft" align="right" valign="top"><a id="a226f890990b617c4963ba46ee104e143"></a>
typedef Notation </td><td class="memItemRight" valign="bottom"><b>icu::number::CompactNotation</b></td></tr>
<tr class="separator:a226f890990b617c4963ba46ee104e143"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:afe9cef208ced7efb3a9ea3bbc614bf01"><td class="memItemLeft" align="right" valign="top"><a id="afe9cef208ced7efb3a9ea3bbc614bf01"></a>
typedef Notation </td><td class="memItemRight" valign="bottom"><b>icu::number::SimpleNotation</b></td></tr>
<tr class="separator:afe9cef208ced7efb3a9ea3bbc614bf01"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad0a5cf48b78e7569acf9fa6a2aad65ae"><td class="memItemLeft" align="right" valign="top"><a id="ad0a5cf48b78e7569acf9fa6a2aad65ae"></a>
typedef Rounder </td><td class="memItemRight" valign="bottom"><b>icu::number::DigitRounder</b></td></tr>
<tr class="separator:ad0a5cf48b78e7569acf9fa6a2aad65ae"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:a5ee613b0f806f558d9ea877aa62a0c3f"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3f">UNumberUnitWidth</a> { <br />
  <a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3fa721badced2bb2b04f6c10afaed3bedef">UNUM_UNIT_WIDTH_NARROW</a>,
<a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3fad8d8a2f752f8e91c3360c9a5399ef593">UNUM_UNIT_WIDTH_SHORT</a>,
<a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3fa21dfe289ee4e87262df9622134ab29db">UNUM_UNIT_WIDTH_FULL_NAME</a>,
<a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3fad0ce2ec95aad4c8c32967b9e2f84fcfb">UNUM_UNIT_WIDTH_ISO_CODE</a>,
<br />
  <a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3fa1b45ff25f674b915fb1481b30e23eea5">UNUM_UNIT_WIDTH_HIDDEN</a>,
<a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3faefbce8f020b12394f6d37b982273a758">UNUM_UNIT_WIDTH_COUNT</a>
<br />
}</td></tr>
<tr class="memdesc:a5ee613b0f806f558d9ea877aa62a0c3f"><td class="mdescLeft"> </td><td class="mdescRight">An enum declaring how to render units, including currencies. <a href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3f">More...</a><br /></td></tr>
<tr class="separator:a5ee613b0f806f558d9ea877aa62a0c3f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a18092ae1533c9c260f01c9dbf25589c9"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9">UNumberSignDisplay</a> { <br />
  <a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9a3919ed89463cc89fc7f25cbd9c9e4968">UNUM_SIGN_AUTO</a>,
<a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9a1c62fa437fad105b04e5fcbf65167f4a">UNUM_SIGN_ALWAYS</a>,
<a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9a54dff733ecf5a488b6176a3de58229f0">UNUM_SIGN_NEVER</a>,
<a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9a3fcc7e72482eaa1f71e0a96506cf6ac2">UNUM_SIGN_ACCOUNTING</a>,
<br />
  <a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9a5bcfdf8a223dd757686edeeda2eca603">UNUM_SIGN_ACCOUNTING_ALWAYS</a>,
<a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9ae5314fcda9c534ff8c6e686f967a4c54">UNUM_SIGN_COUNT</a>
<br />
}</td></tr>
<tr class="memdesc:a18092ae1533c9c260f01c9dbf25589c9"><td class="mdescLeft"> </td><td class="mdescRight">An enum declaring how to denote positive and negative numbers. <a href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9">More...</a><br /></td></tr>
<tr class="separator:a18092ae1533c9c260f01c9dbf25589c9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a1e0fe0c910e360dda5cdad3387e5a0c6"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="numberformatter_8h.html#a1e0fe0c910e360dda5cdad3387e5a0c6">UNumberDecimalSeparatorDisplay</a> { <a class="el" href="numberformatter_8h.html#a1e0fe0c910e360dda5cdad3387e5a0c6a93927951d26b124a5557235406f290d6">UNUM_DECIMAL_SEPARATOR_AUTO</a>,
<a class="el" href="numberformatter_8h.html#a1e0fe0c910e360dda5cdad3387e5a0c6abb6bc9885a6f2bee1795056d215f0522">UNUM_DECIMAL_SEPARATOR_ALWAYS</a>,
<a class="el" href="numberformatter_8h.html#a1e0fe0c910e360dda5cdad3387e5a0c6a1d1b364e55dcabab30649afbaa200cd0">UNUM_DECIMAL_SEPARATOR_COUNT</a>
}</td></tr>
<tr class="memdesc:a1e0fe0c910e360dda5cdad3387e5a0c6"><td class="mdescLeft"> </td><td class="mdescRight">An enum declaring how to render the decimal separator. <a href="numberformatter_8h.html#a1e0fe0c910e360dda5cdad3387e5a0c6">More...</a><br /></td></tr>
<tr class="separator:a1e0fe0c910e360dda5cdad3387e5a0c6"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>C++ API: Library for localized number formatting introduced in ICU 60. </p>
<p>This library was introduced in ICU 60 to simplify the process of formatting localized number strings. Basic usage examples:</p>
<pre>
// Most basic usage:
NumberFormatter::withLocale(...).format(123).toString(); // 1,234 in en-US</pre><pre>// Custom notation, unit, and rounding strategy:
NumberFormatter::with()
.notation(Notation::compactShort())
.unit(CurrencyUnit("EUR", status))
.rounding(Rounder::maxDigits(2))
.locale(...)
.format(1234)
.toString(); // €1.2K in en-US</pre><pre>// Create a formatter in a singleton for use later:
static const LocalizedNumberFormatter formatter = NumberFormatter::withLocale(...)
.unit(NoUnit::percent())
.rounding(Rounder::fixedFraction(3));
formatter.format(5.9831).toString(); // 5.983% in en-US</pre><pre>// Create a "template" in a singleton but without setting a locale until the call site:
static const UnlocalizedNumberFormatter template = NumberFormatter::with()
.sign(UNumberSignDisplay::UNUM_SIGN_ALWAYS)
.adoptUnit(MeasureUnit::createMeter(status))
.unitWidth(UNumberUnitWidth::UNUM_UNIT_WIDTH_FULL_NAME);
template.locale(...).format(1234).toString(); // +1,234 meters in en-US
</pre><p>This API offers more features than DecimalFormat and is geared toward new users of ICU.</p>
<p>NumberFormatter instances are immutable and thread safe. This means that invoking a configuration method has no effect on the receiving instance; you must store and use the new number formatter instance it returns instead.</p>
<pre>
UnlocalizedNumberFormatter formatter = UnlocalizedNumberFormatter::with().notation(Notation::scientific());
formatter.rounding(Rounder.maxFraction(2)); // does nothing!
formatter.locale(Locale.getEnglish()).format(9.8765).toString(); // prints "9.8765E0", not "9.88E0"
</pre><p>This API is based on the <em>fluent</em> design pattern popularized by libraries such as Google's Guava. For extensive details on the design of this API, read <a href="https://goo.gl/szi5VB">the design doc</a>.</p>
<dl class="section author"><dt>Author</dt><dd>Shane Carr </dd></dl>
<p class="definition">Definition in file <a class="el" href="numberformatter_8h_source.html">numberformatter.h</a>.</p>
</div><h2 class="groupheader">Typedef Documentation</h2>
<a id="a4ed32c7d02790f12deb1d9c9400ef581"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a4ed32c7d02790f12deb1d9c9400ef581">◆ </a></span>UNumberDecimalMarkDisplay</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="numberformatter_8h.html#a1e0fe0c910e360dda5cdad3387e5a0c6">UNumberDecimalSeparatorDisplay</a> <a class="el" href="numberformatter_8h.html#a4ed32c7d02790f12deb1d9c9400ef581">UNumberDecimalMarkDisplay</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>An enum declaring how to render the decimal separator. </p>
<ul>
<li>
UNUM_DECIMAL_SEPARATOR_AUTO: "1", "1.1" </li>
<li>
UNUM_DECIMAL_SEPARATOR_ALWAYS: "1.", "1.1" </li>
</ul>
</div>
</div>
<a id="add0d83db5211578a00a847edabbed102"></a>
<h2 class="memtitle"><span class="permalink"><a href="#add0d83db5211578a00a847edabbed102">◆ </a></span>UNumberSignDisplay</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9">UNumberSignDisplay</a> <a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9">UNumberSignDisplay</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>An enum declaring how to denote positive and negative numbers. </p>
<p>Example outputs when formatting 123 and -123 in <em>en-US</em>:</p>
<ul>
<li>
AUTO: "123", "-123" </li>
<li>
ALWAYS: "+123", "-123" </li>
<li>
NEVER: "123", "123" </li>
<li>
ACCOUNTING: "$123", "($123)" </li>
<li>
ACCOUNTING_ALWAYS: "+$123", "($123)" </li>
</ul>
<p>The exact format, including the position and the code point of the sign, differ by locale.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000113">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</div>
</div>
<a id="a07ddf4ac13a5c17f72f967b1dd8bd464"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a07ddf4ac13a5c17f72f967b1dd8bd464">◆ </a></span>UNumberUnitWidth</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3f">UNumberUnitWidth</a> <a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3f">UNumberUnitWidth</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>An enum declaring how to render units, including currencies. </p>
<p>Example outputs when formatting 123 USD and 123 meters in <em>en-CA</em>:</p>
<ul>
<li>
NARROW*: "$123.00" and "123 m" </li>
<li>
SHORT: "US$ 123.00" and "123 m" </li>
<li>
FULL_NAME: "123.00 US dollars" and "123 meters" </li>
<li>
ISO_CODE: "USD 123.00" and undefined behavior </li>
<li>
HIDDEN: "123.00" and "123" </li>
</ul>
<ul>
<li>The narrow format for currencies is not currently supported; this is a known issue that will be fixed in a future version. See #11666 for more information.</li>
</ul>
<p>This enum is similar to <a class="el" href="">com.ibm.icu.text.MeasureFormat.FormatWidth</a>.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000112">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</div>
</div>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a id="a1e0fe0c910e360dda5cdad3387e5a0c6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1e0fe0c910e360dda5cdad3387e5a0c6">◆ </a></span>UNumberDecimalSeparatorDisplay</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="numberformatter_8h.html#a1e0fe0c910e360dda5cdad3387e5a0c6">UNumberDecimalSeparatorDisplay</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>An enum declaring how to render the decimal separator. </p>
<ul>
<li>
UNUM_DECIMAL_SEPARATOR_AUTO: "1", "1.1" </li>
<li>
UNUM_DECIMAL_SEPARATOR_ALWAYS: "1.", "1.1" </li>
</ul>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a1e0fe0c910e360dda5cdad3387e5a0c6a93927951d26b124a5557235406f290d6"></a>UNUM_DECIMAL_SEPARATOR_AUTO </td><td class="fielddoc"><p>Show the decimal separator when there are one or more digits to display after the separator, and do not show it otherwise. </p>
<p>This is the default behavior.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000124">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a1e0fe0c910e360dda5cdad3387e5a0c6abb6bc9885a6f2bee1795056d215f0522"></a>UNUM_DECIMAL_SEPARATOR_ALWAYS </td><td class="fielddoc"><p>Always show the decimal separator, even if there are no digits to display after the separator. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000125">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a1e0fe0c910e360dda5cdad3387e5a0c6a1d1b364e55dcabab30649afbaa200cd0"></a>UNUM_DECIMAL_SEPARATOR_COUNT </td><td class="fielddoc"><p>One more than the highest UNumberDecimalSeparatorDisplay value. </p>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000397">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. ICU 60: The numeric value may change over time; see ICU ticket #12420. </dd></dl>
</td></tr>
</table>
<p class="definition">Definition at line <a class="el" href="numberformatter_8h_source.html#l00250">250</a> of file <a class="el" href="numberformatter_8h_source.html">numberformatter.h</a>.</p>
</div>
</div>
<a id="a18092ae1533c9c260f01c9dbf25589c9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a18092ae1533c9c260f01c9dbf25589c9">◆ </a></span>UNumberSignDisplay</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="numberformatter_8h.html#a18092ae1533c9c260f01c9dbf25589c9">UNumberSignDisplay</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>An enum declaring how to denote positive and negative numbers. </p>
<p>Example outputs when formatting 123 and -123 in <em>en-US</em>:</p>
<ul>
<li>
AUTO: "123", "-123" </li>
<li>
ALWAYS: "+123", "-123" </li>
<li>
NEVER: "123", "123" </li>
<li>
ACCOUNTING: "$123", "($123)" </li>
<li>
ACCOUNTING_ALWAYS: "+$123", "($123)" </li>
</ul>
<p>The exact format, including the position and the code point of the sign, differ by locale.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000113">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a18092ae1533c9c260f01c9dbf25589c9a3919ed89463cc89fc7f25cbd9c9e4968"></a>UNUM_SIGN_AUTO </td><td class="fielddoc"><p>Show the minus sign on negative numbers, and do not show the sign on positive numbers. </p>
<p>This is the default behavior.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000119">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a18092ae1533c9c260f01c9dbf25589c9a1c62fa437fad105b04e5fcbf65167f4a"></a>UNUM_SIGN_ALWAYS </td><td class="fielddoc"><p>Show the minus sign on negative numbers and the plus sign on positive numbers. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000120">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a18092ae1533c9c260f01c9dbf25589c9a54dff733ecf5a488b6176a3de58229f0"></a>UNUM_SIGN_NEVER </td><td class="fielddoc"><p>Do not show the sign on positive or negative numbers. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000121">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a18092ae1533c9c260f01c9dbf25589c9a3fcc7e72482eaa1f71e0a96506cf6ac2"></a>UNUM_SIGN_ACCOUNTING </td><td class="fielddoc"><p>Use the locale-dependent accounting format on negative numbers, and do not show the sign on positive numbers. </p>
<p>The accounting format is defined in CLDR and varies by locale; in many Western locales, the format is a pair of parentheses around the number.</p>
<p>Note: Since CLDR defines the accounting format in the monetary context only, this option falls back to the AUTO sign display strategy when formatting without a currency unit. This limitation may be lifted in the future.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000122">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a18092ae1533c9c260f01c9dbf25589c9a5bcfdf8a223dd757686edeeda2eca603"></a>UNUM_SIGN_ACCOUNTING_ALWAYS </td><td class="fielddoc"><p>Use the locale-dependent accounting format on negative numbers, and show the plus sign on positive numbers. </p>
<p>For more information on the accounting format, see the ACCOUNTING sign display strategy.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000123">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a18092ae1533c9c260f01c9dbf25589c9ae5314fcda9c534ff8c6e686f967a4c54"></a>UNUM_SIGN_COUNT </td><td class="fielddoc"><p>One more than the highest UNumberSignDisplay value. </p>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000396">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. ICU 60: The numeric value may change over time; see ICU ticket #12420. </dd></dl>
</td></tr>
</table>
<p class="definition">Definition at line <a class="el" href="numberformatter_8h_source.html#l00186">186</a> of file <a class="el" href="numberformatter_8h_source.html">numberformatter.h</a>.</p>
</div>
</div>
<a id="a5ee613b0f806f558d9ea877aa62a0c3f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a5ee613b0f806f558d9ea877aa62a0c3f">◆ </a></span>UNumberUnitWidth</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="numberformatter_8h.html#a5ee613b0f806f558d9ea877aa62a0c3f">UNumberUnitWidth</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>An enum declaring how to render units, including currencies. </p>
<p>Example outputs when formatting 123 USD and 123 meters in <em>en-CA</em>:</p>
<ul>
<li>
NARROW*: "$123.00" and "123 m" </li>
<li>
SHORT: "US$ 123.00" and "123 m" </li>
<li>
FULL_NAME: "123.00 US dollars" and "123 meters" </li>
<li>
ISO_CODE: "USD 123.00" and undefined behavior </li>
<li>
HIDDEN: "123.00" and "123" </li>
</ul>
<ul>
<li>The narrow format for currencies is not currently supported; this is a known issue that will be fixed in a future version. See #11666 for more information.</li>
</ul>
<p>This enum is similar to <a class="el" href="">com.ibm.icu.text.MeasureFormat.FormatWidth</a>.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000112">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a5ee613b0f806f558d9ea877aa62a0c3fa721badced2bb2b04f6c10afaed3bedef"></a>UNUM_UNIT_WIDTH_NARROW </td><td class="fielddoc"><p>Print an abbreviated version of the unit name. </p>
<p>Similar to SHORT, but always use the shortest available abbreviation or symbol. This option can be used when the context hints at the identity of the unit. For more information on the difference between NARROW and SHORT, see SHORT.</p>
<p>In CLDR, this option corresponds to the "Narrow" format for measure units and the "¤¤¤¤¤" placeholder for currencies.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000114">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a5ee613b0f806f558d9ea877aa62a0c3fad8d8a2f752f8e91c3360c9a5399ef593"></a>UNUM_UNIT_WIDTH_SHORT </td><td class="fielddoc"><p>Print an abbreviated version of the unit name. </p>
<p>Similar to NARROW, but use a slightly wider abbreviation or symbol when there may be ambiguity. This is the default behavior.</p>
<p>For example, in <em>es-US</em>, the SHORT form for Fahrenheit is "{0} °F", but the NARROW form is "{0}°", since Fahrenheit is the customary unit for temperature in that locale.</p>
<p>In CLDR, this option corresponds to the "Short" format for measure units and the "¤" placeholder for currencies.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000115">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a5ee613b0f806f558d9ea877aa62a0c3fa21dfe289ee4e87262df9622134ab29db"></a>UNUM_UNIT_WIDTH_FULL_NAME </td><td class="fielddoc"><p>Print the full name of the unit, without any abbreviations. </p>
<p>In CLDR, this option corresponds to the default format for measure units and the "¤¤¤" placeholder for currencies.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000116">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a5ee613b0f806f558d9ea877aa62a0c3fad0ce2ec95aad4c8c32967b9e2f84fcfb"></a>UNUM_UNIT_WIDTH_ISO_CODE </td><td class="fielddoc"><p>Use the three-digit ISO XXX code in place of the symbol for displaying currencies. </p>
<p>The behavior of this option is currently undefined for use with measure units.</p>
<p>In CLDR, this option corresponds to the "¤¤" placeholder for currencies.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000117">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a5ee613b0f806f558d9ea877aa62a0c3fa1b45ff25f674b915fb1481b30e23eea5"></a>UNUM_UNIT_WIDTH_HIDDEN </td><td class="fielddoc"><p>Format the number according to the specified unit, but do not display the unit. </p>
<p>For currencies, apply monetary symbols and formats as with SHORT, but omit the currency symbol. For measure units, the behavior is equivalent to not specifying the unit at all.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000118">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 60 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a5ee613b0f806f558d9ea877aa62a0c3faefbce8f020b12394f6d37b982273a758"></a>UNUM_UNIT_WIDTH_COUNT </td><td class="fielddoc"><p>One more than the highest UNumberUnitWidth value. </p>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000395">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. ICU 60: The numeric value may change over time; see ICU ticket #12420. </dd></dl>
</td></tr>
</table>
<p class="definition">Definition at line <a class="el" href="numberformatter_8h_source.html#l00099">99</a> of file <a class="el" href="numberformatter_8h_source.html">numberformatter.h</a>.</p>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.14
</small></address>
</body>
</html>