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 64.2: numberrangeformatter.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 64.2
 <span id="projectnumber">64.2</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">numberrangeformatter.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>C++ API: Library for localized formatting of number, currency, and unit ranges.
<a href="#details">More...</a></p>
<div class="textblock"><code>#include <atomic></code><br />
<code>#include "<a class="el" href="appendable_8h_source.html">unicode/appendable.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="formattedvalue_8h_source.html">unicode/formattedvalue.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="numberformatter_8h_source.html">unicode/numberformatter.h</a>"</code><br />
</div>
<p><a href="numberrangeformatter_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">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structicu_1_1number_1_1impl_1_1RangeMacroProps.html">icu::number::impl::RangeMacroProps</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_1NumberRangeFormatterSettings.html">icu::number::NumberRangeFormatterSettings< 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_1NumberRangeFormatterSettings.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_1UnlocalizedNumberRangeFormatter.html">icu::number::UnlocalizedNumberRangeFormatter</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="classicu_1_1number_1_1NumberRangeFormatter.html" title="See the main description in numberrangeformatter.h for documentation and examples. ">NumberRangeFormatter</a> that does not yet have a locale. <a href="classicu_1_1number_1_1UnlocalizedNumberRangeFormatter.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_1LocalizedNumberRangeFormatter.html">icu::number::LocalizedNumberRangeFormatter</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="classicu_1_1number_1_1NumberRangeFormatter.html" title="See the main description in numberrangeformatter.h for documentation and examples. ">NumberRangeFormatter</a> that has a locale associated with it; this means .formatRange() methods are available. <a href="classicu_1_1number_1_1LocalizedNumberRangeFormatter.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_1FormattedNumberRange.html">icu::number::FormattedNumberRange</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The result of a number range formatting operation. <a href="classicu_1_1number_1_1FormattedNumberRange.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_1NumberRangeFormatter.html">icu::number::NumberRangeFormatter</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">See the main description in <a class="el" href="numberrangeformatter_8h.html" title="C++ API: Library for localized formatting of number, currency, and unit ranges. ">numberrangeformatter.h</a> for documentation and examples. <a href="classicu_1_1number_1_1NumberRangeFormatter.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:a491f66c4e5ae146a84521a368d3a2d47"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bac">UNumberRangeCollapse</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="numberrangeformatter_8h.html#a491f66c4e5ae146a84521a368d3a2d47">UNumberRangeCollapse</a></td></tr>
<tr class="memdesc:a491f66c4e5ae146a84521a368d3a2d47"><td class="mdescLeft"> </td><td class="mdescRight">Defines how to merge fields that are identical across the range sign. <a href="#a491f66c4e5ae146a84521a368d3a2d47">More...</a><br /></td></tr>
<tr class="separator:a491f66c4e5ae146a84521a368d3a2d47"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a9a3ba099fb59507ef9f74f478419c51f"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1">UNumberRangeIdentityFallback</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="numberrangeformatter_8h.html#a9a3ba099fb59507ef9f74f478419c51f">UNumberRangeIdentityFallback</a></td></tr>
<tr class="memdesc:a9a3ba099fb59507ef9f74f478419c51f"><td class="mdescLeft"> </td><td class="mdescRight">Defines the behavior when the two numbers in the range are identical after rounding. <a href="#a9a3ba099fb59507ef9f74f478419c51f">More...</a><br /></td></tr>
<tr class="separator:a9a3ba099fb59507ef9f74f478419c51f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a62f199f1dafc8f4f9d5a600da09ecc62"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037ed">UNumberRangeIdentityResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="numberrangeformatter_8h.html#a62f199f1dafc8f4f9d5a600da09ecc62">UNumberRangeIdentityResult</a></td></tr>
<tr class="memdesc:a62f199f1dafc8f4f9d5a600da09ecc62"><td class="mdescLeft"> </td><td class="mdescRight">Used in the result class FormattedNumberRange to indicate to the user whether the numbers formatted in the range were equal or not, and whether or not the identity fallback was applied. <a href="#a62f199f1dafc8f4f9d5a600da09ecc62">More...</a><br /></td></tr>
<tr class="separator:a62f199f1dafc8f4f9d5a600da09ecc62"><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:ad4ecbae149b64c966d58f4ce98c69bac"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bac">UNumberRangeCollapse</a> { <a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bacaaa00a1585b0252eed103005abde47c9c">UNUM_RANGE_COLLAPSE_AUTO</a>,
<a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bacacef657e902c491ff0c00e90ee8c395d8">UNUM_RANGE_COLLAPSE_NONE</a>,
<a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bacac216344d57db814e81ced68d32bfef91">UNUM_RANGE_COLLAPSE_UNIT</a>,
<a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69baca13c23178c1c516eb50308f6d01f54f48">UNUM_RANGE_COLLAPSE_ALL</a>
}</td></tr>
<tr class="memdesc:ad4ecbae149b64c966d58f4ce98c69bac"><td class="mdescLeft"> </td><td class="mdescRight">Defines how to merge fields that are identical across the range sign. <a href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bac">More...</a><br /></td></tr>
<tr class="separator:ad4ecbae149b64c966d58f4ce98c69bac"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa0154b4142afeed438c7be50a530ebd1"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1">UNumberRangeIdentityFallback</a> { <a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1acab9a2adc00e1fa304243e66bc9f65a5">UNUM_IDENTITY_FALLBACK_SINGLE_VALUE</a>,
<a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1a897059d33ea5187c9f721a80ff04c585">UNUM_IDENTITY_FALLBACK_APPROXIMATELY_OR_SINGLE_VALUE</a>,
<a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1a24fab0c8e99c610cb033b4ea99b21342">UNUM_IDENTITY_FALLBACK_APPROXIMATELY</a>,
<a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1af3178fcbcfb6851718a59d8a453941c8">UNUM_IDENTITY_FALLBACK_RANGE</a>
}</td></tr>
<tr class="memdesc:aa0154b4142afeed438c7be50a530ebd1"><td class="mdescLeft"> </td><td class="mdescRight">Defines the behavior when the two numbers in the range are identical after rounding. <a href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1">More...</a><br /></td></tr>
<tr class="separator:aa0154b4142afeed438c7be50a530ebd1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a19ab840a2eaea75afefd7aed599037ed"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037ed">UNumberRangeIdentityResult</a> { <a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037eda3317fc8c2690ee3a080a268a6195d00a">UNUM_IDENTITY_RESULT_EQUAL_BEFORE_ROUNDING</a>,
<a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037eda617bd9c6d436ac454b82005194b7467c">UNUM_IDENTITY_RESULT_EQUAL_AFTER_ROUNDING</a>,
<a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037eda3880f5ff12eefcf302b4984a79ec7ff7">UNUM_IDENTITY_RESULT_NOT_EQUAL</a>,
<a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037edad3879ac808169e0eaff934ecece4e54b">UNUM_IDENTITY_RESULT_COUNT</a>
}</td></tr>
<tr class="memdesc:a19ab840a2eaea75afefd7aed599037ed"><td class="mdescLeft"> </td><td class="mdescRight">Used in the result class FormattedNumberRange to indicate to the user whether the numbers formatted in the range were equal or not, and whether or not the identity fallback was applied. <a href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037ed">More...</a><br /></td></tr>
<tr class="separator:a19ab840a2eaea75afefd7aed599037ed"><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 formatting of number, currency, and unit ranges. </p>
<p>The main entrypoint to the formatting of ranges of numbers, including currencies and other units of measurement. </p>
<p>Usage example: </p>
<pre>
NumberRangeFormatter::with()
.identityFallback(UNUM_IDENTITY_FALLBACK_APPROXIMATELY_OR_SINGLE_VALUE)
.numberFormatterFirst(NumberFormatter::with().adoptUnit(MeasureUnit::createMeter()))
.numberFormatterSecond(NumberFormatter::with().adoptUnit(MeasureUnit::createKilometer()))
.locale("en-GB")
.formatRange(750, 1.2, status)
.toString(status);
// => "750 m - 1.2 km"
</pre> <p>Like NumberFormatter, NumberRangeFormatter instances (i.e., LocalizedNumberRangeFormatter and UnlocalizedNumberRangeFormatter) are immutable and thread-safe. This API is based on the <em>fluent</em> design pattern popularized by libraries such as Google's Guava.</p>
<dl class="section author"><dt>Author</dt><dd>Shane Carr </dd></dl>
<p class="definition">Definition in file <a class="el" href="numberrangeformatter_8h_source.html">numberrangeformatter.h</a>.</p>
</div><h2 class="groupheader">Typedef Documentation</h2>
<a id="a491f66c4e5ae146a84521a368d3a2d47"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a491f66c4e5ae146a84521a368d3a2d47">◆ </a></span>UNumberRangeCollapse</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bac">UNumberRangeCollapse</a> <a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bac">UNumberRangeCollapse</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Defines how to merge fields that are identical across the range sign. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000449">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</div>
</div>
<a id="a9a3ba099fb59507ef9f74f478419c51f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a9a3ba099fb59507ef9f74f478419c51f">◆ </a></span>UNumberRangeIdentityFallback</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1">UNumberRangeIdentityFallback</a> <a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1">UNumberRangeIdentityFallback</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Defines the behavior when the two numbers in the range are identical after rounding. </p>
<p>To programmatically detect when the identity fallback is used, compare the lower and upper BigDecimals via FormattedNumber.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000450">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
<dl class="section see"><dt>See also</dt><dd>NumberRangeFormatter </dd></dl>
</div>
</div>
<a id="a62f199f1dafc8f4f9d5a600da09ecc62"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a62f199f1dafc8f4f9d5a600da09ecc62">◆ </a></span>UNumberRangeIdentityResult</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037ed">UNumberRangeIdentityResult</a> <a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037ed">UNumberRangeIdentityResult</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Used in the result class FormattedNumberRange to indicate to the user whether the numbers formatted in the range were equal or not, and whether or not the identity fallback was applied. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000451">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
<dl class="section see"><dt>See also</dt><dd>NumberRangeFormatter </dd></dl>
</div>
</div>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a id="ad4ecbae149b64c966d58f4ce98c69bac"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad4ecbae149b64c966d58f4ce98c69bac">◆ </a></span>UNumberRangeCollapse</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="numberrangeformatter_8h.html#ad4ecbae149b64c966d58f4ce98c69bac">UNumberRangeCollapse</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Defines how to merge fields that are identical across the range sign. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000449">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="ad4ecbae149b64c966d58f4ce98c69bacaaa00a1585b0252eed103005abde47c9c"></a>UNUM_RANGE_COLLAPSE_AUTO </td><td class="fielddoc"><p>Use locale data and heuristics to determine how much of the string to collapse. </p>
<p>Could end up collapsing none, some, or all repeated pieces in a locale-sensitive way.</p>
<p>The heuristics used for this option are subject to change over time.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000452">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="ad4ecbae149b64c966d58f4ce98c69bacacef657e902c491ff0c00e90ee8c395d8"></a>UNUM_RANGE_COLLAPSE_NONE </td><td class="fielddoc"><p>Do not collapse any part of the number. </p>
<p>Example: "3.2 thousand kilograms – 5.3 thousand kilograms"</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000453">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="ad4ecbae149b64c966d58f4ce98c69bacac216344d57db814e81ced68d32bfef91"></a>UNUM_RANGE_COLLAPSE_UNIT </td><td class="fielddoc"><p>Collapse the unit part of the number, but not the notation, if present. </p>
<p>Example: "3.2 thousand – 5.3 thousand
kilograms"</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000454">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="ad4ecbae149b64c966d58f4ce98c69baca13c23178c1c516eb50308f6d01f54f48"></a>UNUM_RANGE_COLLAPSE_ALL </td><td class="fielddoc"><p>Collapse any field that is equal across the range sign. </p>
<p>May introduce ambiguity on the magnitude of the number. Example: "3.2 – 5.3 thousand kilograms"</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000455">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</td></tr>
</table>
<p class="definition">Definition at line <a class="el" href="numberrangeformatter_8h_source.html#l00049">49</a> of file <a class="el" href="numberrangeformatter_8h_source.html">numberrangeformatter.h</a>.</p>
</div>
</div>
<a id="aa0154b4142afeed438c7be50a530ebd1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa0154b4142afeed438c7be50a530ebd1">◆ </a></span>UNumberRangeIdentityFallback</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="numberrangeformatter_8h.html#aa0154b4142afeed438c7be50a530ebd1">UNumberRangeIdentityFallback</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Defines the behavior when the two numbers in the range are identical after rounding. </p>
<p>To programmatically detect when the identity fallback is used, compare the lower and upper BigDecimals via FormattedNumber.</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000450">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
<dl class="section see"><dt>See also</dt><dd>NumberRangeFormatter </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="aa0154b4142afeed438c7be50a530ebd1acab9a2adc00e1fa304243e66bc9f65a5"></a>UNUM_IDENTITY_FALLBACK_SINGLE_VALUE </td><td class="fielddoc"><p>Show the number as a single value rather than a range. </p>
<p>Example: "$5"</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000456">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="aa0154b4142afeed438c7be50a530ebd1a897059d33ea5187c9f721a80ff04c585"></a>UNUM_IDENTITY_FALLBACK_APPROXIMATELY_OR_SINGLE_VALUE </td><td class="fielddoc"><p>Show the number using a locale-sensitive approximation pattern. </p>
<p>If the numbers were the same before rounding, show the single value. Example: "~$5" or "$5"</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000457">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="aa0154b4142afeed438c7be50a530ebd1a24fab0c8e99c610cb033b4ea99b21342"></a>UNUM_IDENTITY_FALLBACK_APPROXIMATELY </td><td class="fielddoc"><p>Show the number using a locale-sensitive approximation pattern. </p>
<p>Use the range pattern always, even if the inputs are the same. Example: "~$5"</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000458">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="aa0154b4142afeed438c7be50a530ebd1af3178fcbcfb6851718a59d8a453941c8"></a>UNUM_IDENTITY_FALLBACK_RANGE </td><td class="fielddoc"><p>Show the number as the range of two equal values. </p>
<p>Use the range pattern always, even if the inputs are the same. Example (with RangeCollapse.NONE): "$5 – $5"</p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000459">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
</td></tr>
</table>
<p class="definition">Definition at line <a class="el" href="numberrangeformatter_8h_source.html#l00091">91</a> of file <a class="el" href="numberrangeformatter_8h_source.html">numberrangeformatter.h</a>.</p>
</div>
</div>
<a id="a19ab840a2eaea75afefd7aed599037ed"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a19ab840a2eaea75afefd7aed599037ed">◆ </a></span>UNumberRangeIdentityResult</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="numberrangeformatter_8h.html#a19ab840a2eaea75afefd7aed599037ed">UNumberRangeIdentityResult</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Used in the result class FormattedNumberRange to indicate to the user whether the numbers formatted in the range were equal or not, and whether or not the identity fallback was applied. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000451">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
<dl class="section see"><dt>See also</dt><dd>NumberRangeFormatter </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a19ab840a2eaea75afefd7aed599037eda3317fc8c2690ee3a080a268a6195d00a"></a>UNUM_IDENTITY_RESULT_EQUAL_BEFORE_ROUNDING </td><td class="fielddoc"><p>Used to indicate that the two numbers in the range were equal, even before any rounding rules were applied. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000460">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
<dl class="section see"><dt>See also</dt><dd>NumberRangeFormatter </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a19ab840a2eaea75afefd7aed599037eda617bd9c6d436ac454b82005194b7467c"></a>UNUM_IDENTITY_RESULT_EQUAL_AFTER_ROUNDING </td><td class="fielddoc"><p>Used to indicate that the two numbers in the range were equal, but only after rounding rules were applied. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000461">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
<dl class="section see"><dt>See also</dt><dd>NumberRangeFormatter </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a19ab840a2eaea75afefd7aed599037eda3880f5ff12eefcf302b4984a79ec7ff7"></a>UNUM_IDENTITY_RESULT_NOT_EQUAL </td><td class="fielddoc"><p>Used to indicate that the two numbers in the range were not equal, even after rounding rules were applied. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000462">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 63 </dd></dl>
<dl class="section see"><dt>See also</dt><dd>NumberRangeFormatter </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a19ab840a2eaea75afefd7aed599037edad3879ac808169e0eaff934ecece4e54b"></a>UNUM_IDENTITY_RESULT_COUNT </td><td class="fielddoc"><p>The number of entries in this enum. </p>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000413">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. </dd></dl>
</td></tr>
</table>
<p class="definition">Definition at line <a class="el" href="numberrangeformatter_8h_source.html#l00131">131</a> of file <a class="el" href="numberrangeformatter_8h_source.html">numberrangeformatter.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>