<!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.11"/>
<title>ICU 58.2: unumsys.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 58.2
 <span id="projectnumber">58.2</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_b2f33c71d4aa5e7af42a1ca61ff5af1b.html">source</a></li><li class="navelem"><a class="el" href="dir_3c42bef9a3e7804b3d74ebb2809ebf86.html">i18n</a></li><li class="navelem"><a class="el" href="dir_fa4147b4d9cbc9ae7619e21b25239322.html">unicode</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#namespaces">Namespaces</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">unumsys.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>C API: UNumberingSystem, information about numbering systems.
<a href="#details">More...</a></p>
<div class="textblock"><code>#include "<a class="el" href="utypes_8h_source.html">unicode/utypes.h</a>"</code><br />
<code>#include "<a class="el" href="uenum_8h_source.html">unicode/uenum.h</a>"</code><br />
<code>#include "<a class="el" href="localpointer_8h_source.html">unicode/localpointer.h</a>"</code><br />
</div>
<p><a href="unumsys_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">  </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:a88d548043aa4d5eb8db18ed347878525"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a></td></tr>
<tr class="memdesc:a88d548043aa4d5eb8db18ed347878525"><td class="mdescLeft"> </td><td class="mdescRight">C typedef for struct UNumberingSystem. <a href="#a88d548043aa4d5eb8db18ed347878525">More...</a><br /></td></tr>
<tr class="separator:a88d548043aa4d5eb8db18ed347878525"><td class="memSeparator" colspan="2"> </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:a00d1ce36912faf92fa5bc4c68cfc9240"><td class="memItemLeft" align="right" valign="top"><a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#a00d1ce36912faf92fa5bc4c68cfc9240">unumsys_open</a> (const char *locale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a00d1ce36912faf92fa5bc4c68cfc9240"><td class="mdescLeft"> </td><td class="mdescRight">Opens a UNumberingSystem object using the default numbering system for the specified locale. <a href="#a00d1ce36912faf92fa5bc4c68cfc9240">More...</a><br /></td></tr>
<tr class="separator:a00d1ce36912faf92fa5bc4c68cfc9240"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0ea1553bf10507c05450c456651fb420"><td class="memItemLeft" align="right" valign="top"><a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#a0ea1553bf10507c05450c456651fb420">unumsys_openByName</a> (const char *name, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a0ea1553bf10507c05450c456651fb420"><td class="mdescLeft"> </td><td class="mdescRight">Opens a UNumberingSystem object using the name of one of the predefined numbering systems specified by CLDR and known to ICU, such as "latn", "arabext", or "hanidec"; the full list is returned by unumsys_openAvailableNames. <a href="#a0ea1553bf10507c05450c456651fb420">More...</a><br /></td></tr>
<tr class="separator:a0ea1553bf10507c05450c456651fb420"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a15d69e22ef8fa339fd09301547ef8197"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#a15d69e22ef8fa339fd09301547ef8197">unumsys_close</a> (<a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> *unumsys)</td></tr>
<tr class="memdesc:a15d69e22ef8fa339fd09301547ef8197"><td class="mdescLeft"> </td><td class="mdescRight">Close a UNumberingSystem object. <a href="#a15d69e22ef8fa339fd09301547ef8197">More...</a><br /></td></tr>
<tr class="separator:a15d69e22ef8fa339fd09301547ef8197"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a525bd824c7005f84ae94c55fc640a301"><td class="memItemLeft" align="right" valign="top"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#a525bd824c7005f84ae94c55fc640a301">unumsys_openAvailableNames</a> (<a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a525bd824c7005f84ae94c55fc640a301"><td class="mdescLeft"> </td><td class="mdescRight">Returns an enumeration over the names of all of the predefined numbering systems known to ICU. <a href="#a525bd824c7005f84ae94c55fc640a301">More...</a><br /></td></tr>
<tr class="separator:a525bd824c7005f84ae94c55fc640a301"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ab182c4f61a812457cf547fc122316b89"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#ab182c4f61a812457cf547fc122316b89">unumsys_getName</a> (const <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> *unumsys)</td></tr>
<tr class="memdesc:ab182c4f61a812457cf547fc122316b89"><td class="mdescLeft"> </td><td class="mdescRight">Returns the name of the specified UNumberingSystem object (if it is one of the predefined names known to ICU). <a href="#ab182c4f61a812457cf547fc122316b89">More...</a><br /></td></tr>
<tr class="separator:ab182c4f61a812457cf547fc122316b89"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad1188d3329f841c61edb6e01175f1cd8"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#ad1188d3329f841c61edb6e01175f1cd8">unumsys_isAlgorithmic</a> (const <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> *unumsys)</td></tr>
<tr class="memdesc:ad1188d3329f841c61edb6e01175f1cd8"><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the given UNumberingSystem object is for an algorithmic (not purely positional) system. <a href="#ad1188d3329f841c61edb6e01175f1cd8">More...</a><br /></td></tr>
<tr class="separator:ad1188d3329f841c61edb6e01175f1cd8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0bd1892ab90bb653768264b7610653cf"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#a0bd1892ab90bb653768264b7610653cf">unumsys_getRadix</a> (const <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> *unumsys)</td></tr>
<tr class="memdesc:a0bd1892ab90bb653768264b7610653cf"><td class="mdescLeft"> </td><td class="mdescRight">Returns the radix of the specified UNumberingSystem object. <a href="#a0bd1892ab90bb653768264b7610653cf">More...</a><br /></td></tr>
<tr class="separator:a0bd1892ab90bb653768264b7610653cf"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ae42f3788a4cc4418196f6529c780416b"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="unumsys_8h.html#ae42f3788a4cc4418196f6529c780416b">unumsys_getDescription</a> (const <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> *unumsys, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *result, int32_t resultLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:ae42f3788a4cc4418196f6529c780416b"><td class="mdescLeft"> </td><td class="mdescRight">Get the description string of the specified UNumberingSystem object. <a href="#ae42f3788a4cc4418196f6529c780416b">More...</a><br /></td></tr>
<tr class="separator:ae42f3788a4cc4418196f6529c780416b"><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: UNumberingSystem, information about numbering systems. </p>
<p>Defines numbering systems. A numbering system describes the scheme by which numbers are to be presented to the end user. In its simplest form, a numbering system describes the set of digit characters that are to be used to display numbers, such as Western digits, Thai digits, Arabic-Indic digits, etc., in a positional numbering system with a specified radix (typically 10). More complicated numbering systems are algorithmic in nature, and require use of an RBNF formatter (rule based number formatter), in order to calculate the characters to be displayed for a given number. Examples of algorithmic numbering systems include Roman numerals, Chinese numerals, and Hebrew numerals. Formatting rules for many commonly used numbering systems are included in the ICU package, based on the numbering system rules defined in CLDR. Alternate numbering systems can be specified to a locale by using the numbers locale keyword. </p>
<p>Definition in file <a class="el" href="unumsys_8h_source.html">unumsys.h</a>.</p>
</div><h2 class="groupheader">Typedef Documentation</h2>
<a class="anchor" id="a88d548043aa4d5eb8db18ed347878525"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>C typedef for struct UNumberingSystem. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005387">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
<p>Definition at line <a class="el" href="unumsys_8h_source.html#l00044">44</a> of file <a class="el" href="unumsys_8h_source.html">unumsys.h</a>.</p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="a15d69e22ef8fa339fd09301547ef8197"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void unumsys_close </td>
<td>(</td>
<td class="paramtype"><a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> * </td>
<td class="paramname"><em>unumsys</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Close a UNumberingSystem 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">unumsys</td><td>The UNumberingSystem object to close. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005390">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="ae42f3788a4cc4418196f6529c780416b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t unumsys_getDescription </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> * </td>
<td class="paramname"><em>unumsys</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>result</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>resultLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"><em>status</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the description string of the specified UNumberingSystem object. </p>
<p>For simple positional systems this is the ordered string of digits (with length matching the radix), e.g. "\u3007\u4E00\u4E8C\u4E09\u56DB\u4E94\u516D\u4E03\u516B\u4E5D" for "hanidec"; it would be "0123456789ABCDEF" for hexadecimal. For algorithmic systems this is the name of the RBNF ruleset used for formatting, e.g. "zh/SpelloutRules/%spellout-cardinal" for "hans" or "%greek-upper" for "grek". </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">unumsys</td><td>The UNumberingSystem whose description string is desired. </td></tr>
<tr><td class="paramname">result</td><td>A pointer to a buffer to receive the description string. </td></tr>
<tr><td class="paramname">resultLength</td><td>The maximum size of result. </td></tr>
<tr><td class="paramname">status</td><td>A pointer to a UErrorCode to receive any errors. </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. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005395">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="ab182c4f61a812457cf547fc122316b89"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* unumsys_getName </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> * </td>
<td class="paramname"><em>unumsys</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the name of the specified UNumberingSystem object (if it is one of the predefined names known to ICU). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">unumsys</td><td>The UNumberingSystem whose name is desired. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the name of the specified UNumberingSystem object, or NULL if the name is not one of the ICU predefined names. The pointer is only valid for the lifetime of the UNumberingSystem object. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005392">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a0bd1892ab90bb653768264b7610653cf"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t unumsys_getRadix </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> * </td>
<td class="paramname"><em>unumsys</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the radix of the specified UNumberingSystem object. </p>
<p>Simple positional numbering systems typically have radix 10, but might have a radix of e.g. 16 for hexadecimal. The radix is less well-defined for non-positional algorithmic systems. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">unumsys</td><td>The UNumberingSystem whose radix is desired. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The radix of the specified UNumberingSystem object. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005394">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="ad1188d3329f841c61edb6e01175f1cd8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> unumsys_isAlgorithmic </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a> * </td>
<td class="paramname"><em>unumsys</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns whether the given UNumberingSystem object is for an algorithmic (not purely positional) system. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">unumsys</td><td>The UNumberingSystem whose algorithmic status is desired. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>TRUE if the specified UNumberingSystem object is for an algorithmic system. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005393">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a00d1ce36912faf92fa5bc4c68cfc9240"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a>* unumsys_open </td>
<td>(</td>
<td class="paramtype">const char * </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> * </td>
<td class="paramname"><em>status</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Opens a UNumberingSystem object using the default numbering system for the specified locale. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">locale</td><td>The locale for which the default numbering system should be opened. </td></tr>
<tr><td class="paramname">status</td><td>A pointer to a UErrorCode to receive any errors. For example, this may be U_UNSUPPORTED_ERROR for a locale such as "en@numbers=xyz" that specifies a numbering system unknown to ICU. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A UNumberingSystem for the specified locale, or NULL if an error occurred. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005388">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a525bd824c7005f84ae94c55fc640a301"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a>* unumsys_openAvailableNames </td>
<td>(</td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"><em>status</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns an enumeration over the names of all of the predefined numbering systems known to ICU. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">status</td><td>A pointer to a UErrorCode to receive any errors. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to a UEnumeration that must be closed with <a class="el" href="uenum_8h.html#af8bf1abcf3a486f07ee3384c7fce89df" title="Disposes of resources in use by the iterator. ">uenum_close()</a>, or NULL if an error occurred. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005391">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a0ea1553bf10507c05450c456651fb420"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="unumsys_8h.html#a88d548043aa4d5eb8db18ed347878525">UNumberingSystem</a>* unumsys_openByName </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"><em>status</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Opens a UNumberingSystem object using the name of one of the predefined numbering systems specified by CLDR and known to ICU, such as "latn", "arabext", or "hanidec"; the full list is returned by unumsys_openAvailableNames. </p>
<p>Note that some of the names listed at <a href="http://unicode.org/repos/cldr/tags/latest/common/bcp47/number.xml">http://unicode.org/repos/cldr/tags/latest/common/bcp47/number.xml</a> - e.g. default, native, traditional, finance - do not identify specific numbering systems, but rather key values that may only be used as part of a locale, which in turn defines how they are mapped to a specific numbering system such as "latn" or "hant".</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>The name of the numbering system for which a UNumberingSystem object should be opened. </td></tr>
<tr><td class="paramname">status</td><td>A pointer to a UErrorCode to receive any errors. For example, this may be U_UNSUPPORTED_ERROR for a numbering system such as "xyz" that is unknown to ICU. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A UNumberingSystem for the specified name, or NULL if an error occurred. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005389">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</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.11
</small></address>
</body>
</html>
distrib
>
Mageia
>
6
>
armv5tl
>
media
>
core-release
>
by-pkgid
>
3a4e91bde08970529a0aa07935652fe8
>
files
>
1018
