PNG  IHDR pHYs   OiCCPPhotoshop ICC profilexڝSgTS=BKKoR RB&*! J!QEEȠQ, !{kּ> H3Q5 B.@ $pd!s#~<<+"x M0B\t8K@zB@F&S`cbP-`'{[! eDh;VEX0fK9-0IWfH  0Q){`##xFW<+*x<$9E[-qWW.(I+6aa@.y24x6_-"bbϫp@t~,/;m%h^ uf@Wp~<5j>{-]cK'Xto(hw?G%fIq^D$.Tʳ?D*A, `6B$BB dr`)B(Ͱ*`/@4Qhp.U=pa( Aa!ڈbX#!H$ ɈQ"K5H1RT UH=r9\F;2G1Q= C7F dt1r=6Ыhڏ>C03l0.B8, c˱" VcϱwE 6wB aAHXLXNH $4 7 Q'"K&b21XH,#/{C7$C2'ITFnR#,4H#dk9, +ȅ3![ b@qS(RjJ4e2AURݨT5ZBRQ4u9̓IKhhitݕNWGw Ljg(gwLӋT071oUX**| J&*/Tު UUT^S}FU3S ԖUPSSg;goT?~YYLOCQ_ cx,!k u5&|v*=9C3J3WRf?qtN (~))4L1e\kXHQG6EYAJ'\'GgSSݧ M=:.kDwn^Loy}/TmG X $ <5qo</QC]@Caaᄑ.ȽJtq]zۯ6iܟ4)Y3sCQ? 0k߬~OCOg#/c/Wװwa>>r><72Y_7ȷOo_C#dz%gA[z|!?:eAAA!h쐭!ΑiP~aa~ 'W?pX15wCsDDDޛg1O9-J5*>.j<74?.fYXXIlK9.*6nl {/]py.,:@LN8A*%w% yg"/6шC\*NH*Mz쑼5y$3,幄'L Lݛ:v m2=:1qB!Mggfvˬen/kY- BTZ(*geWf͉9+̳ې7ᒶKW-X潬j9(xoʿܔĹdff-[n ڴ VE/(ۻCɾUUMfeI?m]Nmq#׹=TR+Gw- 6 U#pDy  :v{vg/jBFS[b[O>zG499?rCd&ˮ/~јѡ򗓿m|x31^VwwO| (hSЧc3- cHRMz%u0`:o_F@8N ' p @8N@8}' p '#@8N@8N pQ9p!i~}|6-ӪG` VP.@*j>[ K^<֐Z]@8N'KQ<Q(`s" 'hgpKB`R@Dqj '  'P$a ( `D$Na L?u80e J,K˷NI'0eݷ(NI'؀ 2ipIIKp`:O'`ʤxB8Ѥx Ѥx $ $P6 :vRNb 'p,>NB 'P]-->P T+*^h& p '‰a ‰ (ĵt#u33;Nt̵'ޯ; [3W ~]0KH1q@8]O2]3*̧7# *p>us p _6]/}-4|t'|Smx= DoʾM×M_8!)6lq':l7!|4} '\ne t!=hnLn (~Dn\+‰_4k)0e@OhZ`F `.m1} 'vp{F`ON7Srx 'D˸nV`><;yMx!IS钦OM)Ե٥x 'DSD6bS8!" ODz#R >S8!7ّxEh0m$MIPHi$IvS8IN$I p$O8I,sk&I)$IN$Hi$I^Ah.p$MIN$IR8I·N "IF9Ah0m$MIN$IR8IN$I 3jIU;kO$ɳN$+ q.x* tEXtComment

Viewing File: /opt/alt/alt-nodejs18/root/usr/share/doc/alt-nodejs18-libicu-doc/uformattednumber_8h.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://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.9.1"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>ICU 74.2: i18n/unicode/uformattednumber.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 74.2
   &#160;<span id="projectnumber">74.2</span>
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.1 -->
<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&amp;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="#namespaces">Namespaces</a> &#124;
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<div class="title">uformattednumber.h File Reference</div>  </div>
</div><!--header-->
<div class="contents">

<p>C API: Formatted number result from various number formatting functions.  
<a href="#details">More...</a></p>
<div class="textblock"><code>#include &quot;<a class="el" href="utypes_8h_source.html">unicode/utypes.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="ufieldpositer_8h_source.html">unicode/ufieldpositer.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="uformattedvalue_8h_source.html">unicode/uformattedvalue.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="umisc_8h_source.html">unicode/umisc.h</a>&quot;</code><br />
</div>
<p><a href="uformattednumber_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="namespaces"></a>
Namespaces</h2></td></tr>
<tr class="memitem:namespaceicu"><td class="memItemLeft" align="right" valign="top"> &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceicu.html">icu</a></td></tr>
<tr class="memdesc:namespaceicu"><td class="mdescLeft">&#160;</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">&#160;</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:a9d4030bdc4dd1ec4de828bf1bcf4b1b6"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a></td></tr>
<tr class="memdesc:a9d4030bdc4dd1ec4de828bf1bcf4b1b6"><td class="mdescLeft">&#160;</td><td class="mdescRight">C-compatible version of <a class="el" href="classicu_1_1number_1_1FormattedNumber.html" title="The result of a number formatting operation.">icu::number::FormattedNumber</a>.  <a href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">More...</a><br /></td></tr>
<tr class="separator:a9d4030bdc4dd1ec4de828bf1bcf4b1b6"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:aa9ff28f7feeda88f28f884308303086f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="uformattednumber_8h.html#aa9ff28f7feeda88f28f884308303086f">unumf_openResult</a> (<a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *ec)</td></tr>
<tr class="memdesc:aa9ff28f7feeda88f28f884308303086f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates an object to hold the result of a UNumberFormatter operation.  <a href="uformattednumber_8h.html#aa9ff28f7feeda88f28f884308303086f">More...</a><br /></td></tr>
<tr class="separator:aa9ff28f7feeda88f28f884308303086f"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a1c7b5bb3f964a19f788ae4938d4067aa"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> const <a class="el" href="uformattedvalue_8h.html#af64a1850f6a746a6130aa79ae7fed97f">UFormattedValue</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="uformattednumber_8h.html#a1c7b5bb3f964a19f788ae4938d4067aa">unumf_resultAsValue</a> (const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *uresult, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *ec)</td></tr>
<tr class="memdesc:a1c7b5bb3f964a19f788ae4938d4067aa"><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns a representation of a UFormattedNumber as a UFormattedValue, which can be subsequently passed to any API requiring that type.  <a href="uformattednumber_8h.html#a1c7b5bb3f964a19f788ae4938d4067aa">More...</a><br /></td></tr>
<tr class="separator:a1c7b5bb3f964a19f788ae4938d4067aa"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aba145957d66cd7c5d1b5bb8ba9373bf3"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="uformattednumber_8h.html#aba145957d66cd7c5d1b5bb8ba9373bf3">unumf_resultToString</a> (const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *uresult, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *buffer, int32_t bufferCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *ec)</td></tr>
<tr class="memdesc:aba145957d66cd7c5d1b5bb8ba9373bf3"><td class="mdescLeft">&#160;</td><td class="mdescRight">Extracts the result number string out of a UFormattedNumber to a UChar buffer if possible.  <a href="uformattednumber_8h.html#aba145957d66cd7c5d1b5bb8ba9373bf3">More...</a><br /></td></tr>
<tr class="separator:aba145957d66cd7c5d1b5bb8ba9373bf3"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ada28ff555752eca3a338d83d6c8e13f2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="uformattednumber_8h.html#ada28ff555752eca3a338d83d6c8e13f2">unumf_resultNextFieldPosition</a> (const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *uresult, <a class="el" href="structUFieldPosition.html">UFieldPosition</a> *ufpos, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *ec)</td></tr>
<tr class="memdesc:ada28ff555752eca3a338d83d6c8e13f2"><td class="mdescLeft">&#160;</td><td class="mdescRight">Determines the start and end indices of the next occurrence of the given <em>field</em> in the output string.  <a href="uformattednumber_8h.html#ada28ff555752eca3a338d83d6c8e13f2">More...</a><br /></td></tr>
<tr class="separator:ada28ff555752eca3a338d83d6c8e13f2"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af943d5997bfa87705de3070b91691892"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="uformattednumber_8h.html#af943d5997bfa87705de3070b91691892">unumf_resultGetAllFieldPositions</a> (const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *uresult, <a class="el" href="ufieldpositer_8h.html#ae6dcb81a72e2304609d93ad389c16d19">UFieldPositionIterator</a> *ufpositer, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *ec)</td></tr>
<tr class="memdesc:af943d5997bfa87705de3070b91691892"><td class="mdescLeft">&#160;</td><td class="mdescRight">Populates the given iterator with all fields in the formatted output string.  <a href="uformattednumber_8h.html#af943d5997bfa87705de3070b91691892">More...</a><br /></td></tr>
<tr class="separator:af943d5997bfa87705de3070b91691892"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aaa2bbd8847dc6e6b704087418beb401e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="uformattednumber_8h.html#aaa2bbd8847dc6e6b704087418beb401e">unumf_resultToDecimalNumber</a> (const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *uresult, char *dest, int32_t destCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *ec)</td></tr>
<tr class="memdesc:aaa2bbd8847dc6e6b704087418beb401e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Extracts the formatted number as a "numeric string" conforming to the syntax defined in the Decimal Arithmetic Specification, available at <a href="http://speleotrove.com/decimal">http://speleotrove.com/decimal</a>.  <a href="uformattednumber_8h.html#aaa2bbd8847dc6e6b704087418beb401e">More...</a><br /></td></tr>
<tr class="separator:aaa2bbd8847dc6e6b704087418beb401e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a48f535cfb359176bf47e69498a8ac0a9"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="uformattednumber_8h.html#a48f535cfb359176bf47e69498a8ac0a9">unumf_closeResult</a> (<a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *uresult)</td></tr>
<tr class="memdesc:a48f535cfb359176bf47e69498a8ac0a9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Releases the UFormattedNumber created by <a class="el" href="uformattednumber_8h.html#aa9ff28f7feeda88f28f884308303086f" title="Creates an object to hold the result of a UNumberFormatter operation.">unumf_openResult()</a>.  <a href="uformattednumber_8h.html#a48f535cfb359176bf47e69498a8ac0a9">More...</a><br /></td></tr>
<tr class="separator:a48f535cfb359176bf47e69498a8ac0a9"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>C API: Formatted number result from various number formatting functions. </p>
<p>Create a <code>UFormattedNumber</code> to hold the result of a number formatting operation. The same <code>UFormattedNumber</code> can be reused multiple times.</p>
<pre>
<a class="el" href="classLocalUFormattedNumberPointer.html" title="&quot;Smart pointer&quot; class; closes a UFormattedNumber via unumf_closeResult().">LocalUFormattedNumberPointer</a> uresult(unumf_openResult(status));

// pass uresult.getAlias() to your number formatter

int32_t length;
const UChar* s = ufmtval_getString(unumf_resultAsValue(uresult.getAlias(), status), &amp;length, status));

// The string result is in `s` with the given `length` (it is also NUL-terminated).
</pre> 
<p class="definition">Definition in file <a class="el" href="uformattednumber_8h_source.html">uformattednumber.h</a>.</p>
</div><h2 class="groupheader">Typedef Documentation</h2>
<a id="a9d4030bdc4dd1ec4de828bf1bcf4b1b6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">&#9670;&nbsp;</a></span>UFormattedNumber</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>C-compatible version of <a class="el" href="classicu_1_1number_1_1FormattedNumber.html" title="The result of a number formatting operation.">icu::number::FormattedNumber</a>. </p>
<p>NOTE: This is a C-compatible API; C++ users should build against <a class="el" href="numberformatter_8h.html" title="C++ API: All-in-one formatter for localized numbers, currencies, and units.">numberformatter.h</a> instead.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006360">Stable:</a></b></dt><dd>ICU 62 </dd></dl>

<p class="definition">Definition at line <a class="el" href="uformattednumber_8h_source.html#l00001">1</a> of file <a class="el" href="uformattednumber_8h_source.html">uformattednumber.h</a>.</p>

</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="a48f535cfb359176bf47e69498a8ac0a9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a48f535cfb359176bf47e69498a8ac0a9">&#9670;&nbsp;</a></span>unumf_closeResult()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void unumf_closeResult </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *&#160;</td>
          <td class="paramname"><em>uresult</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Releases the UFormattedNumber created by <a class="el" href="uformattednumber_8h.html#aa9ff28f7feeda88f28f884308303086f" title="Creates an object to hold the result of a UNumberFormatter operation.">unumf_openResult()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">uresult</td><td>An object created by <a class="el" href="uformattednumber_8h.html#aa9ff28f7feeda88f28f884308303086f" title="Creates an object to hold the result of a UNumberFormatter operation.">unumf_openResult()</a>. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006367">Stable:</a></b></dt><dd>ICU 62 </dd></dl>

</div>
</div>
<a id="aa9ff28f7feeda88f28f884308303086f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa9ff28f7feeda88f28f884308303086f">&#9670;&nbsp;</a></span>unumf_openResult()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a>* unumf_openResult </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *&#160;</td>
          <td class="paramname"><em>ec</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Creates an object to hold the result of a UNumberFormatter operation. </p>
<p>The object can be used repeatedly; it is cleared whenever passed to a format function.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">ec</td><td>Set if an error occurs. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006361">Stable:</a></b></dt><dd>ICU 62 </dd></dl>

</div>
</div>
<a id="a1c7b5bb3f964a19f788ae4938d4067aa"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1c7b5bb3f964a19f788ae4938d4067aa">&#9670;&nbsp;</a></span>unumf_resultAsValue()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> const <a class="el" href="uformattedvalue_8h.html#af64a1850f6a746a6130aa79ae7fed97f">UFormattedValue</a>* unumf_resultAsValue </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *&#160;</td>
          <td class="paramname"><em>uresult</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *&#160;</td>
          <td class="paramname"><em>ec</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Returns a representation of a UFormattedNumber as a UFormattedValue, which can be subsequently passed to any API requiring that type. </p>
<p>The returned object is owned by the UFormattedNumber and is valid only as long as the UFormattedNumber is present and unchanged in memory.</p>
<p>You can think of this method as a cast between types.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">uresult</td><td>The object containing the formatted string. </td></tr>
    <tr><td class="paramname">ec</td><td>Set if an error occurs. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A UFormattedValue owned by the input object. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006362">Stable:</a></b></dt><dd>ICU 64 </dd></dl>

</div>
</div>
<a id="af943d5997bfa87705de3070b91691892"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af943d5997bfa87705de3070b91691892">&#9670;&nbsp;</a></span>unumf_resultGetAllFieldPositions()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void unumf_resultGetAllFieldPositions </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *&#160;</td>
          <td class="paramname"><em>uresult</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="ufieldpositer_8h.html#ae6dcb81a72e2304609d93ad389c16d19">UFieldPositionIterator</a> *&#160;</td>
          <td class="paramname"><em>ufpositer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *&#160;</td>
          <td class="paramname"><em>ec</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Populates the given iterator with all fields in the formatted output string. </p>
<p>This allows you to determine the locations of the integer part, fraction part, and sign.</p>
<p>This is an alternative to the more powerful <a class="el" href="uformattedvalue_8h.html#adc62e7ad87db65ba86e4b72bfb232906">ufmtval_nextPosition</a> API.</p>
<p>If you need information on only one field, use <a class="el" href="uformattedvalue_8h.html#adc62e7ad87db65ba86e4b72bfb232906">ufmtval_nextPosition</a> or <a class="el" href="uformattednumber_8h.html#ada28ff555752eca3a338d83d6c8e13f2">unumf_resultNextFieldPosition</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">uresult</td><td>The object containing the formatted number. </td></tr>
    <tr><td class="paramname">ufpositer</td><td>A pointer to a UFieldPositionIterator created by <a class="el" href="ufieldpositer_8h.html#aaa1d156397c87dcea2d9f87c8308f8f6">ufieldpositer_open</a>. Iteration information already present in the UFieldPositionIterator is deleted, and the iterator is reset to apply to the fields in the formatted string created by this function call. The field values and indexes returned by <a class="el" href="ufieldpositer_8h.html#ad964aa76d2b332e9d3815aea4ce8cf91">ufieldpositer_next</a> represent fields denoted by the UNumberFormatFields enum. Fields are not returned in a guaranteed order. Fields cannot overlap, but they may nest. For example, 1234 could format as "1,234" which might consist of a grouping separator field for ',' and an integer field encompassing the entire string. </td></tr>
    <tr><td class="paramname">ec</td><td>Set if an error occurs. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006365">Stable:</a></b></dt><dd>ICU 62 </dd></dl>

</div>
</div>
<a id="ada28ff555752eca3a338d83d6c8e13f2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ada28ff555752eca3a338d83d6c8e13f2">&#9670;&nbsp;</a></span>unumf_resultNextFieldPosition()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> unumf_resultNextFieldPosition </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *&#160;</td>
          <td class="paramname"><em>uresult</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structUFieldPosition.html">UFieldPosition</a> *&#160;</td>
          <td class="paramname"><em>ufpos</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *&#160;</td>
          <td class="paramname"><em>ec</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Determines the start and end indices of the next occurrence of the given <em>field</em> in the output string. </p>
<p>This allows you to determine the locations of, for example, the integer part, fraction part, or symbols.</p>
<p>This is a simpler but less powerful alternative to <a class="el" href="uformattedvalue_8h.html#adc62e7ad87db65ba86e4b72bfb232906">ufmtval_nextPosition</a>.</p>
<p>If a field occurs just once, calling this method will find that occurrence and return it. If a field occurs multiple times, this method may be called repeatedly with the following pattern:</p>
<pre>
<a class="el" href="structUFieldPosition.html" title="A struct representing a range of text containing a specific field.">UFieldPosition</a> ufpos = {UNUM_GROUPING_SEPARATOR_FIELD, 0, 0};
while (unumf_resultNextFieldPosition(uresult, ufpos, &amp;ec)) {
  // do something with ufpos.
}
</pre><p>This method is useful if you know which field to query. If you want all available field position information, use <a class="el" href="uformattednumber_8h.html#af943d5997bfa87705de3070b91691892" title="Populates the given iterator with all fields in the formatted output string.">unumf_resultGetAllFieldPositions()</a>.</p>
<p>NOTE: All fields of the <a class="el" href="structUFieldPosition.html" title="A struct representing a range of text containing a specific field.">UFieldPosition</a> must be initialized before calling this method.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">uresult</td><td>The object containing the formatted number. </td></tr>
    <tr><td class="paramname">ufpos</td><td>Input+output variable. On input, the "field" property determines which field to look up, and the "endIndex" property determines where to begin the search. On output, the "beginIndex" field is set to the beginning of the first occurrence of the field after the input "endIndex", and "endIndex" is set to the end of that occurrence of the field (exclusive index). If a field position is not found, the FieldPosition is not changed and the method returns false. </td></tr>
    <tr><td class="paramname">ec</td><td>Set if an error occurs. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006364">Stable:</a></b></dt><dd>ICU 62 </dd></dl>

</div>
</div>
<a id="aaa2bbd8847dc6e6b704087418beb401e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aaa2bbd8847dc6e6b704087418beb401e">&#9670;&nbsp;</a></span>unumf_resultToDecimalNumber()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t unumf_resultToDecimalNumber </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *&#160;</td>
          <td class="paramname"><em>uresult</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">char *&#160;</td>
          <td class="paramname"><em>dest</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>destCapacity</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *&#160;</td>
          <td class="paramname"><em>ec</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Extracts the formatted number as a "numeric string" conforming to the syntax defined in the Decimal Arithmetic Specification, available at <a href="http://speleotrove.com/decimal">http://speleotrove.com/decimal</a>. </p>
<p>This endpoint is useful for obtaining the exact number being printed after scaling and rounding have been applied by the number formatter.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">uresult</td><td>The input object containing the formatted number. </td></tr>
    <tr><td class="paramname">dest</td><td>the 8-bit char buffer into which the decimal number is placed </td></tr>
    <tr><td class="paramname">destCapacity</td><td>The size, in chars, of the destination buffer. May be zero for precomputing the required size. </td></tr>
    <tr><td class="paramname">ec</td><td>receives any error status. If U_BUFFER_OVERFLOW_ERROR: Returns number of chars for preflighting. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Number of chars in the data. Does not include a trailing NUL. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006366">Stable:</a></b></dt><dd>ICU 68 </dd></dl>

</div>
</div>
<a id="aba145957d66cd7c5d1b5bb8ba9373bf3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aba145957d66cd7c5d1b5bb8ba9373bf3">&#9670;&nbsp;</a></span>unumf_resultToString()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t unumf_resultToString </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="uformattednumber_8h.html#a9d4030bdc4dd1ec4de828bf1bcf4b1b6">UFormattedNumber</a> *&#160;</td>
          <td class="paramname"><em>uresult</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *&#160;</td>
          <td class="paramname"><em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>bufferCapacity</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *&#160;</td>
          <td class="paramname"><em>ec</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Extracts the result number string out of a UFormattedNumber to a UChar buffer if possible. </p>
<p>If bufferCapacity is greater than the required length, a terminating NUL is written. If bufferCapacity is less than the required length, an error code is set.</p>
<p>Also see ufmtval_getString, which returns a NUL-terminated string: </p><pre class="fragment">int32_t len;
const UChar* str = ufmtval_getString(unumf_resultAsValue(uresult, &amp;ec), &amp;len, &amp;ec);
</pre><p> NOTE: This is a C-compatible API; C++ users should build against <a class="el" href="numberformatter_8h.html" title="C++ API: All-in-one formatter for localized numbers, currencies, and units.">numberformatter.h</a> instead.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">uresult</td><td>The object containing the formatted number. </td></tr>
    <tr><td class="paramname">buffer</td><td>Where to save the string output. </td></tr>
    <tr><td class="paramname">bufferCapacity</td><td>The number of UChars available in the buffer. </td></tr>
    <tr><td class="paramname">ec</td><td>Set if an error occurs. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The required length. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006363">Stable:</a></b></dt><dd>ICU 62 </dd></dl>

</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1
</small></address>
</body>
</html>
Back to Directory=ceiIENDB`