<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.11"/>
<title>ICU 58.2: uregion.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">ICU 58.2
 <span id="projectnumber">58.2</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_b2f33c71d4aa5e7af42a1ca61ff5af1b.html">source</a></li><li class="navelem"><a class="el" href="dir_3c42bef9a3e7804b3d74ebb2809ebf86.html">i18n</a></li><li class="navelem"><a class="el" href="dir_fa4147b4d9cbc9ae7619e21b25239322.html">unicode</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#typedef-members">Typedefs</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">uregion.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>C API: URegion (territory containment and mapping)
<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="uregion_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:aa6a33103246e52c0203c9cdac0ab5ed4"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#aa6a33103246e52c0203c9cdac0ab5ed4">URegionType</a></td></tr>
<tr class="memdesc:aa6a33103246e52c0203c9cdac0ab5ed4"><td class="mdescLeft"> </td><td class="mdescRight">URegionType is an enumeration defining the different types of regions. <a href="#aa6a33103246e52c0203c9cdac0ab5ed4">More...</a><br /></td></tr>
<tr class="separator:aa6a33103246e52c0203c9cdac0ab5ed4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a9f372ed3152687ee8d33df1864a89ecc"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a></td></tr>
<tr class="separator:a9f372ed3152687ee8d33df1864a89ecc"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:a75fa1508ee8a1321e62b254008acf0d5"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> { <br />
  <a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5ab44e2c4d2b28f5f4e320a36e3fcba0e4">URGN_UNKNOWN</a>,
<a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5ab5443a5253199f8444ae0c84e37388f5">URGN_TERRITORY</a>,
<a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5a6994d3caa0b9ac5401cccdd878b9e643">URGN_WORLD</a>,
<a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5a4e38392c5f0a20634e2fe64101632d3b">URGN_CONTINENT</a>,
<br />
  <a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5af387daccf5d2bb6a451946e7ac3c640c">URGN_SUBCONTINENT</a>,
<a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5a9ed8396709d098a33a6f64714c4670f8">URGN_GROUPING</a>,
<a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5ab4c29e68ebaa821eaa29ea2de2db8e8c">URGN_DEPRECATED</a>,
<a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5a072f41ac76d026cba1e9104be11f88ad">URGN_LIMIT</a>
<br />
}<tr class="memdesc:a75fa1508ee8a1321e62b254008acf0d5"><td class="mdescLeft"> </td><td class="mdescRight">URegionType is an enumeration defining the different types of regions. <a href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">More...</a><br /></td></tr>
</td></tr>
<tr class="separator:a75fa1508ee8a1321e62b254008acf0d5"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:a7dfca553daa91d5c148a69a14557374d"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#a7dfca553daa91d5c148a69a14557374d">uregion_getRegionFromCode</a> (const char *regionCode, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a7dfca553daa91d5c148a69a14557374d"><td class="mdescLeft"> </td><td class="mdescRight">Returns a pointer to a URegion for the specified region code: A 2-letter or 3-letter ISO 3166 code, UN M.49 numeric code (superset of ISO 3166 numeric codes), or other valid Unicode Region Code as defined by the LDML specification. <a href="#a7dfca553daa91d5c148a69a14557374d">More...</a><br /></td></tr>
<tr class="separator:a7dfca553daa91d5c148a69a14557374d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:afc23e3d85f4e2d75e2e7e5bead576799"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#afc23e3d85f4e2d75e2e7e5bead576799">uregion_getRegionFromNumericCode</a> (int32_t code, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:afc23e3d85f4e2d75e2e7e5bead576799"><td class="mdescLeft"> </td><td class="mdescRight">Returns a pointer to a URegion for the specified numeric region code. <a href="#afc23e3d85f4e2d75e2e7e5bead576799">More...</a><br /></td></tr>
<tr class="separator:afc23e3d85f4e2d75e2e7e5bead576799"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:abbd281defe97145c106a3c630f39fb84"><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="uregion_8h.html#abbd281defe97145c106a3c630f39fb84">uregion_getAvailable</a> (<a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> type, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:abbd281defe97145c106a3c630f39fb84"><td class="mdescLeft"> </td><td class="mdescRight">Returns an enumeration over the canonical codes of all known regions that match the given type. <a href="#abbd281defe97145c106a3c630f39fb84">More...</a><br /></td></tr>
<tr class="separator:abbd281defe97145c106a3c630f39fb84"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a97bd524eea32a30400bf870b6a9d64b5"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#a97bd524eea32a30400bf870b6a9d64b5">uregion_areEqual</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion, const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *otherRegion)</td></tr>
<tr class="memdesc:a97bd524eea32a30400bf870b6a9d64b5"><td class="mdescLeft"> </td><td class="mdescRight">Returns true if the specified uregion is equal to the specified otherRegion. <a href="#a97bd524eea32a30400bf870b6a9d64b5">More...</a><br /></td></tr>
<tr class="separator:a97bd524eea32a30400bf870b6a9d64b5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:adb5efceba157c37a80392fb2df464e1e"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#adb5efceba157c37a80392fb2df464e1e">uregion_getContainingRegion</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion)</td></tr>
<tr class="memdesc:adb5efceba157c37a80392fb2df464e1e"><td class="mdescLeft"> </td><td class="mdescRight">Returns a pointer to the URegion that contains the specified uregion. <a href="#adb5efceba157c37a80392fb2df464e1e">More...</a><br /></td></tr>
<tr class="separator:adb5efceba157c37a80392fb2df464e1e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a11f2833d4ba9958b5a92c94a1c3942b5"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#a11f2833d4ba9958b5a92c94a1c3942b5">uregion_getContainingRegionOfType</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion, <a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> type)</td></tr>
<tr class="memdesc:a11f2833d4ba9958b5a92c94a1c3942b5"><td class="mdescLeft"> </td><td class="mdescRight">Return a pointer to the URegion that geographically contains this uregion and matches the specified type, moving multiple steps up the containment chain if necessary. <a href="#a11f2833d4ba9958b5a92c94a1c3942b5">More...</a><br /></td></tr>
<tr class="separator:a11f2833d4ba9958b5a92c94a1c3942b5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af582b5d49e9bcfe6cc56a866431308c7"><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="uregion_8h.html#af582b5d49e9bcfe6cc56a866431308c7">uregion_getContainedRegions</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:af582b5d49e9bcfe6cc56a866431308c7"><td class="mdescLeft"> </td><td class="mdescRight">Return an enumeration over the canonical codes of all the regions that are immediate children of the specified uregion in the region hierarchy. <a href="#af582b5d49e9bcfe6cc56a866431308c7">More...</a><br /></td></tr>
<tr class="separator:af582b5d49e9bcfe6cc56a866431308c7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:abee2eb42e95a426d19c1a1e0bd2688fa"><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="uregion_8h.html#abee2eb42e95a426d19c1a1e0bd2688fa">uregion_getContainedRegionsOfType</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion, <a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> type, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:abee2eb42e95a426d19c1a1e0bd2688fa"><td class="mdescLeft"> </td><td class="mdescRight">Returns an enumeration over the canonical codes of all the regions that are children of the specified uregion anywhere in the region hierarchy and match the given type. <a href="#abee2eb42e95a426d19c1a1e0bd2688fa">More...</a><br /></td></tr>
<tr class="separator:abee2eb42e95a426d19c1a1e0bd2688fa"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3cf21dd065a408a3eb53bc01f9ca9f91"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#a3cf21dd065a408a3eb53bc01f9ca9f91">uregion_contains</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion, const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *otherRegion)</td></tr>
<tr class="memdesc:a3cf21dd065a408a3eb53bc01f9ca9f91"><td class="mdescLeft"> </td><td class="mdescRight">Returns true if the specified uregion contains the specified otherRegion anywhere in the region hierarchy. <a href="#a3cf21dd065a408a3eb53bc01f9ca9f91">More...</a><br /></td></tr>
<tr class="separator:a3cf21dd065a408a3eb53bc01f9ca9f91"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a9f97397e19609afd5d9b1013e6956517"><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="uregion_8h.html#a9f97397e19609afd5d9b1013e6956517">uregion_getPreferredValues</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *status)</td></tr>
<tr class="memdesc:a9f97397e19609afd5d9b1013e6956517"><td class="mdescLeft"> </td><td class="mdescRight">If the specified uregion is deprecated, returns an enumeration over the canonical codes of the regions that are the preferred replacement regions for the specified uregion. <a href="#a9f97397e19609afd5d9b1013e6956517">More...</a><br /></td></tr>
<tr class="separator:a9f97397e19609afd5d9b1013e6956517"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:adb6fdbafaa17c7508ba2d69f2d352173"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#adb6fdbafaa17c7508ba2d69f2d352173">uregion_getRegionCode</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion)</td></tr>
<tr class="memdesc:adb6fdbafaa17c7508ba2d69f2d352173"><td class="mdescLeft"> </td><td class="mdescRight">Returns the specified uregion's canonical code. <a href="#adb6fdbafaa17c7508ba2d69f2d352173">More...</a><br /></td></tr>
<tr class="separator:adb6fdbafaa17c7508ba2d69f2d352173"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af1d4f28286e974eb2339e94881ee3c91"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#af1d4f28286e974eb2339e94881ee3c91">uregion_getNumericCode</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion)</td></tr>
<tr class="memdesc:af1d4f28286e974eb2339e94881ee3c91"><td class="mdescLeft"> </td><td class="mdescRight">Returns the specified uregion's numeric code, or a negative value if there is no numeric code for the specified uregion. <a href="#af1d4f28286e974eb2339e94881ee3c91">More...</a><br /></td></tr>
<tr class="separator:af1d4f28286e974eb2339e94881ee3c91"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a49fdbc4b16952c3f6433dd1b7ec3236e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="uregion_8h.html#a49fdbc4b16952c3f6433dd1b7ec3236e">uregion_getType</a> (const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> *uregion)</td></tr>
<tr class="memdesc:a49fdbc4b16952c3f6433dd1b7ec3236e"><td class="mdescLeft"> </td><td class="mdescRight">Returns the URegionType of the specified uregion. <a href="#a49fdbc4b16952c3f6433dd1b7ec3236e">More...</a><br /></td></tr>
<tr class="separator:a49fdbc4b16952c3f6433dd1b7ec3236e"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>C API: URegion (territory containment and mapping) </p>
<p>URegion objects represent data associated with a particular Unicode Region Code, also known as a Unicode Region Subtag, which is defined based upon the BCP 47 standard. These include:</p><ul>
<li>Two-letter codes defined by ISO 3166-1, with special LDML treatment of certain private-use or reserved codes;</li>
<li>A subset of 3-digit numeric codes defined by UN M.49. URegion objects can also provide mappings to and from additional codes. There are different types of regions that are important to distinguish: </li>
</ul>
<p>Macroregion - A code for a "macro geographical (continental) region, geographical sub-region, or
selected economic and other grouping" as defined in UN M.49. These are typically 3-digit codes, but contain some 2-letter codes for LDML extensions, such as "QO" for Outlying Oceania. Macroregions are represented in ICU by one of three region types: WORLD (code 001), CONTINENTS (regions contained directly by WORLD), and SUBCONTINENTS (regions contained directly by a continent ). </p>
<p>TERRITORY - A Region that is not a Macroregion. These are typically codes for countries, but also include areas that are not separate countries, such as the code "AQ" for Antarctica or the code "HK" for Hong Kong (SAR China). Overseas dependencies of countries may or may not have separate codes. The codes are typically 2-letter codes aligned with ISO 3166, but BCP47 allows for the use of 3-digit codes in the future. </p>
<p>UNKNOWN - The code ZZ is defined by Unicode LDML for use in indicating that region is unknown, or that the value supplied as a region was invalid. </p>
<p>DEPRECATED - Region codes that have been defined in the past but are no longer in modern usage, usually due to a country splitting into multiple territories or changing its name. </p>
<p>GROUPING - A widely understood grouping of territories that has a well defined membership such that a region code has been assigned for it. Some of these are UN M.49 codes that don't fall into the world/continent/sub-continent hierarchy, while others are just well-known groupings that have their own region code. Region "EU" (European Union) is one such region code that is a grouping. Groupings will never be returned by the uregion_getContainingRegion, since a different type of region (WORLD, CONTINENT, or SUBCONTINENT) will always be the containing region instead.</p>
<p>URegion objects are const/immutable, owned and maintained by ICU itself, so there are not functions to open or close them. </p>
<p>Definition in file <a class="el" href="uregion_8h_source.html">uregion.h</a>.</p>
</div><h2 class="groupheader">Typedef Documentation</h2>
<a class="anchor" id="a9f372ed3152687ee8d33df1864a89ecc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005485">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
<p>Definition at line <a class="el" href="uregion_8h_source.html#l00126">126</a> of file <a class="el" href="uregion_8h_source.html">uregion.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa6a33103246e52c0203c9cdac0ab5ed4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef enum <a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> <a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>URegionType is an enumeration defining the different types of regions. </p>
<p>Current possible values are URGN_WORLD, URGN_CONTINENT, URGN_SUBCONTINENT, URGN_TERRITORY, URGN_GROUPING, URGN_DEPRECATED, and URGN_UNKNOWN.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005483">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
</div>
</div>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>URegionType is an enumeration defining the different types of regions. </p>
<p>Current possible values are URGN_WORLD, URGN_CONTINENT, URGN_SUBCONTINENT, URGN_TERRITORY, URGN_GROUPING, URGN_DEPRECATED, and URGN_UNKNOWN.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005483">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5ab44e2c4d2b28f5f4e320a36e3fcba0e4"></a>URGN_UNKNOWN </td><td class="fielddoc">
<p>Type representing the unknown region. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005499">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5ab5443a5253199f8444ae0c84e37388f5"></a>URGN_TERRITORY </td><td class="fielddoc">
<p>Type representing a territory. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005500">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5a6994d3caa0b9ac5401cccdd878b9e643"></a>URGN_WORLD </td><td class="fielddoc">
<p>Type representing the whole world. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005501">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5a4e38392c5f0a20634e2fe64101632d3b"></a>URGN_CONTINENT </td><td class="fielddoc">
<p>Type representing a continent. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005502">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5af387daccf5d2bb6a451946e7ac3c640c"></a>URGN_SUBCONTINENT </td><td class="fielddoc">
<p>Type representing a sub-continent. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005503">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5a9ed8396709d098a33a6f64714c4670f8"></a>URGN_GROUPING </td><td class="fielddoc">
<p>Type representing a grouping of territories that is not to be used in the normal WORLD/CONTINENT/SUBCONTINENT/TERRITORY containment tree. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005504">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5ab4c29e68ebaa821eaa29ea2de2db8e8c"></a>URGN_DEPRECATED </td><td class="fielddoc">
<p>Type representing a region whose code has been deprecated, usually due to a country splitting into multiple territories or changing its name. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005505">Stable:</a></b></dt><dd>ICU 51 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a class="anchor" id="a75fa1508ee8a1321e62b254008acf0d5a072f41ac76d026cba1e9104be11f88ad"></a>URGN_LIMIT </td><td class="fielddoc">
<p>One more than the highest normal URegionType value. </p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000429">Deprecated:</a></b></dt><dd>ICU 58 The numeric value may change over time, see ICU ticket #12420. </dd></dl>
</td></tr>
</table>
<p>Definition at line <a class="el" href="uregion_8h_source.html#l00065">65</a> of file <a class="el" href="uregion_8h_source.html">uregion.h</a>.</p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="a97bd524eea32a30400bf870b6a9d64b5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> uregion_areEqual </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>otherRegion</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns true if the specified uregion is equal to the specified otherRegion. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005489">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a3cf21dd065a408a3eb53bc01f9ca9f91"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> uregion_contains </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>otherRegion</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns true if the specified uregion contains the specified otherRegion anywhere in the region hierarchy. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005494">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="abbd281defe97145c106a3c630f39fb84"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a>* uregion_getAvailable </td>
<td>(</td>
<td class="paramtype"><a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> </td>
<td class="paramname"><em>type</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>Returns an enumeration over the canonical codes of all known regions that match the given type. </p>
<p>The enumeration must be closed with with <a class="el" href="uenum_8h.html#af8bf1abcf3a486f07ee3384c7fce89df" title="Disposes of resources in use by the iterator. ">uenum_close()</a>. </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable005488">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="af582b5d49e9bcfe6cc56a866431308c7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a>* uregion_getContainedRegions </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</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>Return an enumeration over the canonical codes of all the regions that are immediate children of the specified uregion in the region hierarchy. </p>
<p>These returned regions could be either macro regions, territories, or a mixture of the two, depending on the containment data as defined in CLDR. This API returns NULL if this uregion doesn't have any sub-regions. For example, calling this function for uregion "150" (Europe) returns an enumeration containing the various sub-regions of Europe: "039" (Southern Europe), "151" (Eastern Europe), "154" (Northern Europe), and "155" (Western Europe). The enumeration must be closed with with <a class="el" href="uenum_8h.html#af8bf1abcf3a486f07ee3384c7fce89df" title="Disposes of resources in use by the iterator. ">uenum_close()</a>. </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable005492">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="abee2eb42e95a426d19c1a1e0bd2688fa"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a>* uregion_getContainedRegionsOfType </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> </td>
<td class="paramname"><em>type</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>Returns an enumeration over the canonical codes of all the regions that are children of the specified uregion anywhere in the region hierarchy and match the given type. </p>
<p>This API may return an empty enumeration if this uregion doesn't have any sub-regions that match the given type. For example, calling this method with region "150" (Europe) and type URGN_TERRITORY" returns an
enumeration containing all the territories in Europe: "FR" (France), "IT" (Italy), "DE" (Germany), etc. The enumeration must be closed with with <a class="el" href="uenum_8h.html#af8bf1abcf3a486f07ee3384c7fce89df" title="Disposes of resources in use by the iterator. ">uenum_close()</a>. </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable005493">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="adb5efceba157c37a80392fb2df464e1e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a>* uregion_getContainingRegion </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns a pointer to the URegion that contains the specified uregion. </p>
<p>Returns NULL if the specified uregion is code "001" (World) or "ZZ" (Unknown region). For example, calling this method with region "IT" (Italy) returns the URegion for "039" (Southern Europe). </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable005490">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a11f2833d4ba9958b5a92c94a1c3942b5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a>* uregion_getContainingRegionOfType </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> </td>
<td class="paramname"><em>type</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return a pointer to the URegion that geographically contains this uregion and matches the specified type, moving multiple steps up the containment chain if necessary. </p>
<p>Returns NULL if no containing region can be found that matches the specified type. Will return NULL if URegionType is URGN_GROUPING, URGN_DEPRECATED, or URGN_UNKNOWN which are not appropriate for this API. For example, calling this method with uregion "IT" (Italy) for type URGN_CONTINENT returns the URegion "150" (Europe). </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable005491">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="af1d4f28286e974eb2339e94881ee3c91"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t uregion_getNumericCode </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the specified uregion's numeric code, or a negative value if there is no numeric code for the specified uregion. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005497">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a9f97397e19609afd5d9b1013e6956517"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a>* uregion_getPreferredValues </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</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>If the specified uregion is deprecated, returns an enumeration over the canonical codes of the regions that are the preferred replacement regions for the specified uregion. </p>
<p>If the specified uregion is not deprecated, returns NULL. For example, calling this method with uregion "SU" (Soviet Union) returns a list of the regions containing "RU" (Russia), "AM" (Armenia), "AZ" (Azerbaijan), etc... The enumeration must be closed with with <a class="el" href="uenum_8h.html#af8bf1abcf3a486f07ee3384c7fce89df" title="Disposes of resources in use by the iterator. ">uenum_close()</a>. </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable005495">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="adb6fdbafaa17c7508ba2d69f2d352173"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* uregion_getRegionCode </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the specified uregion's canonical code. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005496">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a7dfca553daa91d5c148a69a14557374d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a>* uregion_getRegionFromCode </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>regionCode</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>Returns a pointer to a URegion for the specified region code: A 2-letter or 3-letter ISO 3166 code, UN M.49 numeric code (superset of ISO 3166 numeric codes), or other valid Unicode Region Code as defined by the LDML specification. </p>
<p>The code will be canonicalized internally. If the region code is NULL or not recognized, the appropriate error code will be set (U_ILLEGAL_ARGUMENT_ERROR). </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable005486">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="afc23e3d85f4e2d75e2e7e5bead576799"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a>* uregion_getRegionFromNumericCode </td>
<td>(</td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>code</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>Returns a pointer to a URegion for the specified numeric region code. </p>
<p>If the numeric region code is not recognized, the appropriate error code will be set (U_ILLEGAL_ARGUMENT_ERROR). </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable005487">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
<a class="anchor" id="a49fdbc4b16952c3f6433dd1b7ec3236e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uregion_8h.html#a75fa1508ee8a1321e62b254008acf0d5">URegionType</a> uregion_getType </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="uregion_8h.html#a9f372ed3152687ee8d33df1864a89ecc">URegion</a> * </td>
<td class="paramname"><em>uregion</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the URegionType of the specified uregion. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable005498">Stable:</a></b></dt><dd>ICU 52 </dd></dl>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.11
</small></address>
</body>
</html>
distrib
>
Mageia
>
6
>
armv5tl
>
media
>
core-release
>
by-pkgid
>
3a4e91bde08970529a0aa07935652fe8
>
files
>
1026
