<!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"/>
<title>ICU 4.8.1.1: uloc.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="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</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 style="padding-left: 0.5em;">
<div id="projectname">ICU 4.8.1.1
 <span id="projectnumber">4.8.1.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.1.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<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="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</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>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark"> </span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(11)"><span class="SelectionMark"> </span>Pages</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_bdd9a5d540de89e9fe90efdfc6973a4f.html">common</a></li><li class="navelem"><a class="el" href="dir_f59c6450ff718ff1b085cfd1c36acbd7.html">unicode</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#define-members">Macros</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">uloc.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>C API: <a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a>.
<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/>
</div>
<p><a href="uloc_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:af1e4f6e75642a19b48985c3308dbda1e"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#af1e4f6e75642a19b48985c3308dbda1e">ULOC_CHINESE</a>   "zh"</td></tr>
<tr class="memdesc:af1e4f6e75642a19b48985c3308dbda1e"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#af1e4f6e75642a19b48985c3308dbda1e"></a><br/></td></tr>
<tr class="memitem:a7b3b387e4b7df73ab84087789e51793a"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a7b3b387e4b7df73ab84087789e51793a">ULOC_ENGLISH</a>   "en"</td></tr>
<tr class="memdesc:a7b3b387e4b7df73ab84087789e51793a"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#a7b3b387e4b7df73ab84087789e51793a"></a><br/></td></tr>
<tr class="memitem:afaf01f72121f4b5d55efd9b1906a637a"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#afaf01f72121f4b5d55efd9b1906a637a">ULOC_FRENCH</a>   "fr"</td></tr>
<tr class="memdesc:afaf01f72121f4b5d55efd9b1906a637a"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#afaf01f72121f4b5d55efd9b1906a637a"></a><br/></td></tr>
<tr class="memitem:a3d0e219396f99a84c0935ca9e3906b9f"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a3d0e219396f99a84c0935ca9e3906b9f">ULOC_GERMAN</a>   "de"</td></tr>
<tr class="memdesc:a3d0e219396f99a84c0935ca9e3906b9f"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#a3d0e219396f99a84c0935ca9e3906b9f"></a><br/></td></tr>
<tr class="memitem:afafec50dc9f01b9222f2b294e00d37bc"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#afafec50dc9f01b9222f2b294e00d37bc">ULOC_ITALIAN</a>   "it"</td></tr>
<tr class="memdesc:afafec50dc9f01b9222f2b294e00d37bc"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#afafec50dc9f01b9222f2b294e00d37bc"></a><br/></td></tr>
<tr class="memitem:a9ea383605956797a51f7b292957a4635"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a9ea383605956797a51f7b292957a4635">ULOC_JAPANESE</a>   "ja"</td></tr>
<tr class="memdesc:a9ea383605956797a51f7b292957a4635"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#a9ea383605956797a51f7b292957a4635"></a><br/></td></tr>
<tr class="memitem:adc5c81580522c61757afccfc7b321259"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#adc5c81580522c61757afccfc7b321259">ULOC_KOREAN</a>   "ko"</td></tr>
<tr class="memdesc:adc5c81580522c61757afccfc7b321259"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#adc5c81580522c61757afccfc7b321259"></a><br/></td></tr>
<tr class="memitem:a9e6ce1d4d9dd30192013320785f649ff"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a9e6ce1d4d9dd30192013320785f649ff">ULOC_SIMPLIFIED_CHINESE</a>   "zh_CN"</td></tr>
<tr class="memdesc:a9e6ce1d4d9dd30192013320785f649ff"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#a9e6ce1d4d9dd30192013320785f649ff"></a><br/></td></tr>
<tr class="memitem:a65d0986d91df6188d055cea37b7631a6"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a65d0986d91df6188d055cea37b7631a6">ULOC_TRADITIONAL_CHINESE</a>   "zh_TW"</td></tr>
<tr class="memdesc:a65d0986d91df6188d055cea37b7631a6"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this language. <a href="#a65d0986d91df6188d055cea37b7631a6"></a><br/></td></tr>
<tr class="memitem:a746eb7d63e452deb4e8d5cd018c8fe7a"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a746eb7d63e452deb4e8d5cd018c8fe7a">ULOC_CANADA</a>   "en_CA"</td></tr>
<tr class="memdesc:a746eb7d63e452deb4e8d5cd018c8fe7a"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#a746eb7d63e452deb4e8d5cd018c8fe7a"></a><br/></td></tr>
<tr class="memitem:ada2bca2d83bec81496f7a7c6c7a35adb"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ada2bca2d83bec81496f7a7c6c7a35adb">ULOC_CANADA_FRENCH</a>   "fr_CA"</td></tr>
<tr class="memdesc:ada2bca2d83bec81496f7a7c6c7a35adb"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#ada2bca2d83bec81496f7a7c6c7a35adb"></a><br/></td></tr>
<tr class="memitem:a246c0f569b610c6da2e185b7ced3043d"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a246c0f569b610c6da2e185b7ced3043d">ULOC_CHINA</a>   "zh_CN"</td></tr>
<tr class="memdesc:a246c0f569b610c6da2e185b7ced3043d"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#a246c0f569b610c6da2e185b7ced3043d"></a><br/></td></tr>
<tr class="memitem:a4dc1d8c0642fb43ced1ae6e609f28724"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a4dc1d8c0642fb43ced1ae6e609f28724">ULOC_PRC</a>   "zh_CN"</td></tr>
<tr class="memdesc:a4dc1d8c0642fb43ced1ae6e609f28724"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#a4dc1d8c0642fb43ced1ae6e609f28724"></a><br/></td></tr>
<tr class="memitem:a86b421b7341a237421f78a2a63184057"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a86b421b7341a237421f78a2a63184057">ULOC_FRANCE</a>   "fr_FR"</td></tr>
<tr class="memdesc:a86b421b7341a237421f78a2a63184057"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#a86b421b7341a237421f78a2a63184057"></a><br/></td></tr>
<tr class="memitem:a1b561518d9e0daef25e619b2c0c66dd9"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a1b561518d9e0daef25e619b2c0c66dd9">ULOC_GERMANY</a>   "de_DE"</td></tr>
<tr class="memdesc:a1b561518d9e0daef25e619b2c0c66dd9"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#a1b561518d9e0daef25e619b2c0c66dd9"></a><br/></td></tr>
<tr class="memitem:adb449b98da021a78151f4b929ecb4102"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#adb449b98da021a78151f4b929ecb4102">ULOC_ITALY</a>   "it_IT"</td></tr>
<tr class="memdesc:adb449b98da021a78151f4b929ecb4102"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#adb449b98da021a78151f4b929ecb4102"></a><br/></td></tr>
<tr class="memitem:a7c98b1c45b011eb2165160270f10931c"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a7c98b1c45b011eb2165160270f10931c">ULOC_JAPAN</a>   "ja_JP"</td></tr>
<tr class="memdesc:a7c98b1c45b011eb2165160270f10931c"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#a7c98b1c45b011eb2165160270f10931c"></a><br/></td></tr>
<tr class="memitem:aa56a91a89d347608d3d6af8821b7eea6"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#aa56a91a89d347608d3d6af8821b7eea6">ULOC_KOREA</a>   "ko_KR"</td></tr>
<tr class="memdesc:aa56a91a89d347608d3d6af8821b7eea6"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#aa56a91a89d347608d3d6af8821b7eea6"></a><br/></td></tr>
<tr class="memitem:ab1e44179a709c8b049bdd2aa4c805e50"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ab1e44179a709c8b049bdd2aa4c805e50">ULOC_TAIWAN</a>   "zh_TW"</td></tr>
<tr class="memdesc:ab1e44179a709c8b049bdd2aa4c805e50"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#ab1e44179a709c8b049bdd2aa4c805e50"></a><br/></td></tr>
<tr class="memitem:a036c7ccbaa867fdd96d1b6390142d18c"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a036c7ccbaa867fdd96d1b6390142d18c">ULOC_UK</a>   "en_GB"</td></tr>
<tr class="memdesc:a036c7ccbaa867fdd96d1b6390142d18c"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#a036c7ccbaa867fdd96d1b6390142d18c"></a><br/></td></tr>
<tr class="memitem:aa55404d3c725af4e05e65e5b40a6e13d"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#aa55404d3c725af4e05e65e5b40a6e13d">ULOC_US</a>   "en_US"</td></tr>
<tr class="memdesc:aa55404d3c725af4e05e65e5b40a6e13d"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for this country/region. <a href="#aa55404d3c725af4e05e65e5b40a6e13d"></a><br/></td></tr>
<tr class="memitem:a9dd4ed9ce1465a8c98c5f9edafb8c933"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a9dd4ed9ce1465a8c98c5f9edafb8c933">ULOC_LANG_CAPACITY</a>   12</td></tr>
<tr class="memdesc:a9dd4ed9ce1465a8c98c5f9edafb8c933"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for the maximum size of the language part of a locale ID. <a href="#a9dd4ed9ce1465a8c98c5f9edafb8c933"></a><br/></td></tr>
<tr class="memitem:a356983b956cf3cb61e5d5ed0cd296385"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a356983b956cf3cb61e5d5ed0cd296385">ULOC_COUNTRY_CAPACITY</a>   4</td></tr>
<tr class="memdesc:a356983b956cf3cb61e5d5ed0cd296385"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for the maximum size of the country part of a locale ID (including the terminating NULL). <a href="#a356983b956cf3cb61e5d5ed0cd296385"></a><br/></td></tr>
<tr class="memitem:ac070d94b27bb71f73bafd4c31ed53081"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ac070d94b27bb71f73bafd4c31ed53081">ULOC_FULLNAME_CAPACITY</a>   157</td></tr>
<tr class="memdesc:ac070d94b27bb71f73bafd4c31ed53081"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for the maximum size of the whole locale ID (including the terminating NULL and all keywords). <a href="#ac070d94b27bb71f73bafd4c31ed53081"></a><br/></td></tr>
<tr class="memitem:a2e60b17e30b020269c89c2ca83c8ea40"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a2e60b17e30b020269c89c2ca83c8ea40">ULOC_SCRIPT_CAPACITY</a>   6</td></tr>
<tr class="memdesc:a2e60b17e30b020269c89c2ca83c8ea40"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for the maximum size of the script part of a locale ID (including the terminating NULL). <a href="#a2e60b17e30b020269c89c2ca83c8ea40"></a><br/></td></tr>
<tr class="memitem:a56c1ecca7967df9d83044fa54248ea03"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a56c1ecca7967df9d83044fa54248ea03">ULOC_KEYWORDS_CAPACITY</a>   50</td></tr>
<tr class="memdesc:a56c1ecca7967df9d83044fa54248ea03"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for the maximum size of keywords in a locale. <a href="#a56c1ecca7967df9d83044fa54248ea03"></a><br/></td></tr>
<tr class="memitem:a48dc9fb3bfd43ed8852387a725260622"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a48dc9fb3bfd43ed8852387a725260622">ULOC_KEYWORD_AND_VALUES_CAPACITY</a>   100</td></tr>
<tr class="memdesc:a48dc9fb3bfd43ed8852387a725260622"><td class="mdescLeft"> </td><td class="mdescRight">Useful constant for the maximum total size of keywords and their values in a locale. <a href="#a48dc9fb3bfd43ed8852387a725260622"></a><br/></td></tr>
<tr class="memitem:a95caa9ed83b65408fc6fefed059e7a4e"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a95caa9ed83b65408fc6fefed059e7a4e">ULOC_KEYWORD_SEPARATOR</a>   '@'</td></tr>
<tr class="memdesc:a95caa9ed83b65408fc6fefed059e7a4e"><td class="mdescLeft"> </td><td class="mdescRight">Invariant character separating keywords from the locale string. <a href="#a95caa9ed83b65408fc6fefed059e7a4e"></a><br/></td></tr>
<tr class="memitem:aa910dc90d6e05009ba0125e65bde51cf"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#aa910dc90d6e05009ba0125e65bde51cf">ULOC_KEYWORD_SEPARATOR_UNICODE</a>   0x40</td></tr>
<tr class="memdesc:aa910dc90d6e05009ba0125e65bde51cf"><td class="mdescLeft"> </td><td class="mdescRight">Unicode code point for '@' separating keywords from the locale string. <a href="#aa910dc90d6e05009ba0125e65bde51cf"></a><br/></td></tr>
<tr class="memitem:a624227fd242e922ed98ee574df22b1f6"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a624227fd242e922ed98ee574df22b1f6">ULOC_KEYWORD_ASSIGN</a>   '='</td></tr>
<tr class="memdesc:a624227fd242e922ed98ee574df22b1f6"><td class="mdescLeft"> </td><td class="mdescRight">Invariant character for assigning value to a keyword. <a href="#a624227fd242e922ed98ee574df22b1f6"></a><br/></td></tr>
<tr class="memitem:ab8dedf272c1a1594baeeeded697a14a6"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ab8dedf272c1a1594baeeeded697a14a6">ULOC_KEYWORD_ASSIGN_UNICODE</a>   0x3D</td></tr>
<tr class="memdesc:ab8dedf272c1a1594baeeeded697a14a6"><td class="mdescLeft"> </td><td class="mdescRight">Unicode code point for '=' for assigning value to a keyword. <a href="#ab8dedf272c1a1594baeeeded697a14a6"></a><br/></td></tr>
<tr class="memitem:a907733baa1967a626c1ebb36d327675d"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a907733baa1967a626c1ebb36d327675d">ULOC_KEYWORD_ITEM_SEPARATOR</a>   ';'</td></tr>
<tr class="memdesc:a907733baa1967a626c1ebb36d327675d"><td class="mdescLeft"> </td><td class="mdescRight">Invariant character separating keywords. <a href="#a907733baa1967a626c1ebb36d327675d"></a><br/></td></tr>
<tr class="memitem:ab729d122d9b777b5c23d4b07ede711a9"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ab729d122d9b777b5c23d4b07ede711a9">ULOC_KEYWORD_ITEM_SEPARATOR_UNICODE</a>   0x3B</td></tr>
<tr class="memdesc:ab729d122d9b777b5c23d4b07ede711a9"><td class="mdescLeft"> </td><td class="mdescRight">Unicode code point for ';' separating keywords. <a href="#ab729d122d9b777b5c23d4b07ede711a9"></a><br/></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:adf053345d343f8d82ae080f7a5871f34"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#adf053345d343f8d82ae080f7a5871f34">ULocDataLocaleType</a> { <a class="el" href="uloc_8h.html#adf053345d343f8d82ae080f7a5871f34a95bd603a0102238a5235bf89a45edaf9">ULOC_ACTUAL_LOCALE</a> = 0,
<a class="el" href="uloc_8h.html#adf053345d343f8d82ae080f7a5871f34abe12d6c03ab1fa05e028de64daf97d8c">ULOC_VALID_LOCALE</a> = 1,
<a class="el" href="uloc_8h.html#adf053345d343f8d82ae080f7a5871f34ae26d6cf4bf10b95b2bc1f58b2a00ef76">ULOC_REQUESTED_LOCALE</a> = 2,
<b>ULOC_DATA_LOCALE_TYPE_LIMIT</b> = 3
}</td></tr>
<tr class="memdesc:adf053345d343f8d82ae080f7a5871f34"><td class="mdescLeft"> </td><td class="mdescRight">Constants for *_getLocale() Allow user to select whether she wants information on requested, valid or actual locale. <a href="uloc_8h.html#adf053345d343f8d82ae080f7a5871f34">More...</a><br/></td></tr>
<tr class="memitem:a5570cc4b814b6cc9150ee0be5ee96ca5"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a5570cc4b814b6cc9150ee0be5ee96ca5">ULayoutType</a> { <br/>
  <b>ULOC_LAYOUT_LTR</b> = 0,
<b>ULOC_LAYOUT_RTL</b> = 1,
<b>ULOC_LAYOUT_TTB</b> = 2,
<b>ULOC_LAYOUT_BTT</b> = 3,
<br/>
  <b>ULOC_LAYOUT_UNKNOWN</b>
<br/>
}</td></tr>
<tr class="memdesc:a5570cc4b814b6cc9150ee0be5ee96ca5"><td class="mdescLeft"> </td><td class="mdescRight">enums for the return value for the character and line orientation functions. <a href="uloc_8h.html#a5570cc4b814b6cc9150ee0be5ee96ca5">More...</a><br/></td></tr>
<tr class="memitem:a3ad5cb6cf40e47fec510070d20c29cf9"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a3ad5cb6cf40e47fec510070d20c29cf9">UAcceptResult</a> { <b>ULOC_ACCEPT_FAILED</b> = 0,
<b>ULOC_ACCEPT_VALID</b> = 1,
<b>ULOC_ACCEPT_FALLBACK</b> = 2
}</td></tr>
<tr class="memdesc:a3ad5cb6cf40e47fec510070d20c29cf9"><td class="mdescLeft"> </td><td class="mdescRight">enums for the 'outResult' parameter return value <a href="uloc_8h.html#a3ad5cb6cf40e47fec510070d20c29cf9">More...</a><br/></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:adbc1e91581ae0e0ec421dafcc35c06c1"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#adbc1e91581ae0e0ec421dafcc35c06c1">uloc_getDefault</a> (void)</td></tr>
<tr class="memdesc:adbc1e91581ae0e0ec421dafcc35c06c1"><td class="mdescLeft"> </td><td class="mdescRight">Gets ICU's default locale. <a href="#adbc1e91581ae0e0ec421dafcc35c06c1"></a><br/></td></tr>
<tr class="memitem:a472d1176dda100491e873e58018ba7d4"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a472d1176dda100491e873e58018ba7d4">uloc_setDefault</a> (const char *localeID, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a472d1176dda100491e873e58018ba7d4"><td class="mdescLeft"> </td><td class="mdescRight">Sets ICU's default locale. <a href="#a472d1176dda100491e873e58018ba7d4"></a><br/></td></tr>
<tr class="memitem:a8d88e113b134c0fd61b37815163abd8e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a8d88e113b134c0fd61b37815163abd8e">uloc_getLanguage</a> (const char *localeID, char *language, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> languageCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:a8d88e113b134c0fd61b37815163abd8e"><td class="mdescLeft"> </td><td class="mdescRight">Gets the language code for the specified locale. <a href="#a8d88e113b134c0fd61b37815163abd8e"></a><br/></td></tr>
<tr class="memitem:a6e9e30529b84f5b5e1213829e0a47144"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a6e9e30529b84f5b5e1213829e0a47144">uloc_getScript</a> (const char *localeID, char *script, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> scriptCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:a6e9e30529b84f5b5e1213829e0a47144"><td class="mdescLeft"> </td><td class="mdescRight">Gets the script code for the specified locale. <a href="#a6e9e30529b84f5b5e1213829e0a47144"></a><br/></td></tr>
<tr class="memitem:a248777437a9795b6bcf4b8c8d7e405db"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a248777437a9795b6bcf4b8c8d7e405db">uloc_getCountry</a> (const char *localeID, char *country, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> countryCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:a248777437a9795b6bcf4b8c8d7e405db"><td class="mdescLeft"> </td><td class="mdescRight">Gets the country code for the specified locale. <a href="#a248777437a9795b6bcf4b8c8d7e405db"></a><br/></td></tr>
<tr class="memitem:ac9d081c2f4e3f1736d943ec1d66b776f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ac9d081c2f4e3f1736d943ec1d66b776f">uloc_getVariant</a> (const char *localeID, char *variant, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> variantCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:ac9d081c2f4e3f1736d943ec1d66b776f"><td class="mdescLeft"> </td><td class="mdescRight">Gets the variant code for the specified locale. <a href="#ac9d081c2f4e3f1736d943ec1d66b776f"></a><br/></td></tr>
<tr class="memitem:a1b817e9efa7ca5711d3b5abd19227296"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a1b817e9efa7ca5711d3b5abd19227296">uloc_getName</a> (const char *localeID, char *name, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> nameCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:a1b817e9efa7ca5711d3b5abd19227296"><td class="mdescLeft"> </td><td class="mdescRight">Gets the full name for the specified locale. <a href="#a1b817e9efa7ca5711d3b5abd19227296"></a><br/></td></tr>
<tr class="memitem:afe5adae51e287be339c57142947eb290"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#afe5adae51e287be339c57142947eb290">uloc_canonicalize</a> (const char *localeID, char *name, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> nameCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:afe5adae51e287be339c57142947eb290"><td class="mdescLeft"> </td><td class="mdescRight">Gets the full name for the specified locale. <a href="#afe5adae51e287be339c57142947eb290"></a><br/></td></tr>
<tr class="memitem:ab1045e01cbf36fd8a4f8ae9b82ef4c94"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ab1045e01cbf36fd8a4f8ae9b82ef4c94">uloc_getISO3Language</a> (const char *localeID)</td></tr>
<tr class="memdesc:ab1045e01cbf36fd8a4f8ae9b82ef4c94"><td class="mdescLeft"> </td><td class="mdescRight">Gets the ISO language code for the specified locale. <a href="#ab1045e01cbf36fd8a4f8ae9b82ef4c94"></a><br/></td></tr>
<tr class="memitem:ad9950c4d96caa332816532fbedf641f2"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ad9950c4d96caa332816532fbedf641f2">uloc_getISO3Country</a> (const char *localeID)</td></tr>
<tr class="memdesc:ad9950c4d96caa332816532fbedf641f2"><td class="mdescLeft"> </td><td class="mdescRight">Gets the ISO country code for the specified locale. <a href="#ad9950c4d96caa332816532fbedf641f2"></a><br/></td></tr>
<tr class="memitem:a18b4a9328cc5e90db4e8f3a1b79ebff5"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#a435d1572bf3f880d55459d9805097f62">uint32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a18b4a9328cc5e90db4e8f3a1b79ebff5">uloc_getLCID</a> (const char *localeID)</td></tr>
<tr class="memdesc:a18b4a9328cc5e90db4e8f3a1b79ebff5"><td class="mdescLeft"> </td><td class="mdescRight">Gets the Win32 LCID value for the specified locale. <a href="#a18b4a9328cc5e90db4e8f3a1b79ebff5"></a><br/></td></tr>
<tr class="memitem:a3bf3527de225342853d1fe97503590f7"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a3bf3527de225342853d1fe97503590f7">uloc_getDisplayLanguage</a> (const char *locale, const char *displayLocale, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *language, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> languageCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a3bf3527de225342853d1fe97503590f7"><td class="mdescLeft"> </td><td class="mdescRight">Gets the language name suitable for display for the specified locale. <a href="#a3bf3527de225342853d1fe97503590f7"></a><br/></td></tr>
<tr class="memitem:aabf272c2adcb6c0c7dc149bf33b0e39c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#aabf272c2adcb6c0c7dc149bf33b0e39c">uloc_getDisplayScript</a> (const char *locale, const char *displayLocale, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *script, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> scriptCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:aabf272c2adcb6c0c7dc149bf33b0e39c"><td class="mdescLeft"> </td><td class="mdescRight">Gets the script name suitable for display for the specified locale. <a href="#aabf272c2adcb6c0c7dc149bf33b0e39c"></a><br/></td></tr>
<tr class="memitem:a2debe5d381bed15bc17a9f943e921e3a"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a2debe5d381bed15bc17a9f943e921e3a">uloc_getDisplayCountry</a> (const char *locale, const char *displayLocale, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *country, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> countryCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a2debe5d381bed15bc17a9f943e921e3a"><td class="mdescLeft"> </td><td class="mdescRight">Gets the country name suitable for display for the specified locale. <a href="#a2debe5d381bed15bc17a9f943e921e3a"></a><br/></td></tr>
<tr class="memitem:a45c5307fc3c2ae57a8c7ec81eb441fd2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a45c5307fc3c2ae57a8c7ec81eb441fd2">uloc_getDisplayVariant</a> (const char *locale, const char *displayLocale, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *variant, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> variantCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a45c5307fc3c2ae57a8c7ec81eb441fd2"><td class="mdescLeft"> </td><td class="mdescRight">Gets the variant name suitable for display for the specified locale. <a href="#a45c5307fc3c2ae57a8c7ec81eb441fd2"></a><br/></td></tr>
<tr class="memitem:a17562898c39cd95b062b5e02b44ebce2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a17562898c39cd95b062b5e02b44ebce2">uloc_getDisplayKeyword</a> (const char *keyword, const char *displayLocale, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> destCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a17562898c39cd95b062b5e02b44ebce2"><td class="mdescLeft"> </td><td class="mdescRight">Gets the keyword name suitable for display for the specified locale. <a href="#a17562898c39cd95b062b5e02b44ebce2"></a><br/></td></tr>
<tr class="memitem:a5b7a991655765f14e6c79ff8b74b47ff"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a5b7a991655765f14e6c79ff8b74b47ff">uloc_getDisplayKeywordValue</a> (const char *locale, const char *keyword, const char *displayLocale, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> destCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a5b7a991655765f14e6c79ff8b74b47ff"><td class="mdescLeft"> </td><td class="mdescRight">Gets the value of the keyword suitable for display for the specified locale. <a href="#a5b7a991655765f14e6c79ff8b74b47ff"></a><br/></td></tr>
<tr class="memitem:a3050cbd9c84aae5a406f923c8736e151"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a3050cbd9c84aae5a406f923c8736e151">uloc_getDisplayName</a> (const char *localeID, const char *inLocaleID, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *result, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> maxResultSize, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:a3050cbd9c84aae5a406f923c8736e151"><td class="mdescLeft"> </td><td class="mdescRight">Gets the full name suitable for display for the specified locale. <a href="#a3050cbd9c84aae5a406f923c8736e151"></a><br/></td></tr>
<tr class="memitem:a75df9657cc46472afa94e4cbd4a1529b"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a75df9657cc46472afa94e4cbd4a1529b">uloc_getAvailable</a> (<a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> n)</td></tr>
<tr class="memdesc:a75df9657cc46472afa94e4cbd4a1529b"><td class="mdescLeft"> </td><td class="mdescRight">Gets the specified locale from a list of all available locales. <a href="#a75df9657cc46472afa94e4cbd4a1529b"></a><br/></td></tr>
<tr class="memitem:a5e2344d83cc55eee38595d50b62294dc"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a5e2344d83cc55eee38595d50b62294dc">uloc_countAvailable</a> (void)</td></tr>
<tr class="memdesc:a5e2344d83cc55eee38595d50b62294dc"><td class="mdescLeft"> </td><td class="mdescRight">Gets the size of the all available locale list. <a href="#a5e2344d83cc55eee38595d50b62294dc"></a><br/></td></tr>
<tr class="memitem:a9d4f51992a2efac9369c223b5aae9c37"><td class="memItemLeft" align="right" valign="top">const char *const * </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a9d4f51992a2efac9369c223b5aae9c37">uloc_getISOLanguages</a> (void)</td></tr>
<tr class="memdesc:a9d4f51992a2efac9369c223b5aae9c37"><td class="mdescLeft"> </td><td class="mdescRight">Gets a list of all available language codes defined in ISO 639. <a href="#a9d4f51992a2efac9369c223b5aae9c37"></a><br/></td></tr>
<tr class="memitem:a673b0c89a78f098f797bab114eb8de82"><td class="memItemLeft" align="right" valign="top">const char *const * </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a673b0c89a78f098f797bab114eb8de82">uloc_getISOCountries</a> (void)</td></tr>
<tr class="memdesc:a673b0c89a78f098f797bab114eb8de82"><td class="mdescLeft"> </td><td class="mdescRight">Gets a list of all available 2-letter country codes defined in ISO 639. <a href="#a673b0c89a78f098f797bab114eb8de82"></a><br/></td></tr>
<tr class="memitem:ab722eaa3e697c2df034e1a65fba0b06d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ab722eaa3e697c2df034e1a65fba0b06d">uloc_getParent</a> (const char *localeID, char *parent, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> parentCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:ab722eaa3e697c2df034e1a65fba0b06d"><td class="mdescLeft"> </td><td class="mdescRight">Truncate the locale ID string to get the parent locale ID. <a href="#ab722eaa3e697c2df034e1a65fba0b06d"></a><br/></td></tr>
<tr class="memitem:a6d153005b268df7f93ccb55219b646c5"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a6d153005b268df7f93ccb55219b646c5">uloc_getBaseName</a> (const char *localeID, char *name, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> nameCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:a6d153005b268df7f93ccb55219b646c5"><td class="mdescLeft"> </td><td class="mdescRight">Gets the full name for the specified locale. <a href="#a6d153005b268df7f93ccb55219b646c5"></a><br/></td></tr>
<tr class="memitem:a0ad2571c7225304fd9883ddc2047097c"><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="uloc_8h.html#a0ad2571c7225304fd9883ddc2047097c">uloc_openKeywords</a> (const char *localeID, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a0ad2571c7225304fd9883ddc2047097c"><td class="mdescLeft"> </td><td class="mdescRight">Gets an enumeration of keywords for the specified locale. <a href="#a0ad2571c7225304fd9883ddc2047097c"></a><br/></td></tr>
<tr class="memitem:a1ac8cd994fc39ed8c3865b21cf4f47fa"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a1ac8cd994fc39ed8c3865b21cf4f47fa">uloc_getKeywordValue</a> (const char *localeID, const char *keywordName, char *buffer, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> bufferCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a1ac8cd994fc39ed8c3865b21cf4f47fa"><td class="mdescLeft"> </td><td class="mdescRight">Get the value for a keyword. <a href="#a1ac8cd994fc39ed8c3865b21cf4f47fa"></a><br/></td></tr>
<tr class="memitem:a4ba76d26bf66ef7629a649f6dfc3cc93"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a4ba76d26bf66ef7629a649f6dfc3cc93">uloc_setKeywordValue</a> (const char *keywordName, const char *keywordValue, char *buffer, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> bufferCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a4ba76d26bf66ef7629a649f6dfc3cc93"><td class="mdescLeft"> </td><td class="mdescRight">Set the value of the specified keyword. <a href="#a4ba76d26bf66ef7629a649f6dfc3cc93"></a><br/></td></tr>
<tr class="memitem:a2bb9a5571c5d0b8a47947456e79a170d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="uloc_8h.html#a5570cc4b814b6cc9150ee0be5ee96ca5">ULayoutType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a2bb9a5571c5d0b8a47947456e79a170d">uloc_getCharacterOrientation</a> (const char *localeId, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a2bb9a5571c5d0b8a47947456e79a170d"><td class="mdescLeft"> </td><td class="mdescRight">Get the layout character orientation for the specified locale. <a href="#a2bb9a5571c5d0b8a47947456e79a170d"></a><br/></td></tr>
<tr class="memitem:ab6a3001d2c92046d7072087b880029fb"><td class="memItemLeft" align="right" valign="top"><a class="el" href="uloc_8h.html#a5570cc4b814b6cc9150ee0be5ee96ca5">ULayoutType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#ab6a3001d2c92046d7072087b880029fb">uloc_getLineOrientation</a> (const char *localeId, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:ab6a3001d2c92046d7072087b880029fb"><td class="mdescLeft"> </td><td class="mdescRight">Get the layout line orientation for the specified locale. <a href="#ab6a3001d2c92046d7072087b880029fb"></a><br/></td></tr>
<tr class="memitem:aced06018568333e1906ae104ab62757a"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#aced06018568333e1906ae104ab62757a">uloc_acceptLanguageFromHTTP</a> (char *result, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> resultAvailable, <a class="el" href="uloc_8h.html#a3ad5cb6cf40e47fec510070d20c29cf9">UAcceptResult</a> *outResult, const char *httpAcceptLanguage, <a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a> *availableLocales, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:aced06018568333e1906ae104ab62757a"><td class="mdescLeft"> </td><td class="mdescRight">Based on a HTTP header from a web browser and a list of available locales, determine an acceptable locale for the user. <a href="#aced06018568333e1906ae104ab62757a"></a><br/></td></tr>
<tr class="memitem:a3b9d2f95d1a205665a0597762fd08ca2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a3b9d2f95d1a205665a0597762fd08ca2">uloc_acceptLanguage</a> (char *result, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> resultAvailable, <a class="el" href="uloc_8h.html#a3ad5cb6cf40e47fec510070d20c29cf9">UAcceptResult</a> *outResult, const char **acceptList, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> acceptListCount, <a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a> *availableLocales, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a3b9d2f95d1a205665a0597762fd08ca2"><td class="mdescLeft"> </td><td class="mdescRight">Based on a list of available locales, determine an acceptable locale for the user. <a href="#a3b9d2f95d1a205665a0597762fd08ca2"></a><br/></td></tr>
<tr class="memitem:a623993d80071d113cbe64d20f6a4956c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a623993d80071d113cbe64d20f6a4956c">uloc_getLocaleForLCID</a> (<a class="el" href="pwin32_8h.html#a435d1572bf3f880d55459d9805097f62">uint32_t</a> hostID, char *locale, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> localeCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a623993d80071d113cbe64d20f6a4956c"><td class="mdescLeft"> </td><td class="mdescRight">Gets the ICU locale ID for the specified Win32 LCID value. <a href="#a623993d80071d113cbe64d20f6a4956c"></a><br/></td></tr>
<tr class="memitem:a0cb2dcd65f745e7a966a729395499770"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a0cb2dcd65f745e7a966a729395499770">uloc_addLikelySubtags</a> (const char *localeID, char *maximizedLocaleID, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> maximizedLocaleIDCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:a0cb2dcd65f745e7a966a729395499770"><td class="mdescLeft"> </td><td class="mdescRight">Add the likely subtags for a provided locale ID, per the algorithm described in the following CLDR technical report: <a href="#a0cb2dcd65f745e7a966a729395499770"></a><br/></td></tr>
<tr class="memitem:acecda5c650c9a3a4e43900c676558e17"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#acecda5c650c9a3a4e43900c676558e17">uloc_minimizeSubtags</a> (const char *localeID, char *minimizedLocaleID, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> minimizedLocaleIDCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:acecda5c650c9a3a4e43900c676558e17"><td class="mdescLeft"> </td><td class="mdescRight">Minimize the subtags for a provided locale ID, per the algorithm described in the following CLDR technical report: <a href="#acecda5c650c9a3a4e43900c676558e17"></a><br/></td></tr>
<tr class="memitem:aa45d6457f72867880f079e27a63c6fcb"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#aa45d6457f72867880f079e27a63c6fcb">uloc_forLanguageTag</a> (const char *langtag, char *localeID, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> localeIDCapacity, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> *parsedLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:aa45d6457f72867880f079e27a63c6fcb"><td class="mdescLeft"> </td><td class="mdescRight">Returns a locale ID for the specified BCP47 language tag string. <a href="#aa45d6457f72867880f079e27a63c6fcb"></a><br/></td></tr>
<tr class="memitem:a1d50c91925ca3853fce6f28cf7390c3c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uloc_8h.html#a1d50c91925ca3853fce6f28cf7390c3c">uloc_toLanguageTag</a> (const char *localeID, char *langtag, <a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> langtagCapacity, <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> strict, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *err)</td></tr>
<tr class="memdesc:a1d50c91925ca3853fce6f28cf7390c3c"><td class="mdescLeft"> </td><td class="mdescRight">Returns a well-formed language tag for this locale ID. <a href="#a1d50c91925ca3853fce6f28cf7390c3c"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>C API: <a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a>. </p>
<h2>ULoc C API for <a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a> </h2>
<p>A <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code> represents a specific geographical, political, or cultural region. An operation that requires a <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code> to perform its task is called <em>locale-sensitive</em> and uses the <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code> to tailor information for the user. For example, displaying a number is a locale-sensitive operation–the number should be formatted according to the customs/conventions of the user's native country, region, or culture. In the C APIs, a locales is simply a const char string.</p>
<p>You create a <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code> with one of the three options listed below. Each of the component is separated by '_' in the locale string. <blockquote> <pre>
<div class="fragment"><div class="line"> newLanguage</div>
<div class="line"> </div>
<div class="line"> newLanguage + newCountry</div>
<div class="line"> </div>
<div class="line"> newLanguage + newCountry + newVariant</div>
</div><!-- fragment -->
</pre> </blockquote> The first option is a valid <b>ISO Language Code.</b> These codes are the lower-case two-letter codes as defined by ISO-639. You can find a full list of these codes at a number of sites, such as: <br/>
<a href="http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt">http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt</a></p>
<p>The second option includes an additonal <b>ISO Country Code.</b> These codes are the upper-case two-letter codes as defined by ISO-3166. You can find a full list of these codes at a number of sites, such as: <br/>
<a href="http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html">http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html</a></p>
<p>The third option requires another additonal information–the <b>Variant.</b> The Variant codes are vendor and browser-specific. For example, use WIN for Windows, MAC for Macintosh, and POSIX for POSIX. Where there are two variants, separate them with an underscore, and put the most important one first. For example, a Traditional Spanish collation might be referenced, with "ES", "ES", "Traditional_WIN".</p>
<p>Because a <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code> is just an identifier for a region, no validity check is performed when you specify a <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code>. If you want to see whether particular resources are available for the <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code> you asked for, you must query those resources. For example, ask the <code>UNumberFormat</code> for the locales it supports using its <code>getAvailable</code> method. <br/>
<b>Note:</b> When you ask for a resource for a particular locale, you get back the best available match, not necessarily precisely what you asked for. For more information, look at <code>UResourceBundle</code>.</p>
<p>The <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code> provides a number of convenient constants that you can use to specify the commonly used locales. For example, the following refers to a locale for the United States: <blockquote> <pre>
<div class="fragment"><div class="line"> <a class="code" href="uloc_8h.html#aa55404d3c725af4e05e65e5b40a6e13d" title="Useful constant for this country/region.">ULOC_US</a></div>
</div><!-- fragment -->
</pre> </blockquote><p>Once you've specified a locale you can query it for information about itself. Use <code>uloc_getCountry</code> to get the ISO Country Code and <code>uloc_getLanguage</code> to get the ISO Language Code. You can use <code>uloc_getDisplayCountry</code> to get the name of the country suitable for displaying to the user. Similarly, you can use <code>uloc_getDisplayLanguage</code> to get the name of the language suitable for displaying to the user. Interestingly, the <code>uloc_getDisplayXXX</code> methods are themselves locale-sensitive and have two versions: one that uses the default locale and one that takes a locale as an argument and displays the name or country in a language appropriate to that locale.</p>
<p>The ICU provides a number of services that perform locale-sensitive operations. For example, the <code>unum_xxx</code> functions format numbers, currency, or percentages in a locale-sensitive manner. </p>
<blockquote> <pre>
<div class="fragment"><div class="line"> <a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c" title="Error code to replace exception handling, so that the code is compatible with all C++ compilers...">UErrorCode</a> success = <a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78caa43dbfc9499c5f911d04e1a0ca3bf6f9" title="No error, no warning.">U_ZERO_ERROR</a>;</div>
<div class="line"> <a class="code" href="unum_8h.html#aaeec8f4d21895a6f3efdedf14e8f946b" title="A number formatter.">UNumberFormat</a> *nf;</div>
<div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* myLocale = <span class="stringliteral">"fr_FR"</span>;</div>
<div class="line"> </div>
<div class="line"> nf = <a class="code" href="unum_8h.html#a581f9eb53d6b1b052b751272e1c6b67f" title="Create and return a new UNumberFormat for formatting and parsing numbers.">unum_open</a>( <a class="code" href="unum_8h.html#a4eb4d3ff13bd506e7078b2be4052266dad0a115c07b8b2e3bbf296e8aaa51bbeb" title="Default format.">UNUM_DEFAULT</a>, <a class="code" href="utypes_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4" title="Define NULL if necessary, to 0 for C++ and to ((void *)0) for C.">NULL</a>, success ); </div>
<div class="line"> <a class="code" href="unum_8h.html#a5716f7198d8adcd215e6c192abedde88" title="Close a UNumberFormat.">unum_close</a>(nf);</div>
<div class="line"> nf = <a class="code" href="unum_8h.html#a581f9eb53d6b1b052b751272e1c6b67f" title="Create and return a new UNumberFormat for formatting and parsing numbers.">unum_open</a>( <a class="code" href="unum_8h.html#a4eb4d3ff13bd506e7078b2be4052266da21b6ea8b4d9a0470ef541984625b60fa" title="Currency format with a currency symbol, e.g., "$1.00".">UNUM_CURRENCY</a>, <a class="code" href="utypes_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4" title="Define NULL if necessary, to 0 for C++ and to ((void *)0) for C.">NULL</a>, success );</div>
<div class="line"> <a class="code" href="unum_8h.html#a5716f7198d8adcd215e6c192abedde88" title="Close a UNumberFormat.">unum_close</a>(nf);</div>
<div class="line"> nf = <a class="code" href="unum_8h.html#a581f9eb53d6b1b052b751272e1c6b67f" title="Create and return a new UNumberFormat for formatting and parsing numbers.">unum_open</a>( <a class="code" href="unum_8h.html#a4eb4d3ff13bd506e7078b2be4052266da9bf1ec360f981705cd4bbd51cb87aebb" title="Percent format.">UNUM_PERCENT</a>, <a class="code" href="utypes_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4" title="Define NULL if necessary, to 0 for C++ and to ((void *)0) for C.">NULL</a>, success ); </div>
<div class="line"> <a class="code" href="unum_8h.html#a5716f7198d8adcd215e6c192abedde88" title="Close a UNumberFormat.">unum_close</a>(nf);</div>
</div><!-- fragment -->
</pre> </blockquote> Each of these methods has two variants; one with an explicit locale and one without; the latter using the default locale. <blockquote> <pre>
<div class="fragment"><div class="line"> nf = <a class="code" href="unum_8h.html#a581f9eb53d6b1b052b751272e1c6b67f" title="Create and return a new UNumberFormat for formatting and parsing numbers.">unum_open</a>( <a class="code" href="unum_8h.html#a4eb4d3ff13bd506e7078b2be4052266dad0a115c07b8b2e3bbf296e8aaa51bbeb" title="Default format.">UNUM_DEFAULT</a>, myLocale, success ); </div>
<div class="line"> <a class="code" href="unum_8h.html#a5716f7198d8adcd215e6c192abedde88" title="Close a UNumberFormat.">unum_close</a>(nf);</div>
<div class="line"> nf = <a class="code" href="unum_8h.html#a581f9eb53d6b1b052b751272e1c6b67f" title="Create and return a new UNumberFormat for formatting and parsing numbers.">unum_open</a>( <a class="code" href="unum_8h.html#a4eb4d3ff13bd506e7078b2be4052266da21b6ea8b4d9a0470ef541984625b60fa" title="Currency format with a currency symbol, e.g., "$1.00".">UNUM_CURRENCY</a>, myLocale, success );</div>
<div class="line"> <a class="code" href="unum_8h.html#a5716f7198d8adcd215e6c192abedde88" title="Close a UNumberFormat.">unum_close</a>(nf);</div>
<div class="line"> nf = <a class="code" href="unum_8h.html#a581f9eb53d6b1b052b751272e1c6b67f" title="Create and return a new UNumberFormat for formatting and parsing numbers.">unum_open</a>( <a class="code" href="unum_8h.html#a4eb4d3ff13bd506e7078b2be4052266da9bf1ec360f981705cd4bbd51cb87aebb" title="Percent format.">UNUM_PERCENT</a>, myLocale, success ); </div>
<div class="line"> <a class="code" href="unum_8h.html#a5716f7198d8adcd215e6c192abedde88" title="Close a UNumberFormat.">unum_close</a>(nf);</div>
</div><!-- fragment -->
</pre> </blockquote> A <code><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a></code> is the mechanism for identifying the kind of services (<code>UNumberFormat</code>) that you would like to get. The locale is <b>just</b> a mechanism for identifying these services.</p>
<p>Each international serivce that performs locale-sensitive operations allows you to get all the available objects of that type. You can sift through these objects by language, country, or variant, and use the display names to present a menu to the user. For example, you can create a menu of all the collation objects suitable for a given language. Such classes implement these three class methods: <blockquote> <pre>
<div class="fragment"><div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="uloc_8h.html#a75df9657cc46472afa94e4cbd4a1529b" title="Gets the specified locale from a list of all available locales.">uloc_getAvailable</a>(int32_t index);</div>
<div class="line"> int32_t <a class="code" href="uloc_8h.html#a5e2344d83cc55eee38595d50b62294dc" title="Gets the size of the all available locale list.">uloc_countAvailable</a>();</div>
<div class="line"> int32_t</div>
<div class="line"> <a class="code" href="uloc_8h.html#a3050cbd9c84aae5a406f923c8736e151" title="Gets the full name suitable for display for the specified locale.">uloc_getDisplayName</a>(<span class="keyword">const</span> <span class="keywordtype">char</span>* localeID,</div>
<div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* inLocaleID, </div>
<div class="line"> <a class="code" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac" title="Define UChar to be wchar_t if that is 16 bits wide; always assumed to be unsigned.">UChar</a>* result,</div>
<div class="line"> int32_t maxResultSize,</div>
<div class="line"> <a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c" title="Error code to replace exception handling, so that the code is compatible with all C++ compilers...">UErrorCode</a>* err);</div>
</div><!-- fragment -->
</pre> </blockquote> <p>Concerning POSIX/RFC1766 <a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a> IDs, the getLanguage/getCountry/getVariant/getName functions do understand the POSIX type form of language_COUNTRY.ENCODING@VARIANT and if there is not an ICU-stype variant, <a class="el" href="uloc_8h.html#ac9d081c2f4e3f1736d943ec1d66b776f" title="Gets the variant code for the specified locale.">uloc_getVariant()</a> for example will return the one listed after the @at sign. As well, the hyphen "-" is recognized as a country/variant separator similarly to RFC1766. So for example, "en-us" will be interpreted as en_US. As a result, <a class="el" href="uloc_8h.html#a1b817e9efa7ca5711d3b5abd19227296" title="Gets the full name for the specified locale.">uloc_getName()</a> is far from a no-op, and will have the effect of converting POSIX/RFC1766 IDs into ICU form, although it does NOT map any of the actual codes (i.e. russian->ru) in any way. Applications should call <a class="el" href="uloc_8h.html#a1b817e9efa7ca5711d3b5abd19227296" title="Gets the full name for the specified locale.">uloc_getName()</a> at the point where a locale ID is coming from an external source (user entry, OS, web browser) and pass the resulting string to other ICU functions. For example, don't use de-de@EURO as an argument to resourcebundle.</p>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="ures_8h.html#a7391119e9274be9ba2e6892b48a2bbbe">UResourceBundle</a> </dd></dl>
<p>Definition in file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div><hr/><h2>Macro Definition Documentation</h2>
<a class="anchor" id="a746eb7d63e452deb4e8d5cd018c8fe7a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_CANADA   "en_CA"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001351">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00220">220</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="ada2bca2d83bec81496f7a7c6c7a35adb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_CANADA_FRENCH   "fr_CA"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001352">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00222">222</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a246c0f569b610c6da2e185b7ced3043d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_CHINA   "zh_CN"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001353">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00224">224</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="af1e4f6e75642a19b48985c3308dbda1e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_CHINESE   "zh"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001342">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00201">201</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a356983b956cf3cb61e5d5ed0cd296385"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_COUNTRY_CAPACITY   4</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for the maximum size of the country part of a locale ID (including the terminating NULL). </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001364">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00256">256</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a7b3b387e4b7df73ab84087789e51793a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_ENGLISH   "en"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001343">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00203">203</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a86b421b7341a237421f78a2a63184057"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_FRANCE   "fr_FR"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001355">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00228">228</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="afaf01f72121f4b5d55efd9b1906a637a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_FRENCH   "fr"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001344">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00205">205</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="ac070d94b27bb71f73bafd4c31ed53081"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_FULLNAME_CAPACITY   157</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for the maximum size of the whole locale ID (including the terminating NULL and all keywords). </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001365">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00262">262</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a3d0e219396f99a84c0935ca9e3906b9f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_GERMAN   "de"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001345">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00207">207</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a1b561518d9e0daef25e619b2c0c66dd9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_GERMANY   "de_DE"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001356">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00230">230</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="afafec50dc9f01b9222f2b294e00d37bc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_ITALIAN   "it"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001346">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00209">209</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="adb449b98da021a78151f4b929ecb4102"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_ITALY   "it_IT"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001357">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00232">232</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a7c98b1c45b011eb2165160270f10931c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_JAPAN   "ja_JP"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001358">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00234">234</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a9ea383605956797a51f7b292957a4635"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_JAPANESE   "ja"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001347">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00211">211</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a48dc9fb3bfd43ed8852387a725260622"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KEYWORD_AND_VALUES_CAPACITY   100</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for the maximum total size of keywords and their values in a locale. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001368">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00281">281</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a624227fd242e922ed98ee574df22b1f6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KEYWORD_ASSIGN   '='</td>
</tr>
</table>
</div><div class="memdoc">
<p>Invariant character for assigning value to a keyword. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001370">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00300">300</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="ab8dedf272c1a1594baeeeded697a14a6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KEYWORD_ASSIGN_UNICODE   0x3D</td>
</tr>
</table>
</div><div class="memdoc">
<p>Unicode code point for '=' for assigning value to a keyword. </p>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="uloc_8h.html#a624227fd242e922ed98ee574df22b1f6" title="Invariant character for assigning value to a keyword.">ULOC_KEYWORD_ASSIGN</a> </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000229">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.6 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00307">307</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a907733baa1967a626c1ebb36d327675d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KEYWORD_ITEM_SEPARATOR   ';'</td>
</tr>
</table>
</div><div class="memdoc">
<p>Invariant character separating keywords. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001371">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00313">313</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="ab729d122d9b777b5c23d4b07ede711a9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KEYWORD_ITEM_SEPARATOR_UNICODE   0x3B</td>
</tr>
</table>
</div><div class="memdoc">
<p>Unicode code point for ';' separating keywords. </p>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="uloc_8h.html#a907733baa1967a626c1ebb36d327675d" title="Invariant character separating keywords.">ULOC_KEYWORD_ITEM_SEPARATOR</a> </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000230">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.6 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00320">320</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a95caa9ed83b65408fc6fefed059e7a4e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KEYWORD_SEPARATOR   '@'</td>
</tr>
</table>
</div><div class="memdoc">
<p>Invariant character separating keywords from the locale string. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001369">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00287">287</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa910dc90d6e05009ba0125e65bde51cf"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KEYWORD_SEPARATOR_UNICODE   0x40</td>
</tr>
</table>
</div><div class="memdoc">
<p>Unicode code point for '@' separating keywords from the locale string. </p>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="uloc_8h.html#a95caa9ed83b65408fc6fefed059e7a4e" title="Invariant character separating keywords from the locale string.">ULOC_KEYWORD_SEPARATOR</a> </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000228">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.6 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00294">294</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a56c1ecca7967df9d83044fa54248ea03"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KEYWORDS_CAPACITY   50</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for the maximum size of keywords in a locale. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001367">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00275">275</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa56a91a89d347608d3d6af8821b7eea6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KOREA   "ko_KR"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001359">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00236">236</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="adc5c81580522c61757afccfc7b321259"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_KOREAN   "ko"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001348">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00213">213</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a9dd4ed9ce1465a8c98c5f9edafb8c933"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_LANG_CAPACITY   12</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for the maximum size of the language part of a locale ID. </p>
<p>(including the terminating NULL). </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001363">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00249">249</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a4dc1d8c0642fb43ced1ae6e609f28724"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_PRC   "zh_CN"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001354">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00226">226</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a2e60b17e30b020269c89c2ca83c8ea40"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_SCRIPT_CAPACITY   6</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for the maximum size of the script part of a locale ID (including the terminating NULL). </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001366">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00269">269</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a9e6ce1d4d9dd30192013320785f649ff"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_SIMPLIFIED_CHINESE   "zh_CN"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001349">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00215">215</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="ab1e44179a709c8b049bdd2aa4c805e50"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_TAIWAN   "zh_TW"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001360">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00238">238</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a65d0986d91df6188d055cea37b7631a6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_TRADITIONAL_CHINESE   "zh_TW"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this language. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001350">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00217">217</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a036c7ccbaa867fdd96d1b6390142d18c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_UK   "en_GB"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001361">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00240">240</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa55404d3c725af4e05e65e5b40a6e13d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ULOC_US   "en_US"</td>
</tr>
</table>
</div><div class="memdoc">
<p>Useful constant for this country/region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001362">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00242">242</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="a3ad5cb6cf40e47fec510070d20c29cf9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="uloc_8h.html#a3ad5cb6cf40e47fec510070d20c29cf9">UAcceptResult</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>enums for the 'outResult' parameter return value </p>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="uloc_8h.html#aced06018568333e1906ae104ab62757a" title="Based on a HTTP header from a web browser and a list of available locales, determine an acceptable lo...">uloc_acceptLanguageFromHTTP</a> </dd>
<dd>
<a class="el" href="uloc_8h.html#a3b9d2f95d1a205665a0597762fd08ca2" title="Based on a list of available locales, determine an acceptable locale for the user.">uloc_acceptLanguage</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001403">Stable:</a></b></dt><dd>ICU 3.2 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00923">923</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="a5570cc4b814b6cc9150ee0be5ee96ca5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="uloc_8h.html#a5570cc4b814b6cc9150ee0be5ee96ca5">ULayoutType</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>enums for the return value for the character and line orientation functions. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001400">Stable:</a></b></dt><dd>ICU 4.0 </dd></dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00885">885</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<a class="anchor" id="adf053345d343f8d82ae080f7a5871f34"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="uloc_8h.html#adf053345d343f8d82ae080f7a5871f34">ULocDataLocaleType</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Constants for *_getLocale() Allow user to select whether she wants information on requested, valid or actual locale. </p>
<p>For example, a collator for "en_US_CALIFORNIA" was requested. In the current state of ICU (2.0), the requested locale is "en_US_CALIFORNIA", the valid locale is "en_US" (most specific locale supported by ICU) and the actual locale is "root" (the collation data comes unmodified from the UCA) The locale is considered supported by ICU if there is a core ICU bundle for that locale (although it may be empty). </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001372">Stable:</a></b></dt><dd>ICU 2.1 </dd></dl>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="adf053345d343f8d82ae080f7a5871f34a95bd603a0102238a5235bf89a45edaf9"></a>ULOC_ACTUAL_LOCALE</em> </td><td>
<p>This is locale the data actually comes from. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001409">Stable:</a></b></dt><dd>ICU 2.1 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="adf053345d343f8d82ae080f7a5871f34abe12d6c03ab1fa05e028de64daf97d8c"></a>ULOC_VALID_LOCALE</em> </td><td>
<p>This is the most specific locale supported by ICU. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001410">Stable:</a></b></dt><dd>ICU 2.1 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="adf053345d343f8d82ae080f7a5871f34ae26d6cf4bf10b95b2bc1f58b2a00ef76"></a>ULOC_REQUESTED_LOCALE</em> </td><td>
<p>This is the requested locale. </p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000004">Deprecated:</a></b></dt><dd>ICU 2.8 </dd></dl>
</td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="uloc_8h_source.html#l00336">336</a> of file <a class="el" href="uloc_8h_source.html">uloc.h</a>.</p>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="a3b9d2f95d1a205665a0597762fd08ca2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_acceptLanguage </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>result</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>resultAvailable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="uloc_8h.html#a3ad5cb6cf40e47fec510070d20c29cf9">UAcceptResult</a> * </td>
<td class="paramname"><em>outResult</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char ** </td>
<td class="paramname"><em>acceptList</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>acceptListCount</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a> * </td>
<td class="paramname"><em>availableLocales</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>Based on a list of available locales, determine an acceptable locale for the user. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">result</td><td>- buffer to accept the result locale </td></tr>
<tr><td class="paramname">resultAvailable</td><td>the size of the result buffer. </td></tr>
<tr><td class="paramname">outResult</td><td>- An out parameter that contains the fallback status </td></tr>
<tr><td class="paramname">acceptList</td><td>- list of acceptable languages </td></tr>
<tr><td class="paramname">acceptListCount</td><td>- count of acceptList items </td></tr>
<tr><td class="paramname">availableLocales</td><td>- list of available locales to match </td></tr>
<tr><td class="paramname">status</td><td>Error status, may be BUFFER_OVERFLOW_ERROR </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>length needed for the locale. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001405">Stable:</a></b></dt><dd>ICU 3.2 </dd></dl>
</div>
</div>
<a class="anchor" id="aced06018568333e1906ae104ab62757a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_acceptLanguageFromHTTP </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>result</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>resultAvailable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="uloc_8h.html#a3ad5cb6cf40e47fec510070d20c29cf9">UAcceptResult</a> * </td>
<td class="paramname"><em>outResult</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>httpAcceptLanguage</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a> * </td>
<td class="paramname"><em>availableLocales</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>Based on a HTTP header from a web browser and a list of available locales, determine an acceptable locale for the user. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">result</td><td>- buffer to accept the result locale </td></tr>
<tr><td class="paramname">resultAvailable</td><td>the size of the result buffer. </td></tr>
<tr><td class="paramname">outResult</td><td>- An out parameter that contains the fallback status </td></tr>
<tr><td class="paramname">httpAcceptLanguage</td><td>- "Accept-Language:" header as per HTTP. </td></tr>
<tr><td class="paramname">availableLocales</td><td>- list of available locales to match </td></tr>
<tr><td class="paramname">status</td><td>Error status, may be BUFFER_OVERFLOW_ERROR </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>length needed for the locale. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001404">Stable:</a></b></dt><dd>ICU 3.2 </dd></dl>
</div>
</div>
<a class="anchor" id="a0cb2dcd65f745e7a966a729395499770"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_addLikelySubtags </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>maximizedLocaleID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>maximizedLocaleIDCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add the likely subtags for a provided locale ID, per the algorithm described in the following CLDR technical report: </p>
<p><a href="http://www.unicode.org/reports/tr35/#Likely_Subtags">http://www.unicode.org/reports/tr35/#Likely_Subtags</a></p>
<p>If localeID is already in the maximal form, or there is no data available for maximization, it will be copied to the output buffer. For example, "und-Zzzz" cannot be maximized, since there is no reasonable maximization.</p>
<p>Examples:</p>
<p>"en" maximizes to "en_Latn_US"</p>
<p>"de" maximizes to "de_Latn_US"</p>
<p>"sr" maximizes to "sr_Cyrl_RS"</p>
<p>"sh" maximizes to "sr_Latn_RS" (Note this will not reverse.)</p>
<p>"zh_Hani" maximizes to "zh_Hans_CN" (Note this will not reverse.)</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>The locale to maximize </td></tr>
<tr><td class="paramname">maximizedLocaleID</td><td>The maximized locale </td></tr>
<tr><td class="paramname">maximizedLocaleIDCapacity</td><td>The capacity of the maximizedLocaleID buffer </td></tr>
<tr><td class="paramname">err</td><td>Error information if maximizing the locale failed. If the length of the localeID and the null-terminator is greater than the maximum allowed size, or the localeId is not well-formed, the error code is U_ILLEGAL_ARGUMENT_ERROR. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>The actual buffer size needed for the maximized locale. If it's greater than maximizedLocaleIDCapacity, the returned ID will be truncated. On error, the return value is -1. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001407">Stable:</a></b></dt><dd>ICU 4.0 </dd></dl>
</div>
</div>
<a class="anchor" id="afe5adae51e287be339c57142947eb290"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_canonicalize </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>nameCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the full name for the specified locale. </p>
<p>Note: This has the effect of 'canonicalizing' the string to a certain extent. Upper and lower case are set as needed, and if the components were in 'POSIX' format they are changed to ICU format. It does NOT map aliased names in any way. See the top of this header file.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the full name with </td></tr>
<tr><td class="paramname">name</td><td>the full name for localeID </td></tr>
<tr><td class="paramname">nameCapacity</td><td>the size of the name buffer to store the full name with </td></tr>
<tr><td class="paramname">err</td><td>error information if retrieving the full name failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the full name. If it's greater than nameCapacity, the returned full name will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001380">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a5e2344d83cc55eee38595d50b62294dc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_countAvailable </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the size of the all available locale list. </p>
<dl class="section return"><dt>Returns:</dt><dd>the size of the locale list </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001392">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aa45d6457f72867880f079e27a63c6fcb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_forLanguageTag </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>langtag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>localeIDCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> * </td>
<td class="paramname"><em>parsedLength</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns a locale ID for the specified BCP47 language tag string. </p>
<p>If the specified language tag contains any ill-formed subtags, the first such subtag and all following subtags are ignored. </p>
<p>This implements the 'Language-Tag' production of BCP47, and so supports grandfathered (regular and irregular) as well as private use language tags. Private use tags are represented as 'x-whatever', and grandfathered tags are converted to their canonical replacements where they exist. Note that a few grandfathered tags have no modern replacement, these will be converted using the fallback described in the first paragraph, so some information might be lost. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">langtag</td><td>the input BCP47 language tag. </td></tr>
<tr><td class="paramname">localeID</td><td>the output buffer receiving a locale ID for the specified BCP47 language tag. </td></tr>
<tr><td class="paramname">localeIDCapacity</td><td>the size of the locale ID output buffer. </td></tr>
<tr><td class="paramname">parsedLength</td><td>if not NULL, succsessfully parsed length for the input language tag is set. </td></tr>
<tr><td class="paramname">err</td><td>error information if receiving the locald ID failed. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the length of the locale ID. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000231">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.2 </dd></dl>
</div>
</div>
<a class="anchor" id="a75df9657cc46472afa94e4cbd4a1529b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* uloc_getAvailable </td>
<td>(</td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>n</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the specified locale from a list of all available locales. </p>
<p>The return value is a pointer to an item of a locale name array. Both this array and the pointers it contains are owned by ICU and should not be deleted or written through by the caller. The locale name is terminated by a null pointer. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">n</td><td>the specific locale name index of the available locale list </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>a specified locale name of all available locales </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001391">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a6d153005b268df7f93ccb55219b646c5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getBaseName </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>nameCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the full name for the specified locale. </p>
<p>Note: This has the effect of 'canonicalizing' the string to a certain extent. Upper and lower case are set as needed, and if the components were in 'POSIX' format they are changed to ICU format. It does NOT map aliased names in any way. See the top of this header file. This API strips off the keyword part, so "de_DE\@collation=phonebook" will become "de_DE". This API supports preflighting.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the full name with </td></tr>
<tr><td class="paramname">name</td><td>fill in buffer for the name without keywords. </td></tr>
<tr><td class="paramname">nameCapacity</td><td>capacity of the fill in buffer. </td></tr>
<tr><td class="paramname">err</td><td>error information if retrieving the full name failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the full name. If it's greater than nameCapacity, the returned full name will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001396">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a2bb9a5571c5d0b8a47947456e79a170d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uloc_8h.html#a5570cc4b814b6cc9150ee0be5ee96ca5">ULayoutType</a> uloc_getCharacterOrientation </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeId</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 layout character orientation for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeId</td><td>locale name </td></tr>
<tr><td class="paramname">status</td><td>Error status </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>an enum indicating the layout orientation for characters. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001401">Stable:</a></b></dt><dd>ICU 4.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a248777437a9795b6bcf4b8c8d7e405db"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getCountry </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>country</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>countryCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the country code for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the country code with </td></tr>
<tr><td class="paramname">country</td><td>the country code for localeID </td></tr>
<tr><td class="paramname">countryCapacity</td><td>the size of the country buffer to store the country code with </td></tr>
<tr><td class="paramname">err</td><td>error information if retrieving the country code failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the country code. If it's greater than countryCapacity, the returned country code will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001377">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="adbc1e91581ae0e0ec421dafcc35c06c1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* uloc_getDefault </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets ICU's default locale. </p>
<p>The returned string is a snapshot in time, and will remain valid and unchanged even when <a class="el" href="uloc_8h.html#a472d1176dda100491e873e58018ba7d4" title="Sets ICU's default locale.">uloc_setDefault()</a> is called. The returned storage is owned by ICU, and must not be altered or deleted by the caller.</p>
<dl class="section return"><dt>Returns:</dt><dd>the ICU default locale </dd></dl>
<dl class="system"><dt><b><a class="el" href="system.html#_system000015">System:</a></b></dt><dd>Do not use unless you know what you are doing. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001373">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a2debe5d381bed15bc17a9f943e921e3a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getDisplayCountry </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">const char * </td>
<td class="paramname"><em>displayLocale</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>country</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>countryCapacity</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>Gets the country name suitable for display for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">locale</td><td>the locale to get the displayable country code with. NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">displayLocale</td><td>Specifies the locale to be used to display the name. In other words, if the locale's language code is "en", passing <a class="el" href="classLocale.html#ac4577a88016e7111bd37906c136951c7" title="Useful constant for this language.">Locale::getFrench()</a> for inLocale would result in "Anglais", while passing <a class="el" href="classLocale.html#a018ee898b7223c3b4cb3385d0f10464d" title="Useful constant for this language.">Locale::getGerman()</a> for inLocale would result in "Englisch". NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">country</td><td>the displayable country code for localeID </td></tr>
<tr><td class="paramname">countryCapacity</td><td>the size of the country buffer to store the displayable country code with </td></tr>
<tr><td class="paramname">status</td><td>error information if retrieving the displayable country code failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the displayable country code. If it's greater than countryCapacity, the returned displayable country code will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001386">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a17562898c39cd95b062b5e02b44ebce2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getDisplayKeyword </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>keyword</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>displayLocale</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>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </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> * </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>Gets the keyword name suitable for display for the specified locale. </p>
<p>E.g: for the locale string de_DE@collation=PHONEBOOK, this API gets the display string for the keyword collation. Usage: <code> UErrorCode status = U_ZERO_ERROR; const char* keyword =NULL; int32_t keywordLen = 0; int32_t keywordCount = 0; UChar displayKeyword[256]; int32_t displayKeywordLen = 0; UEnumeration* keywordEnum = uloc_openKeywords("de_DE@collation=PHONEBOOK;calendar=TRADITIONAL", &status); for(keywordCount = uenum_count(keywordEnum, &status); keywordCount > 0 ; keywordCount–){ if(<a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure?">U_FAILURE(status)</a>){ ...something went wrong so handle the error... break; } // the uenum_next returns NUL terminated string keyword = uenum_next(keywordEnum, &keywordLen, &status); displayKeywordLen = uloc_getDisplayKeyword(keyword, "en_US", displayKeyword, 256); ... do something interesting ..... } uenum_close(keywordEnum); </code> </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">keyword</td><td>The keyword whose display string needs to be returned. </td></tr>
<tr><td class="paramname">displayLocale</td><td>Specifies the locale to be used to display the name. In other words, if the locale's language code is "en", passing <a class="el" href="classLocale.html#ac4577a88016e7111bd37906c136951c7" title="Useful constant for this language.">Locale::getFrench()</a> for inLocale would result in "Anglais", while passing <a class="el" href="classLocale.html#a018ee898b7223c3b4cb3385d0f10464d" title="Useful constant for this language.">Locale::getGerman()</a> for inLocale would result in "Englisch". NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">dest</td><td>the buffer to which the displayable keyword should be written. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">status</td><td>error information if retrieving the displayable string failed. Should not be NULL and should not indicate failure on entry. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the displayable variant code. </dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="uloc_8h.html#a0ad2571c7225304fd9883ddc2047097c" title="Gets an enumeration of keywords for the specified locale.">uloc_openKeywords</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001388">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a5b7a991655765f14e6c79ff8b74b47ff"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getDisplayKeywordValue </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">const char * </td>
<td class="paramname"><em>keyword</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>displayLocale</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>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </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> * </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>Gets the value of the keyword suitable for display for the specified locale. </p>
<p>E.g: for the locale string de_DE@collation=PHONEBOOK, this API gets the display string for PHONEBOOK, in the display locale, when "collation" is specified as the keyword.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">locale</td><td>The locale to get the displayable variant code with. NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">keyword</td><td>The keyword for whose value should be used. </td></tr>
<tr><td class="paramname">displayLocale</td><td>Specifies the locale to be used to display the name. In other words, if the locale's language code is "en", passing <a class="el" href="classLocale.html#ac4577a88016e7111bd37906c136951c7" title="Useful constant for this language.">Locale::getFrench()</a> for inLocale would result in "Anglais", while passing <a class="el" href="classLocale.html#a018ee898b7223c3b4cb3385d0f10464d" title="Useful constant for this language.">Locale::getGerman()</a> for inLocale would result in "Englisch". NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">dest</td><td>the buffer to which the displayable keyword should be written. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">status</td><td>error information if retrieving the displayable string failed. Should not be NULL and must not indicate failure on entry. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the displayable variant code. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001389">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a3bf3527de225342853d1fe97503590f7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getDisplayLanguage </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">const char * </td>
<td class="paramname"><em>displayLocale</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>language</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>languageCapacity</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>Gets the language name suitable for display for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">locale</td><td>the locale to get the ISO language code with </td></tr>
<tr><td class="paramname">displayLocale</td><td>Specifies the locale to be used to display the name. In other words, if the locale's language code is "en", passing <a class="el" href="classLocale.html#ac4577a88016e7111bd37906c136951c7" title="Useful constant for this language.">Locale::getFrench()</a> for inLocale would result in "Anglais", while passing <a class="el" href="classLocale.html#a018ee898b7223c3b4cb3385d0f10464d" title="Useful constant for this language.">Locale::getGerman()</a> for inLocale would result in "Englisch". </td></tr>
<tr><td class="paramname">language</td><td>the displayable language code for localeID </td></tr>
<tr><td class="paramname">languageCapacity</td><td>the size of the language buffer to store the displayable language code with </td></tr>
<tr><td class="paramname">status</td><td>error information if retrieving the displayable language code failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the displayable language code. If it's greater than languageCapacity, the returned language code will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001384">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a3050cbd9c84aae5a406f923c8736e151"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getDisplayName </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>inLocaleID</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"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>maxResultSize</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the full name suitable for display for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the displayable name with. NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">inLocaleID</td><td>Specifies the locale to be used to display the name. In other words, if the locale's language code is "en", passing <a class="el" href="classLocale.html#ac4577a88016e7111bd37906c136951c7" title="Useful constant for this language.">Locale::getFrench()</a> for inLocale would result in "Anglais", while passing <a class="el" href="classLocale.html#a018ee898b7223c3b4cb3385d0f10464d" title="Useful constant for this language.">Locale::getGerman()</a> for inLocale would result in "Englisch". NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">result</td><td>the displayable name for localeID </td></tr>
<tr><td class="paramname">maxResultSize</td><td>the size of the name buffer to store the displayable full name with </td></tr>
<tr><td class="paramname">err</td><td>error information if retrieving the displayable name failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the displayable name. If it's greater than maxResultSize, the returned displayable name will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001390">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aabf272c2adcb6c0c7dc149bf33b0e39c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getDisplayScript </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">const char * </td>
<td class="paramname"><em>displayLocale</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>script</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>scriptCapacity</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>Gets the script name suitable for display for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">locale</td><td>the locale to get the displayable script code with. NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">displayLocale</td><td>Specifies the locale to be used to display the name. In other words, if the locale's language code is "en", passing <a class="el" href="classLocale.html#ac4577a88016e7111bd37906c136951c7" title="Useful constant for this language.">Locale::getFrench()</a> for inLocale would result in "", while passing <a class="el" href="classLocale.html#a018ee898b7223c3b4cb3385d0f10464d" title="Useful constant for this language.">Locale::getGerman()</a> for inLocale would result in "". NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">script</td><td>the displayable country code for localeID </td></tr>
<tr><td class="paramname">scriptCapacity</td><td>the size of the script buffer to store the displayable script code with </td></tr>
<tr><td class="paramname">status</td><td>error information if retrieving the displayable script code failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the displayable script code. If it's greater than scriptCapacity, the returned displayable script code will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001385">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a45c5307fc3c2ae57a8c7ec81eb441fd2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getDisplayVariant </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">const char * </td>
<td class="paramname"><em>displayLocale</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>variant</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>variantCapacity</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>Gets the variant name suitable for display for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">locale</td><td>the locale to get the displayable variant code with. NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">displayLocale</td><td>Specifies the locale to be used to display the name. In other words, if the locale's language code is "en", passing <a class="el" href="classLocale.html#ac4577a88016e7111bd37906c136951c7" title="Useful constant for this language.">Locale::getFrench()</a> for inLocale would result in "Anglais", while passing <a class="el" href="classLocale.html#a018ee898b7223c3b4cb3385d0f10464d" title="Useful constant for this language.">Locale::getGerman()</a> for inLocale would result in "Englisch". NULL may be used to specify the default. </td></tr>
<tr><td class="paramname">variant</td><td>the displayable variant code for localeID </td></tr>
<tr><td class="paramname">variantCapacity</td><td>the size of the variant buffer to store the displayable variant code with </td></tr>
<tr><td class="paramname">status</td><td>error information if retrieving the displayable variant code failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the displayable variant code. If it's greater than variantCapacity, the returned displayable variant code will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001387">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ad9950c4d96caa332816532fbedf641f2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* uloc_getISO3Country </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the ISO country code for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the ISO country code with </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>country the ISO country code for localeID </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001382">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ab1045e01cbf36fd8a4f8ae9b82ef4c94"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* uloc_getISO3Language </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the ISO language code for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the ISO language code with </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>language the ISO language code for localeID </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001381">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a673b0c89a78f098f797bab114eb8de82"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* const* uloc_getISOCountries </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets a list of all available 2-letter country codes defined in ISO 639. </p>
<p>This is a pointer to an array of pointers to arrays of char. All of these pointers are owned by ICU– do not delete them, and do not write through them. The array is terminated with a null pointer. </p>
<dl class="section return"><dt>Returns:</dt><dd>a list of all available country codes </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001394">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a9d4f51992a2efac9369c223b5aae9c37"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* const* uloc_getISOLanguages </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets a list of all available language codes defined in ISO 639. </p>
<p>This is a pointer to an array of pointers to arrays of char. All of these pointers are owned by ICU– do not delete them, and do not write through them. The array is terminated with a null pointer. </p>
<dl class="section return"><dt>Returns:</dt><dd>a list of all available language codes </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001393">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a1ac8cd994fc39ed8c3865b21cf4f47fa"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getKeywordValue </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>keywordName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </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> * </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 value for a keyword. </p>
<p><a class="el" href="classLocale.html" title="A Locale object represents a specific geographical, political, or cultural region.">Locale</a> name does not need to be normalized.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>locale name containing the keyword ("de_DE@currency=EURO;collation=PHONEBOOK") </td></tr>
<tr><td class="paramname">keywordName</td><td>name of the keyword for which we want the value. Case insensitive. </td></tr>
<tr><td class="paramname">buffer</td><td>receiving buffer </td></tr>
<tr><td class="paramname">bufferCapacity</td><td>capacity of receiving buffer </td></tr>
<tr><td class="paramname">status</td><td>containing error code - buffer not big enough. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the length of keyword value </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001398">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a8d88e113b134c0fd61b37815163abd8e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getLanguage </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>language</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>languageCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the language code for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the ISO language code with </td></tr>
<tr><td class="paramname">language</td><td>the language code for localeID </td></tr>
<tr><td class="paramname">languageCapacity</td><td>the size of the language buffer to store the language code with </td></tr>
<tr><td class="paramname">err</td><td>error information if retrieving the language code failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the language code. If it's greater than languageCapacity, the returned language code will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001375">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a18b4a9328cc5e90db4e8f3a1b79ebff5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#a435d1572bf3f880d55459d9805097f62">uint32_t</a> uloc_getLCID </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the Win32 LCID value for the specified locale. </p>
<p>If the ICU locale is not recognized by Windows, 0 will be returned.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the Win32 LCID value with </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>country the Win32 LCID for localeID </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001383">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ab6a3001d2c92046d7072087b880029fb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uloc_8h.html#a5570cc4b814b6cc9150ee0be5ee96ca5">ULayoutType</a> uloc_getLineOrientation </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeId</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 layout line orientation for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeId</td><td>locale name </td></tr>
<tr><td class="paramname">status</td><td>Error status </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>an enum indicating the layout orientation for lines. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001402">Stable:</a></b></dt><dd>ICU 4.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a623993d80071d113cbe64d20f6a4956c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getLocaleForLCID </td>
<td>(</td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#a435d1572bf3f880d55459d9805097f62">uint32_t</a> </td>
<td class="paramname"><em>hostID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>locale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>localeCapacity</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>Gets the ICU locale ID for the specified Win32 LCID value. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">hostID</td><td>the Win32 LCID to translate </td></tr>
<tr><td class="paramname">locale</td><td>the output buffer for the ICU locale ID, which will be NUL-terminated if there is room. </td></tr>
<tr><td class="paramname">localeCapacity</td><td>the size of the output buffer </td></tr>
<tr><td class="paramname">status</td><td>an error is returned if the LCID is unrecognized or the output buffer is too small </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>actual the actual size of the locale ID, not including NUL-termination </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001406">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a1b817e9efa7ca5711d3b5abd19227296"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getName </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>nameCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the full name for the specified locale. </p>
<p>Note: This has the effect of 'canonicalizing' the ICU locale ID to a certain extent. Upper and lower case are set as needed. It does NOT map aliased names in any way. See the top of this header file. This API supports preflighting.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the full name with </td></tr>
<tr><td class="paramname">name</td><td>fill in buffer for the name without keywords. </td></tr>
<tr><td class="paramname">nameCapacity</td><td>capacity of the fill in buffer. </td></tr>
<tr><td class="paramname">err</td><td>error information if retrieving the full name failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the full name. If it's greater than nameCapacity, the returned full name will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001379">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ab722eaa3e697c2df034e1a65fba0b06d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getParent </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>parent</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>parentCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Truncate the locale ID string to get the parent locale ID. </p>
<p>Copies the part of the string before the last underscore. The parent locale ID will be an empty string if there is no underscore, or if there is only one underscore at localeID[0].</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>Input locale ID string. </td></tr>
<tr><td class="paramname">parent</td><td>Output string buffer for the parent locale ID. </td></tr>
<tr><td class="paramname">parentCapacity</td><td>Size of the output buffer. </td></tr>
<tr><td class="paramname">err</td><td>A UErrorCode value. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>The length of the parent locale ID. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001395">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a6e9e30529b84f5b5e1213829e0a47144"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getScript </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>script</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>scriptCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the script code for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the ISO language code with </td></tr>
<tr><td class="paramname">script</td><td>the language code for localeID </td></tr>
<tr><td class="paramname">scriptCapacity</td><td>the size of the language buffer to store the language code with </td></tr>
<tr><td class="paramname">err</td><td>error information if retrieving the language code failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the language code. If it's greater than scriptCapacity, the returned language code will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001376">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="ac9d081c2f4e3f1736d943ec1d66b776f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_getVariant </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>variant</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>variantCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Gets the variant code for the specified locale. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the variant code with </td></tr>
<tr><td class="paramname">variant</td><td>the variant code for localeID </td></tr>
<tr><td class="paramname">variantCapacity</td><td>the size of the variant buffer to store the variant code with </td></tr>
<tr><td class="paramname">err</td><td>error information if retrieving the variant code failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the actual buffer size needed for the variant code. If it's greater than variantCapacity, the returned variant code will be truncated. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001378">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="acecda5c650c9a3a4e43900c676558e17"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_minimizeSubtags </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>minimizedLocaleID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>minimizedLocaleIDCapacity</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Minimize the subtags for a provided locale ID, per the algorithm described in the following CLDR technical report: </p>
<p><a href="http://www.unicode.org/reports/tr35/#Likely_Subtags">http://www.unicode.org/reports/tr35/#Likely_Subtags</a></p>
<p>If localeID is already in the minimal form, or there is no data available for minimization, it will be copied to the output buffer. Since the minimization algorithm relies on proper maximization, see the comments for uloc_addLikelySubtags for reasons why there might not be any data.</p>
<p>Examples:</p>
<p>"en_Latn_US" minimizes to "en"</p>
<p>"de_Latn_US" minimizes to "de"</p>
<p>"sr_Cyrl_RS" minimizes to "sr"</p>
<p>"zh_Hant_TW" minimizes to "zh_TW" (The region is preferred to the script, and minimizing to "zh" would imply "zh_Hans_CN".)</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>The locale to minimize </td></tr>
<tr><td class="paramname">minimizedLocaleID</td><td>The minimized locale </td></tr>
<tr><td class="paramname">minimizedLocaleIDCapacity</td><td>The capacity of the minimizedLocaleID buffer </td></tr>
<tr><td class="paramname">err</td><td>Error information if minimizing the locale failed. If the length of the localeID and the null-terminator is greater than the maximum allowed size, or the localeId is not well-formed, the error code is U_ILLEGAL_ARGUMENT_ERROR. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>The actual buffer size needed for the minimized locale. If it's greater than minimizedLocaleIDCapacity, the returned ID will be truncated. On error, the return value is -1. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001408">Stable:</a></b></dt><dd>ICU 4.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a0ad2571c7225304fd9883ddc2047097c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a>* uloc_openKeywords </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</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>Gets an enumeration of keywords for the specified locale. </p>
<p>Enumeration must get disposed of by the client using uenum_close function.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the locale to get the variant code with </td></tr>
<tr><td class="paramname">status</td><td>error information if retrieving the keywords failed </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>enumeration of keywords or NULL if there are no keywords. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001397">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a472d1176dda100491e873e58018ba7d4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void uloc_setDefault </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</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>Sets ICU's default locale. </p>
<p>By default (without calling this function), ICU's default locale will be based on information obtained from the underlying system environment. </p>
<p>Changes to ICU's default locale do not propagate back to the system environment. </p>
<p>Changes to ICU's default locale to not affect any ICU services that may already be open based on the previous default locale value.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the new ICU default locale. A value of NULL will try to get the system's default locale. </td></tr>
<tr><td class="paramname">status</td><td>the error information if the setting of default locale fails </td></tr>
</table>
</dd>
</dl>
<dl class="system"><dt><b><a class="el" href="system.html#_system000016">System:</a></b></dt><dd>Do not use unless you know what you are doing. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001374">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a4ba76d26bf66ef7629a649f6dfc3cc93"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_setKeywordValue </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>keywordName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>keywordValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </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> * </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>Set the value of the specified keyword. </p>
<p>NOTE: Unlike almost every other ICU function which takes a buffer, this function will NOT truncate the output text. If a BUFFER_OVERFLOW_ERROR is received, it means that the original buffer is untouched. This is done to prevent incorrect or possibly even malformed locales from being generated and used.</p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">keywordName</td><td>name of the keyword to be set. Case insensitive. </td></tr>
<tr><td class="paramname">keywordValue</td><td>value of the keyword to be set. If 0-length or NULL, will result in the keyword being removed. No error is given if that keyword does not exist. </td></tr>
<tr><td class="paramname">buffer</td><td>input buffer containing locale to be modified. </td></tr>
<tr><td class="paramname">bufferCapacity</td><td>capacity of receiving buffer </td></tr>
<tr><td class="paramname">status</td><td>containing error code - buffer not big enough. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>the length needed for the buffer </dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="uloc_8h.html#a1ac8cd994fc39ed8c3865b21cf4f47fa" title="Get the value for a keyword.">uloc_getKeywordValue</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001399">Stable:</a></b></dt><dd>ICU 3.2 </dd></dl>
</div>
</div>
<a class="anchor" id="a1d50c91925ca3853fce6f28cf7390c3c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> uloc_toLanguageTag </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>localeID</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>langtag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>langtagCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td>
<td class="paramname"><em>strict</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>err</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns a well-formed language tag for this locale ID. </p>
<p><b>Note</b>: When <code>strict</code> is FALSE, any locale fields which do not satisfy the BCP47 syntax requirement will be omitted from the result. When <code>strict</code> is TRUE, this function sets U_ILLEGAL_ARGUMENT_ERROR to the <code>err</code> if any locale fields do not satisfy the BCP47 syntax requirement. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">localeID</td><td>the input lcoale ID </td></tr>
<tr><td class="paramname">langtag</td><td>the output buffer receiving BCP47 language tag for the locale ID. </td></tr>
<tr><td class="paramname">langtagCapacity</td><td>the size of the BCP47 language tag output buffer. </td></tr>
<tr><td class="paramname">strict</td><td>boolean value indicating if the function returns an error for an ill-formed input locale ID. </td></tr>
<tr><td class="paramname">err</td><td>error information if receiving the language tag failed. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>The length of the BCP47 language tag. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000232">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.2 </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.1.1
</small></address>
</body>
</html>
