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/ulistformatter_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/ulistformatter.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="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<div class="title">ulistformatter.h File Reference</div>  </div>
</div><!--header-->
<div class="contents">

<p>C API: Format a list in a locale-appropriate way.  
<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="uformattedvalue_8h_source.html">unicode/uformattedvalue.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="localpointer_8h_source.html">unicode/localpointer.h</a>&quot;</code><br />
</div>
<p><a href="ulistformatter_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:a31361ae522dfc4f114ef417724d7649d"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a></td></tr>
<tr class="memdesc:a31361ae522dfc4f114ef417724d7649d"><td class="mdescLeft">&#160;</td><td class="mdescRight">C typedef for struct UListFormatter.  <a href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">More...</a><br /></td></tr>
<tr class="separator:a31361ae522dfc4f114ef417724d7649d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aa906ee54be09c0fb627098a6a8ec7fec"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a></td></tr>
<tr class="memdesc:aa906ee54be09c0fb627098a6a8ec7fec"><td class="mdescLeft">&#160;</td><td class="mdescRight">Opaque struct to contain the results of a UListFormatter operation.  <a href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">More...</a><br /></td></tr>
<tr class="separator:aa906ee54be09c0fb627098a6a8ec7fec"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aa017e7540c38b3ca385a54e5d2285262"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="ulistformatter_8h.html#abcac2e1e255bf5e5b47eb1e6d237c547">UListFormatterField</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#aa017e7540c38b3ca385a54e5d2285262">UListFormatterField</a></td></tr>
<tr class="memdesc:aa017e7540c38b3ca385a54e5d2285262"><td class="mdescLeft">&#160;</td><td class="mdescRight">FieldPosition and <a class="el" href="structUFieldPosition.html" title="A struct representing a range of text containing a specific field.">UFieldPosition</a> selectors for format fields defined by ListFormatter.  <a href="ulistformatter_8h.html#aa017e7540c38b3ca385a54e5d2285262">More...</a><br /></td></tr>
<tr class="separator:aa017e7540c38b3ca385a54e5d2285262"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae5cbefd95f4f0412a2215e428f24e830"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1b">UListFormatterType</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#ae5cbefd95f4f0412a2215e428f24e830">UListFormatterType</a></td></tr>
<tr class="memdesc:ae5cbefd95f4f0412a2215e428f24e830"><td class="mdescLeft">&#160;</td><td class="mdescRight">Type of meaning expressed by the list.  <a href="ulistformatter_8h.html#ae5cbefd95f4f0412a2215e428f24e830">More...</a><br /></td></tr>
<tr class="separator:ae5cbefd95f4f0412a2215e428f24e830"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a7eb2df370e2f1efdb81c8535dd653025"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339b">UListFormatterWidth</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#a7eb2df370e2f1efdb81c8535dd653025">UListFormatterWidth</a></td></tr>
<tr class="memdesc:a7eb2df370e2f1efdb81c8535dd653025"><td class="mdescLeft">&#160;</td><td class="mdescRight">Verbosity level of the list patterns.  <a href="ulistformatter_8h.html#a7eb2df370e2f1efdb81c8535dd653025">More...</a><br /></td></tr>
<tr class="separator:a7eb2df370e2f1efdb81c8535dd653025"><td class="memSeparator" colspan="2">&#160;</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:abcac2e1e255bf5e5b47eb1e6d237c547"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#abcac2e1e255bf5e5b47eb1e6d237c547">UListFormatterField</a> { <a class="el" href="ulistformatter_8h.html#abcac2e1e255bf5e5b47eb1e6d237c547a809e10d981272cfbd78207948ab65226">ULISTFMT_LITERAL_FIELD</a>
, <a class="el" href="ulistformatter_8h.html#abcac2e1e255bf5e5b47eb1e6d237c547a3f1fd7058c5d46d403b0f5d69d119fd1">ULISTFMT_ELEMENT_FIELD</a>
 }</td></tr>
<tr class="memdesc:abcac2e1e255bf5e5b47eb1e6d237c547"><td class="mdescLeft">&#160;</td><td class="mdescRight">FieldPosition and <a class="el" href="structUFieldPosition.html" title="A struct representing a range of text containing a specific field.">UFieldPosition</a> selectors for format fields defined by ListFormatter.  <a href="ulistformatter_8h.html#abcac2e1e255bf5e5b47eb1e6d237c547">More...</a><br /></td></tr>
<tr class="separator:abcac2e1e255bf5e5b47eb1e6d237c547"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af311a9fd3c2f3124bb448cf2ac8d1f1b"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1b">UListFormatterType</a> { <a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1ba38b64ea00613be77023ba3e6370a8109">ULISTFMT_TYPE_AND</a>
, <a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1ba1c362cbd125869013e977bec3f6679ac">ULISTFMT_TYPE_OR</a>
, <a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1bacfc7cbb5bb6482dd154b664a5f52e65e">ULISTFMT_TYPE_UNITS</a>
 }</td></tr>
<tr class="memdesc:af311a9fd3c2f3124bb448cf2ac8d1f1b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Type of meaning expressed by the list.  <a href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1b">More...</a><br /></td></tr>
<tr class="separator:af311a9fd3c2f3124bb448cf2ac8d1f1b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aba6fac43a1622318978e1ee68ecf339b"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339b">UListFormatterWidth</a> { <a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339baa211c4478f863988043878c0127e6a04">ULISTFMT_WIDTH_WIDE</a>
, <a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339baf705b01c074d9662e571351d46677ee2">ULISTFMT_WIDTH_SHORT</a>
, <a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339ba0c2ccff47ec0a5e8bf0af43b58f3b80f">ULISTFMT_WIDTH_NARROW</a>
 }</td></tr>
<tr class="memdesc:aba6fac43a1622318978e1ee68ecf339b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Verbosity level of the list patterns.  <a href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339b">More...</a><br /></td></tr>
<tr class="separator:aba6fac43a1622318978e1ee68ecf339b"><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:a5f6947155fff8847fd272d95a98b1347"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#a5f6947155fff8847fd272d95a98b1347">ulistfmt_open</a> (const char *locale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a5f6947155fff8847fd272d95a98b1347"><td class="mdescLeft">&#160;</td><td class="mdescRight">Open a new UListFormatter object using the rules for a given locale.  <a href="ulistformatter_8h.html#a5f6947155fff8847fd272d95a98b1347">More...</a><br /></td></tr>
<tr class="separator:a5f6947155fff8847fd272d95a98b1347"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a0a95b2a5d6e63afe93bd9503e4ee072c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#a0a95b2a5d6e63afe93bd9503e4ee072c">ulistfmt_openForType</a> (const char *locale, <a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1b">UListFormatterType</a> type, <a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339b">UListFormatterWidth</a> width, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a0a95b2a5d6e63afe93bd9503e4ee072c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Open a new UListFormatter object appropriate for the given locale, list type, and style.  <a href="ulistformatter_8h.html#a0a95b2a5d6e63afe93bd9503e4ee072c">More...</a><br /></td></tr>
<tr class="separator:a0a95b2a5d6e63afe93bd9503e4ee072c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:afd2c7571c7a5ddfb7b92863dbe66554f"><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="ulistformatter_8h.html#afd2c7571c7a5ddfb7b92863dbe66554f">ulistfmt_close</a> (<a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> *listfmt)</td></tr>
<tr class="memdesc:afd2c7571c7a5ddfb7b92863dbe66554f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Close a UListFormatter object.  <a href="ulistformatter_8h.html#afd2c7571c7a5ddfb7b92863dbe66554f">More...</a><br /></td></tr>
<tr class="separator:afd2c7571c7a5ddfb7b92863dbe66554f"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2838aaaa4f9798eae85b4f52526b86e2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="ulistformatter_8h.html#a2838aaaa4f9798eae85b4f52526b86e2">ulistfmt_openResult</a> (<a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *ec)</td></tr>
<tr class="memdesc:a2838aaaa4f9798eae85b4f52526b86e2"><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates an object to hold the result of a UListFormatter operation.  <a href="ulistformatter_8h.html#a2838aaaa4f9798eae85b4f52526b86e2">More...</a><br /></td></tr>
<tr class="separator:a2838aaaa4f9798eae85b4f52526b86e2"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a04d2715ab099d6c3959eabc8d4cad2f1"><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="ulistformatter_8h.html#a04d2715ab099d6c3959eabc8d4cad2f1">ulistfmt_resultAsValue</a> (const <a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a> *uresult, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *ec)</td></tr>
<tr class="memdesc:a04d2715ab099d6c3959eabc8d4cad2f1"><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns a representation of a UFormattedList as a UFormattedValue, which can be subsequently passed to any API requiring that type.  <a href="ulistformatter_8h.html#a04d2715ab099d6c3959eabc8d4cad2f1">More...</a><br /></td></tr>
<tr class="separator:a04d2715ab099d6c3959eabc8d4cad2f1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a17563b940bff4584710a6621e4efbd40"><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="ulistformatter_8h.html#a17563b940bff4584710a6621e4efbd40">ulistfmt_closeResult</a> (<a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a> *uresult)</td></tr>
<tr class="memdesc:a17563b940bff4584710a6621e4efbd40"><td class="mdescLeft">&#160;</td><td class="mdescRight">Releases the UFormattedList created by <a class="el" href="ulistformatter_8h.html#a2838aaaa4f9798eae85b4f52526b86e2" title="Creates an object to hold the result of a UListFormatter operation.">ulistfmt_openResult()</a>.  <a href="ulistformatter_8h.html#a17563b940bff4584710a6621e4efbd40">More...</a><br /></td></tr>
<tr class="separator:a17563b940bff4584710a6621e4efbd40"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:acfa3b0da479de369cc96bec48a880f9f"><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="ulistformatter_8h.html#acfa3b0da479de369cc96bec48a880f9f">ulistfmt_format</a> (const <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> *listfmt, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *const strings[], const int32_t *stringLengths, int32_t stringCount, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *result, int32_t resultCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:acfa3b0da479de369cc96bec48a880f9f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Formats a list of strings using the conventions established for the UListFormatter object.  <a href="ulistformatter_8h.html#acfa3b0da479de369cc96bec48a880f9f">More...</a><br /></td></tr>
<tr class="separator:acfa3b0da479de369cc96bec48a880f9f"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aa0beefe4c7451777f9d525ac55a675a5"><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="ulistformatter_8h.html#aa0beefe4c7451777f9d525ac55a675a5">ulistfmt_formatStringsToResult</a> (const <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> *listfmt, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *const strings[], const int32_t *stringLengths, int32_t stringCount, <a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a> *uresult, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:aa0beefe4c7451777f9d525ac55a675a5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Formats a list of strings to a UFormattedList, which exposes more information than the string exported by <a class="el" href="ulistformatter_8h.html#acfa3b0da479de369cc96bec48a880f9f" title="Formats a list of strings using the conventions established for the UListFormatter object.">ulistfmt_format()</a>.  <a href="ulistformatter_8h.html#aa0beefe4c7451777f9d525ac55a675a5">More...</a><br /></td></tr>
<tr class="separator:aa0beefe4c7451777f9d525ac55a675a5"><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: Format a list in a locale-appropriate way. </p>
<p>A UListFormatter is used to format a list of items in a locale-appropriate way, using data from CLDR. Example: Input data ["Alice", "Bob", "Charlie", "Delta"] will be formatted as "Alice, Bob, Charlie, and Delta" in English. </p>

<p class="definition">Definition in file <a class="el" href="ulistformatter_8h_source.html">ulistformatter.h</a>.</p>
</div><h2 class="groupheader">Typedef Documentation</h2>
<a id="aa906ee54be09c0fb627098a6a8ec7fec"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa906ee54be09c0fb627098a6a8ec7fec">&#9670;&nbsp;</a></span>UFormattedList</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a> <a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Opaque struct to contain the results of a UListFormatter operation. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006405">Stable:</a></b></dt><dd>ICU 64 </dd></dl>

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

</div>
</div>
<a id="a31361ae522dfc4f114ef417724d7649d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a31361ae522dfc4f114ef417724d7649d">&#9670;&nbsp;</a></span>UListFormatter</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>C typedef for struct UListFormatter. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006404">Stable:</a></b></dt><dd>ICU 55 </dd></dl>

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

</div>
</div>
<a id="aa017e7540c38b3ca385a54e5d2285262"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa017e7540c38b3ca385a54e5d2285262">&#9670;&nbsp;</a></span>UListFormatterField</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="ulistformatter_8h.html#abcac2e1e255bf5e5b47eb1e6d237c547">UListFormatterField</a> <a class="el" href="ulistformatter_8h.html#abcac2e1e255bf5e5b47eb1e6d237c547">UListFormatterField</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>FieldPosition and <a class="el" href="structUFieldPosition.html" title="A struct representing a range of text containing a specific field.">UFieldPosition</a> selectors for format fields defined by ListFormatter. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006406">Stable:</a></b></dt><dd>ICU 63 </dd></dl>

</div>
</div>
<a id="ae5cbefd95f4f0412a2215e428f24e830"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae5cbefd95f4f0412a2215e428f24e830">&#9670;&nbsp;</a></span>UListFormatterType</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1b">UListFormatterType</a> <a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1b">UListFormatterType</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Type of meaning expressed by the list. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006407">Stable:</a></b></dt><dd>ICU 67 </dd></dl>

</div>
</div>
<a id="a7eb2df370e2f1efdb81c8535dd653025"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a7eb2df370e2f1efdb81c8535dd653025">&#9670;&nbsp;</a></span>UListFormatterWidth</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339b">UListFormatterWidth</a> <a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339b">UListFormatterWidth</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Verbosity level of the list patterns. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006408">Stable:</a></b></dt><dd>ICU 67 </dd></dl>

</div>
</div>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a id="abcac2e1e255bf5e5b47eb1e6d237c547"></a>
<h2 class="memtitle"><span class="permalink"><a href="#abcac2e1e255bf5e5b47eb1e6d237c547">&#9670;&nbsp;</a></span>UListFormatterField</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="ulistformatter_8h.html#abcac2e1e255bf5e5b47eb1e6d237c547">UListFormatterField</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>FieldPosition and <a class="el" href="structUFieldPosition.html" title="A struct representing a range of text containing a specific field.">UFieldPosition</a> selectors for format fields defined by ListFormatter. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006406">Stable:</a></b></dt><dd>ICU 63 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="abcac2e1e255bf5e5b47eb1e6d237c547a809e10d981272cfbd78207948ab65226"></a>ULISTFMT_LITERAL_FIELD&#160;</td><td class="fielddoc"><p>The literal text in the result which came from the resources. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006417">Stable:</a></b></dt><dd>ICU 63 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="abcac2e1e255bf5e5b47eb1e6d237c547a3f1fd7058c5d46d403b0f5d69d119fd1"></a>ULISTFMT_ELEMENT_FIELD&#160;</td><td class="fielddoc"><p>The element text in the result which came from the input strings. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006418">Stable:</a></b></dt><dd>ICU 63 </dd></dl>
</td></tr>
</table>

<p class="definition">Definition at line <a class="el" href="ulistformatter_8h_source.html#l00052">52</a> of file <a class="el" href="ulistformatter_8h_source.html">ulistformatter.h</a>.</p>

</div>
</div>
<a id="af311a9fd3c2f3124bb448cf2ac8d1f1b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af311a9fd3c2f3124bb448cf2ac8d1f1b">&#9670;&nbsp;</a></span>UListFormatterType</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1b">UListFormatterType</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Type of meaning expressed by the list. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006407">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="af311a9fd3c2f3124bb448cf2ac8d1f1ba38b64ea00613be77023ba3e6370a8109"></a>ULISTFMT_TYPE_AND&#160;</td><td class="fielddoc"><p>Conjunction formatting, e.g. </p>
<p>"Alice, Bob, Charlie, and Delta".</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006419">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="af311a9fd3c2f3124bb448cf2ac8d1f1ba1c362cbd125869013e977bec3f6679ac"></a>ULISTFMT_TYPE_OR&#160;</td><td class="fielddoc"><p>Disjunction (or alternative, or simply one of) formatting, e.g. </p>
<p>"Alice, Bob, Charlie, or Delta".</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006420">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="af311a9fd3c2f3124bb448cf2ac8d1f1bacfc7cbb5bb6482dd154b664a5f52e65e"></a>ULISTFMT_TYPE_UNITS&#160;</td><td class="fielddoc"><p>Formatting of a list of values with units, e.g. </p>
<p>"5 pounds, 12 ounces".</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006421">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
</table>

<p class="definition">Definition at line <a class="el" href="ulistformatter_8h_source.html#l00070">70</a> of file <a class="el" href="ulistformatter_8h_source.html">ulistformatter.h</a>.</p>

</div>
</div>
<a id="aba6fac43a1622318978e1ee68ecf339b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aba6fac43a1622318978e1ee68ecf339b">&#9670;&nbsp;</a></span>UListFormatterWidth</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339b">UListFormatterWidth</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Verbosity level of the list patterns. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006408">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="aba6fac43a1622318978e1ee68ecf339baa211c4478f863988043878c0127e6a04"></a>ULISTFMT_WIDTH_WIDE&#160;</td><td class="fielddoc"><p>Use list formatting with full words (no abbreviations) when possible. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006422">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="aba6fac43a1622318978e1ee68ecf339baf705b01c074d9662e571351d46677ee2"></a>ULISTFMT_WIDTH_SHORT&#160;</td><td class="fielddoc"><p>Use list formatting of typical length. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006423">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="aba6fac43a1622318978e1ee68ecf339ba0c2ccff47ec0a5e8bf0af43b58f3b80f"></a>ULISTFMT_WIDTH_NARROW&#160;</td><td class="fielddoc"><p>Use list formatting of the shortest possible length. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006424">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
</table>

<p class="definition">Definition at line <a class="el" href="ulistformatter_8h_source.html#l00099">99</a> of file <a class="el" href="ulistformatter_8h_source.html">ulistformatter.h</a>.</p>

</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="afd2c7571c7a5ddfb7b92863dbe66554f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#afd2c7571c7a5ddfb7b92863dbe66554f">&#9670;&nbsp;</a></span>ulistfmt_close()</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 ulistfmt_close </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> *&#160;</td>
          <td class="paramname"><em>listfmt</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Close a UListFormatter object. </p>
<p>Once closed it may no longer be used. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">listfmt</td><td>The UListFormatter object to close. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006411">Stable:</a></b></dt><dd>ICU 55 </dd></dl>

</div>
</div>
<a id="a17563b940bff4584710a6621e4efbd40"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a17563b940bff4584710a6621e4efbd40">&#9670;&nbsp;</a></span>ulistfmt_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 ulistfmt_closeResult </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a> *&#160;</td>
          <td class="paramname"><em>uresult</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Releases the UFormattedList created by <a class="el" href="ulistformatter_8h.html#a2838aaaa4f9798eae85b4f52526b86e2" title="Creates an object to hold the result of a UListFormatter operation.">ulistfmt_openResult()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">uresult</td><td>The object to release. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006414">Stable:</a></b></dt><dd>ICU 64 </dd></dl>

</div>
</div>
<a id="acfa3b0da479de369cc96bec48a880f9f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#acfa3b0da479de369cc96bec48a880f9f">&#9670;&nbsp;</a></span>ulistfmt_format()</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 ulistfmt_format </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> *&#160;</td>
          <td class="paramname"><em>listfmt</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *const&#160;</td>
          <td class="paramname"><em>strings</em>[], </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const int32_t *&#160;</td>
          <td class="paramname"><em>stringLengths</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>stringCount</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>result</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>resultCapacity</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>status</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Formats a list of strings using the conventions established for the UListFormatter object. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">listfmt</td><td>The UListFormatter object specifying the list conventions. </td></tr>
    <tr><td class="paramname">strings</td><td>An array of pointers to UChar strings; the array length is specified by stringCount. Must be non-NULL if stringCount &gt; 0. </td></tr>
    <tr><td class="paramname">stringLengths</td><td>An array of string lengths corresponding to the strings[] parameter; any individual length value may be negative to indicate that the corresponding strings[] entry is 0-terminated, or stringLengths itself may be NULL if all of the strings are 0-terminated. If non-NULL, the stringLengths array must have stringCount entries. </td></tr>
    <tr><td class="paramname">stringCount</td><td>the number of entries in strings[], and the number of entries in the stringLengths array if it is not NULL. Must be &gt;= 0. </td></tr>
    <tr><td class="paramname">result</td><td>A pointer to a buffer to receive the formatted list. </td></tr>
    <tr><td class="paramname">resultCapacity</td><td>The maximum size of result. </td></tr>
    <tr><td class="paramname">status</td><td>A pointer to a standard ICU UErrorCode (input/output parameter). Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success?">U_SUCCESS()</a> test, or else the function returns immediately. The caller should check its output value with <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure?">U_FAILURE()</a>, or use with function chaining (see User Guide for details). </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The total buffer size needed; if greater than resultLength, the output was truncated. May be &lt;=0 if unable to determine the total buffer size needed (e.g. for illegal arguments). </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006415">Stable:</a></b></dt><dd>ICU 55 </dd></dl>

</div>
</div>
<a id="aa0beefe4c7451777f9d525ac55a675a5"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa0beefe4c7451777f9d525ac55a675a5">&#9670;&nbsp;</a></span>ulistfmt_formatStringsToResult()</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 ulistfmt_formatStringsToResult </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a> *&#160;</td>
          <td class="paramname"><em>listfmt</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *const&#160;</td>
          <td class="paramname"><em>strings</em>[], </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const int32_t *&#160;</td>
          <td class="paramname"><em>stringLengths</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>stringCount</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</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>status</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Formats a list of strings to a UFormattedList, which exposes more information than the string exported by <a class="el" href="ulistformatter_8h.html#acfa3b0da479de369cc96bec48a880f9f" title="Formats a list of strings using the conventions established for the UListFormatter object.">ulistfmt_format()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">listfmt</td><td>The UListFormatter object specifying the list conventions. </td></tr>
    <tr><td class="paramname">strings</td><td>An array of pointers to UChar strings; the array length is specified by stringCount. Must be non-NULL if stringCount &gt; 0. </td></tr>
    <tr><td class="paramname">stringLengths</td><td>An array of string lengths corresponding to the strings[] parameter; any individual length value may be negative to indicate that the corresponding strings[] entry is 0-terminated, or stringLengths itself may be NULL if all of the strings are 0-terminated. If non-NULL, the stringLengths array must have stringCount entries. </td></tr>
    <tr><td class="paramname">stringCount</td><td>the number of entries in strings[], and the number of entries in the stringLengths array if it is not NULL. Must be &gt;= 0. </td></tr>
    <tr><td class="paramname">uresult</td><td>The object in which to store the result of the list formatting operation. See <a class="el" href="ulistformatter_8h.html#a2838aaaa4f9798eae85b4f52526b86e2" title="Creates an object to hold the result of a UListFormatter operation.">ulistfmt_openResult()</a>. </td></tr>
    <tr><td class="paramname">status</td><td>Error code set if an error occurred during formatting. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006416">Stable:</a></b></dt><dd>ICU 64 </dd></dl>

</div>
</div>
<a id="a5f6947155fff8847fd272d95a98b1347"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a5f6947155fff8847fd272d95a98b1347">&#9670;&nbsp;</a></span>ulistfmt_open()</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="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a>* ulistfmt_open </td>
          <td>(</td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>locale</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>status</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Open a new UListFormatter object using the rules for a given locale. </p>
<p>The object will be initialized with AND type and WIDE width.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">locale</td><td>The locale whose rules should be used; may be NULL for default locale. </td></tr>
    <tr><td class="paramname">status</td><td>A pointer to a standard ICU UErrorCode (input/output parameter). Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success?">U_SUCCESS()</a> test, or else the function returns immediately. The caller should check its output value with <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure?">U_FAILURE()</a>, or use with function chaining (see User Guide for details). </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to a UListFormatter object for the specified locale, or NULL if an error occurred. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006409">Stable:</a></b></dt><dd>ICU 55 </dd></dl>

</div>
</div>
<a id="a0a95b2a5d6e63afe93bd9503e4ee072c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a0a95b2a5d6e63afe93bd9503e4ee072c">&#9670;&nbsp;</a></span>ulistfmt_openForType()</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="ulistformatter_8h.html#a31361ae522dfc4f114ef417724d7649d">UListFormatter</a>* ulistfmt_openForType </td>
          <td>(</td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>locale</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="ulistformatter_8h.html#af311a9fd3c2f3124bb448cf2ac8d1f1b">UListFormatterType</a>&#160;</td>
          <td class="paramname"><em>type</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="ulistformatter_8h.html#aba6fac43a1622318978e1ee68ecf339b">UListFormatterWidth</a>&#160;</td>
          <td class="paramname"><em>width</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>status</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Open a new UListFormatter object appropriate for the given locale, list type, and style. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">locale</td><td>The locale whose rules should be used; may be NULL for default locale. </td></tr>
    <tr><td class="paramname">type</td><td>The type of list formatting to use. </td></tr>
    <tr><td class="paramname">width</td><td>The width of formatting to use. </td></tr>
    <tr><td class="paramname">status</td><td>A pointer to a standard ICU UErrorCode (input/output parameter). Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success?">U_SUCCESS()</a> test, or else the function returns immediately. The caller should check its output value with <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure?">U_FAILURE()</a>, or use with function chaining (see User Guide for details). </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to a UListFormatter object for the specified locale, or NULL if an error occurred. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006410">Stable:</a></b></dt><dd>ICU 67 </dd></dl>

</div>
</div>
<a id="a2838aaaa4f9798eae85b4f52526b86e2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2838aaaa4f9798eae85b4f52526b86e2">&#9670;&nbsp;</a></span>ulistfmt_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="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</a>* ulistfmt_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 UListFormatter 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="section return"><dt>Returns</dt><dd>A pointer needing ownership. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable006412">Stable:</a></b></dt><dd>ICU 64 </dd></dl>

</div>
</div>
<a id="a04d2715ab099d6c3959eabc8d4cad2f1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a04d2715ab099d6c3959eabc8d4cad2f1">&#9670;&nbsp;</a></span>ulistfmt_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>* ulistfmt_resultAsValue </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="ulistformatter_8h.html#aa906ee54be09c0fb627098a6a8ec7fec">UFormattedList</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 UFormattedList as a UFormattedValue, which can be subsequently passed to any API requiring that type. </p>
<p>The returned object is owned by the UFormattedList and is valid only as long as the UFormattedList is present and unchanged in memory.</p>
<p>You can think of this method as a cast between types.</p>
<p>When calling <a class="el" href="uformattedvalue_8h.html#adc62e7ad87db65ba86e4b72bfb232906" title="Iterates over field positions in the UFormattedValue.">ufmtval_nextPosition()</a>: The fields are returned from start to end. The special field category UFIELD_CATEGORY_LIST_SPAN is used to indicate which argument was inserted at the given position. The span category will always occur before the corresponding instance of UFIELD_CATEGORY_LIST in the <a class="el" href="uformattedvalue_8h.html#adc62e7ad87db65ba86e4b72bfb232906" title="Iterates over field positions in the UFormattedValue.">ufmtval_nextPosition()</a> iterator.</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#_stable006413">Stable:</a></b></dt><dd>ICU 64 </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`