File: //opt/alt/alt-nodejs24/root/usr/share/doc/alt-nodejs24-libicu-doc/ucasemap_8h.html
<!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.14"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>ICU 77.1: common/unicode/ucasemap.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/searchdata.js"></script>
<script type="text/javascript" src="search/search.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 77.1
 <span id="projectnumber">77.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.14 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</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="#namespaces">Namespaces</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">ucasemap.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>C API: Unicode case mapping functions using a UCaseMap service object.
<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="stringoptions_8h_source.html">unicode/stringoptions.h</a>"</code><br />
<code>#include "<a class="el" href="ustring_8h_source.html">unicode/ustring.h</a>"</code><br />
<code>#include "<a class="el" href="localpointer_8h_source.html">unicode/localpointer.h</a>"</code><br />
</div>
<p><a href="ucasemap_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="namespaces"></a>
Namespaces</h2></td></tr>
<tr class="memitem:namespaceicu"><td class="memItemLeft" align="right" valign="top">  </td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceicu.html">icu</a></td></tr>
<tr class="memdesc:namespaceicu"><td class="mdescLeft"> </td><td class="mdescRight">File <a class="el" href="coll_8h.html" title="C++ API: Collation Service. ">coll.h</a>. <br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:a2c127e061c4bc5f4ccc9defbe01f9dca"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a></td></tr>
<tr class="memdesc:a2c127e061c4bc5f4ccc9defbe01f9dca"><td class="mdescLeft"> </td><td class="mdescRight">C typedef for struct UCaseMap. <a href="#a2c127e061c4bc5f4ccc9defbe01f9dca">More...</a><br /></td></tr>
<tr class="separator:a2c127e061c4bc5f4ccc9defbe01f9dca"><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:a9ff7023a324bf757c7520c62f13b26ef"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a9ff7023a324bf757c7520c62f13b26ef">ucasemap_open</a> (const char *locale, uint32_t options, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a9ff7023a324bf757c7520c62f13b26ef"><td class="mdescLeft"> </td><td class="mdescRight">Open a UCaseMap service object for a locale and a set of options. <a href="#a9ff7023a324bf757c7520c62f13b26ef">More...</a><br /></td></tr>
<tr class="separator:a9ff7023a324bf757c7520c62f13b26ef"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a41646ac28193dc2a147a7d315bfbd044"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a41646ac28193dc2a147a7d315bfbd044">ucasemap_close</a> (<a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm)</td></tr>
<tr class="memdesc:a41646ac28193dc2a147a7d315bfbd044"><td class="mdescLeft"> </td><td class="mdescRight">Close a UCaseMap service object. <a href="#a41646ac28193dc2a147a7d315bfbd044">More...</a><br /></td></tr>
<tr class="separator:a41646ac28193dc2a147a7d315bfbd044"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad7f645f22fa6b7c2b63dcd3bc93074db"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#ad7f645f22fa6b7c2b63dcd3bc93074db">ucasemap_getLocale</a> (const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm)</td></tr>
<tr class="memdesc:ad7f645f22fa6b7c2b63dcd3bc93074db"><td class="mdescLeft"> </td><td class="mdescRight">Get the locale ID that is used for language-dependent case mappings. <a href="#ad7f645f22fa6b7c2b63dcd3bc93074db">More...</a><br /></td></tr>
<tr class="separator:ad7f645f22fa6b7c2b63dcd3bc93074db"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a02803d7ab7a39f867032c331bddebfda"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a02803d7ab7a39f867032c331bddebfda">ucasemap_getOptions</a> (const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm)</td></tr>
<tr class="memdesc:a02803d7ab7a39f867032c331bddebfda"><td class="mdescLeft"> </td><td class="mdescRight">Get the options bit set that is used for case folding and string comparisons. <a href="#a02803d7ab7a39f867032c331bddebfda">More...</a><br /></td></tr>
<tr class="separator:a02803d7ab7a39f867032c331bddebfda"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad23904727e58dde9ed2c8e4d79c7d5f2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#ad23904727e58dde9ed2c8e4d79c7d5f2">ucasemap_setLocale</a> (<a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, const char *locale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:ad23904727e58dde9ed2c8e4d79c7d5f2"><td class="mdescLeft"> </td><td class="mdescRight">Set the locale ID that is used for language-dependent case mappings. <a href="#ad23904727e58dde9ed2c8e4d79c7d5f2">More...</a><br /></td></tr>
<tr class="separator:ad23904727e58dde9ed2c8e4d79c7d5f2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a1994b1c82545e12449d1bdb801f61012"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a1994b1c82545e12449d1bdb801f61012">ucasemap_setOptions</a> (<a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, uint32_t options, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a1994b1c82545e12449d1bdb801f61012"><td class="mdescLeft"> </td><td class="mdescRight">Set the options bit set that is used for case folding and string comparisons. <a href="#a1994b1c82545e12449d1bdb801f61012">More...</a><br /></td></tr>
<tr class="separator:a1994b1c82545e12449d1bdb801f61012"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ab59570026822f4174e5dcc509e58c136"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> const <a class="el" href="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#ab59570026822f4174e5dcc509e58c136">ucasemap_getBreakIterator</a> (const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm)</td></tr>
<tr class="memdesc:ab59570026822f4174e5dcc509e58c136"><td class="mdescLeft"> </td><td class="mdescRight">Get the break iterator that is used for titlecasing. <a href="#ab59570026822f4174e5dcc509e58c136">More...</a><br /></td></tr>
<tr class="separator:ab59570026822f4174e5dcc509e58c136"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7c3c5c9467281b037eddaa0d11fa84bd"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a7c3c5c9467281b037eddaa0d11fa84bd">ucasemap_setBreakIterator</a> (<a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, <a class="el" href="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a> *iterToAdopt, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a7c3c5c9467281b037eddaa0d11fa84bd"><td class="mdescLeft"> </td><td class="mdescRight">Set the break iterator that is used for titlecasing. <a href="#a7c3c5c9467281b037eddaa0d11fa84bd">More...</a><br /></td></tr>
<tr class="separator:a7c3c5c9467281b037eddaa0d11fa84bd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa49d8b403bd91c52f127fe80679bac11"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#aa49d8b403bd91c52f127fe80679bac11">ucasemap_toTitle</a> (<a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:aa49d8b403bd91c52f127fe80679bac11"><td class="mdescLeft"> </td><td class="mdescRight">Titlecase a UTF-16 string. <a href="#aa49d8b403bd91c52f127fe80679bac11">More...</a><br /></td></tr>
<tr class="separator:aa49d8b403bd91c52f127fe80679bac11"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a043b0308f87180761deda714eb48e9b3"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a043b0308f87180761deda714eb48e9b3">ucasemap_utf8ToLower</a> (const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, char *dest, int32_t destCapacity, const char *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a043b0308f87180761deda714eb48e9b3"><td class="mdescLeft"> </td><td class="mdescRight">Lowercase the characters in a UTF-8 string. <a href="#a043b0308f87180761deda714eb48e9b3">More...</a><br /></td></tr>
<tr class="separator:a043b0308f87180761deda714eb48e9b3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2ab9b569e7a51ce1effd51fe81939ed3"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a2ab9b569e7a51ce1effd51fe81939ed3">ucasemap_utf8ToUpper</a> (const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, char *dest, int32_t destCapacity, const char *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a2ab9b569e7a51ce1effd51fe81939ed3"><td class="mdescLeft"> </td><td class="mdescRight">Uppercase the characters in a UTF-8 string. <a href="#a2ab9b569e7a51ce1effd51fe81939ed3">More...</a><br /></td></tr>
<tr class="separator:a2ab9b569e7a51ce1effd51fe81939ed3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6184d1a126b3d455a519418e0ee8ef7b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a6184d1a126b3d455a519418e0ee8ef7b">ucasemap_utf8ToTitle</a> (<a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, char *dest, int32_t destCapacity, const char *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a6184d1a126b3d455a519418e0ee8ef7b"><td class="mdescLeft"> </td><td class="mdescRight">Titlecase a UTF-8 string. <a href="#a6184d1a126b3d455a519418e0ee8ef7b">More...</a><br /></td></tr>
<tr class="separator:a6184d1a126b3d455a519418e0ee8ef7b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a243a148e64a479503c4044fd6e298768"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ucasemap_8h.html#a243a148e64a479503c4044fd6e298768">ucasemap_utf8FoldCase</a> (const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, char *dest, int32_t destCapacity, const char *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a243a148e64a479503c4044fd6e298768"><td class="mdescLeft"> </td><td class="mdescRight">Case-folds the characters in a UTF-8 string. <a href="#a243a148e64a479503c4044fd6e298768">More...</a><br /></td></tr>
<tr class="separator:a243a148e64a479503c4044fd6e298768"><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: Unicode case mapping functions using a UCaseMap service object. </p>
<p>The service object takes care of memory allocations, data loading, and setup for the attributes, as usual.</p>
<p>Currently, the functionality provided here does not overlap with <a class="el" href="uchar_8h.html" title="C API: Unicode Properties. ">uchar.h</a> and <a class="el" href="ustring_8h.html" title="C API: Unicode string handling functions. ">ustring.h</a>, except for <a class="el" href="ucasemap_8h.html#aa49d8b403bd91c52f127fe80679bac11" title="Titlecase a UTF-16 string. ">ucasemap_toTitle()</a>.</p>
<p>ucasemap_utf8XYZ() functions operate directly on UTF-8 strings. </p>
<p class="definition">Definition in file <a class="el" href="ucasemap_8h_source.html">ucasemap.h</a>.</p>
</div><h2 class="groupheader">Typedef Documentation</h2>
<a id="a2c127e061c4bc5f4ccc9defbe01f9dca"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2c127e061c4bc5f4ccc9defbe01f9dca">◆ </a></span>UCaseMap</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>C typedef for struct UCaseMap. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000950">Stable:</a></b></dt><dd>ICU 3.4 </dd></dl>
<p class="definition">Definition at line <a class="el" href="ucasemap_8h_source.html#l00051">51</a> of file <a class="el" href="ucasemap_8h_source.html">ucasemap.h</a>.</p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="a41646ac28193dc2a147a7d315bfbd044"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a41646ac28193dc2a147a7d315bfbd044">◆ </a></span>ucasemap_close()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void ucasemap_close </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Close a UCaseMap service object. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>Object to be closed. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000952">Stable:</a></b></dt><dd>ICU 3.4 </dd></dl>
</div>
</div>
<a id="ab59570026822f4174e5dcc509e58c136"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ab59570026822f4174e5dcc509e58c136">◆ </a></span>ucasemap_getBreakIterator()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> const <a class="el" href="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a>* ucasemap_getBreakIterator </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the break iterator that is used for titlecasing. </p>
<p>Do not modify the returned break iterator. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>titlecasing break iterator </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000957">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a id="ad7f645f22fa6b7c2b63dcd3bc93074db"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad7f645f22fa6b7c2b63dcd3bc93074db">◆ </a></span>ucasemap_getLocale()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> const char* ucasemap_getLocale </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the locale ID that is used for language-dependent case mappings. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>locale ID </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000953">Stable:</a></b></dt><dd>ICU 3.4 </dd></dl>
</div>
</div>
<a id="a02803d7ab7a39f867032c331bddebfda"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a02803d7ab7a39f867032c331bddebfda">◆ </a></span>ucasemap_getOptions()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> uint32_t ucasemap_getOptions </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the options bit set that is used for case folding and string comparisons. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>options bit set </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000954">Stable:</a></b></dt><dd>ICU 3.4 </dd></dl>
</div>
</div>
<a id="a9ff7023a324bf757c7520c62f13b26ef"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a9ff7023a324bf757c7520c62f13b26ef">◆ </a></span>ucasemap_open()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a>* ucasemap_open </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>locale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t </td>
<td class="paramname"><em>options</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>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Open a UCaseMap service object for a locale and a set of options. </p>
<p>The locale ID and options are preprocessed so that functions using the service object need not process them in each call.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">locale</td><td>ICU locale ID, used for language-dependent upper-/lower-/title-casing according to the Unicode standard. Usual semantics: ""=root, NULL=default locale, etc. </td></tr>
<tr><td class="paramname">options</td><td>Options bit set, used for case folding and string comparisons. Same flags as for <a class="el" href="uchar_8h.html#ac8b842a75fa2efd3907c5408382c9991" title="The given character is mapped to its case folding equivalent according to UnicodeData.txt and CaseFolding.txt; if the character has no case folding equivalent, the character itself is returned. ">u_foldCase()</a>, <a class="el" href="ustring_8h.html#ae514cad63c76897567f1d7535e857852" title="Case-folds the characters in a string. ">u_strFoldCase()</a>, <a class="el" href="ustring_8h.html#af5e41e4910e6934a47c91dcfb5d4b9c1" title="Compare two strings case-insensitively using full case folding. ">u_strCaseCompare()</a>, etc. Use 0 or U_FOLD_CASE_DEFAULT for default behavior. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Pointer to a UCaseMap service object, if successful.</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="stringoptions_8h.html#a7c41915be9809fd815a5c7d581ad1ea3" title="Option value for case folding: Use default mappings defined in CaseFolding.txt. ">U_FOLD_CASE_DEFAULT</a> </dd>
<dd>
<a class="el" href="stringoptions_8h.html#a2d074cf9ee160fbcaec63740c4f9689e" title="Option value for case folding: ">U_FOLD_CASE_EXCLUDE_SPECIAL_I</a> </dd>
<dd>
<a class="el" href="stringoptions_8h.html#aab9de6ad843adcbc21001f7f93f1e888" title="Do not lowercase non-initial parts of words when titlecasing. ">U_TITLECASE_NO_LOWERCASE</a> </dd>
<dd>
<a class="el" href="stringoptions_8h.html#afc65fa226cac9b8eeef0e877b8a7744e" title="Do not adjust the titlecasing BreakIterator indexes; titlecase exactly the characters at breaks from ...">U_TITLECASE_NO_BREAK_ADJUSTMENT</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000951">Stable:</a></b></dt><dd>ICU 3.4 </dd></dl>
</div>
</div>
<a id="a7c3c5c9467281b037eddaa0d11fa84bd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a7c3c5c9467281b037eddaa0d11fa84bd">◆ </a></span>ucasemap_setBreakIterator()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void ucasemap_setBreakIterator </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a> * </td>
<td class="paramname"><em>iterToAdopt</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>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the break iterator that is used for titlecasing. </p>
<p>The UCaseMap service object releases a previously set break iterator and "adopts" this new one, taking ownership of it. It will be released in a subsequent call to <a class="el" href="ucasemap_8h.html#a7c3c5c9467281b037eddaa0d11fa84bd" title="Set the break iterator that is used for titlecasing. ">ucasemap_setBreakIterator()</a> or <a class="el" href="ucasemap_8h.html#a41646ac28193dc2a147a7d315bfbd044" title="Close a UCaseMap service object. ">ucasemap_close()</a>.</p>
<p>Break iterator operations are not thread-safe. Therefore, titlecasing functions use non-const UCaseMap objects. It is not possible to titlecase strings concurrently using the same UCaseMap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
<tr><td class="paramname">iterToAdopt</td><td>Break iterator to be adopted for titlecasing. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="ucasemap_8h.html#aa49d8b403bd91c52f127fe80679bac11" title="Titlecase a UTF-16 string. ">ucasemap_toTitle</a> </dd>
<dd>
<a class="el" href="ucasemap_8h.html#a6184d1a126b3d455a519418e0ee8ef7b" title="Titlecase a UTF-8 string. ">ucasemap_utf8ToTitle</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000958">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a id="ad23904727e58dde9ed2c8e4d79c7d5f2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad23904727e58dde9ed2c8e4d79c7d5f2">◆ </a></span>ucasemap_setLocale()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void ucasemap_setLocale </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>locale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"><em>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the locale ID that is used for language-dependent case mappings. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
<tr><td class="paramname">locale</td><td>Locale ID, see <a class="el" href="ucasemap_8h.html#a9ff7023a324bf757c7520c62f13b26ef" title="Open a UCaseMap service object for a locale and a set of options. ">ucasemap_open()</a>. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="ucasemap_8h.html#a9ff7023a324bf757c7520c62f13b26ef" title="Open a UCaseMap service object for a locale and a set of options. ">ucasemap_open</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000955">Stable:</a></b></dt><dd>ICU 3.4 </dd></dl>
</div>
</div>
<a id="a1994b1c82545e12449d1bdb801f61012"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1994b1c82545e12449d1bdb801f61012">◆ </a></span>ucasemap_setOptions()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void ucasemap_setOptions </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t </td>
<td class="paramname"><em>options</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>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the options bit set that is used for case folding and string comparisons. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
<tr><td class="paramname">options</td><td>Options bit set, see <a class="el" href="ucasemap_8h.html#a9ff7023a324bf757c7520c62f13b26ef" title="Open a UCaseMap service object for a locale and a set of options. ">ucasemap_open()</a>. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="ucasemap_8h.html#a9ff7023a324bf757c7520c62f13b26ef" title="Open a UCaseMap service object for a locale and a set of options. ">ucasemap_open</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000956">Stable:</a></b></dt><dd>ICU 3.4 </dd></dl>
</div>
</div>
<a id="aa49d8b403bd91c52f127fe80679bac11"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa49d8b403bd91c52f127fe80679bac11">◆ </a></span>ucasemap_toTitle()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t ucasemap_toTitle </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</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">int32_t </td>
<td class="paramname"><em>destCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>srcLength</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>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Titlecase a UTF-16 string. </p>
<p>This function is almost a duplicate of <a class="el" href="ustring_8h.html#a47602e2c2012d77ee91908b9bbfdc063" title="Titlecase a string. ">u_strToTitle()</a>, except that it takes <a class="el" href="ucasemap_8h.html#a1994b1c82545e12449d1bdb801f61012" title="Set the options bit set that is used for case folding and string comparisons. ">ucasemap_setOptions()</a> into account and has performance advantages from being able to use a UCaseMap object for multiple case mapping operations, saving setup time.</p>
<p>Casing is locale-dependent and context-sensitive. Titlecasing uses a break iterator to find the first characters of words that are to be titlecased. It titlecases those characters and lowercases all others. (This can be modified with <a class="el" href="ucasemap_8h.html#a1994b1c82545e12449d1bdb801f61012" title="Set the options bit set that is used for case folding and string comparisons. ">ucasemap_setOptions()</a>.)</p>
<p>Note: This function takes a non-const UCaseMap pointer because it will open a default break iterator if no break iterator was set yet, and effectively call <a class="el" href="ucasemap_8h.html#a7c3c5c9467281b037eddaa0d11fa84bd" title="Set the break iterator that is used for titlecasing. ">ucasemap_setBreakIterator()</a>; also because the break iterator is stateful and will be modified during the iteration.</p>
<p>The titlecase break iterator can be provided to customize for arbitrary styles, using rules and dictionaries beyond the standard iterators. If the break iterator passed in is null, the default Unicode algorithm will be used to determine the titlecase positions.</p>
<p>This function uses only the setText(), first() and next() methods of the provided break iterator.</p>
<p>The result may be longer or shorter than the original. The source string and the destination buffer must not overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. This pointer is non-const! See the note above for details. </td></tr>
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be NUL-terminated if the buffer is large enough. The contents is undefined in case of failure. </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. </td></tr>
<tr><td class="paramname">src</td><td>The original string. </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be NUL-terminated. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The length of the result string, if successful - or in case of a buffer overflow, in which case it will be greater than destCapacity.</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="ustring_8h.html#a47602e2c2012d77ee91908b9bbfdc063" title="Titlecase a string. ">u_strToTitle</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000959">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a id="a243a148e64a479503c4044fd6e298768"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a243a148e64a479503c4044fd6e298768">◆ </a></span>ucasemap_utf8FoldCase()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t ucasemap_utf8FoldCase </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>destCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>srcLength</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>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Case-folds the characters in a UTF-8 string. </p>
<p>Case-folding is locale-independent and not context-sensitive, but there is an option for whether to include or exclude mappings for dotted I and dotless i that are marked with 'T' in CaseFolding.txt.</p>
<p>The result may be longer or shorter than the original. The source string and the destination buffer must not overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be NUL-terminated if the buffer is large enough. The contents is undefined in case of failure. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of bytes). 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. </td></tr>
<tr><td class="paramname">src</td><td>The original string. </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be NUL-terminated. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The length of the result string, if successful - or in case of a buffer overflow, in which case it will be greater than destCapacity.</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="ustring_8h.html#ae514cad63c76897567f1d7535e857852" title="Case-folds the characters in a string. ">u_strFoldCase</a> </dd>
<dd>
<a class="el" href="ucasemap_8h.html#a1994b1c82545e12449d1bdb801f61012" title="Set the options bit set that is used for case folding and string comparisons. ">ucasemap_setOptions</a> </dd>
<dd>
<a class="el" href="stringoptions_8h.html#a7c41915be9809fd815a5c7d581ad1ea3" title="Option value for case folding: Use default mappings defined in CaseFolding.txt. ">U_FOLD_CASE_DEFAULT</a> </dd>
<dd>
<a class="el" href="stringoptions_8h.html#a2d074cf9ee160fbcaec63740c4f9689e" title="Option value for case folding: ">U_FOLD_CASE_EXCLUDE_SPECIAL_I</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000963">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a id="a043b0308f87180761deda714eb48e9b3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a043b0308f87180761deda714eb48e9b3">◆ </a></span>ucasemap_utf8ToLower()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t ucasemap_utf8ToLower </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>destCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>srcLength</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>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Lowercase the characters in a UTF-8 string. </p>
<p>Casing is locale-dependent and context-sensitive. The result may be longer or shorter than the original. The source string and the destination buffer must not overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be NUL-terminated if the buffer is large enough. The contents is undefined in case of failure. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of bytes). 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. </td></tr>
<tr><td class="paramname">src</td><td>The original string. </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be NUL-terminated. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The length of the result string, if successful - or in case of a buffer overflow, in which case it will be greater than destCapacity.</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="ustring_8h.html#a1b516af424a82c73421754e63306b4b6" title="Lowercase the characters in a string. ">u_strToLower</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000960">Stable:</a></b></dt><dd>ICU 3.4 </dd></dl>
</div>
</div>
<a id="a6184d1a126b3d455a519418e0ee8ef7b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a6184d1a126b3d455a519418e0ee8ef7b">◆ </a></span>ucasemap_utf8ToTitle()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t ucasemap_utf8ToTitle </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>destCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>srcLength</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>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Titlecase a UTF-8 string. </p>
<p>Casing is locale-dependent and context-sensitive. Titlecasing uses a break iterator to find the first characters of words that are to be titlecased. It titlecases those characters and lowercases all others. (This can be modified with <a class="el" href="ucasemap_8h.html#a1994b1c82545e12449d1bdb801f61012" title="Set the options bit set that is used for case folding and string comparisons. ">ucasemap_setOptions()</a>.)</p>
<p>Note: This function takes a non-const UCaseMap pointer because it will open a default break iterator if no break iterator was set yet, and effectively call <a class="el" href="ucasemap_8h.html#a7c3c5c9467281b037eddaa0d11fa84bd" title="Set the break iterator that is used for titlecasing. ">ucasemap_setBreakIterator()</a>; also because the break iterator is stateful and will be modified during the iteration.</p>
<p>The titlecase break iterator can be provided to customize for arbitrary styles, using rules and dictionaries beyond the standard iterators. If the break iterator passed in is null, the default Unicode algorithm will be used to determine the titlecase positions.</p>
<p>This function uses only the setUText(), first(), next() and close() methods of the provided break iterator.</p>
<p>The result may be longer or shorter than the original. The source string and the destination buffer must not overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. This pointer is non-const! See the note above for details. </td></tr>
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be NUL-terminated if the buffer is large enough. The contents is undefined in case of failure. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of bytes). 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. </td></tr>
<tr><td class="paramname">src</td><td>The original string. </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be NUL-terminated. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The length of the result string, if successful - or in case of a buffer overflow, in which case it will be greater than destCapacity.</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="ustring_8h.html#a47602e2c2012d77ee91908b9bbfdc063" title="Titlecase a string. ">u_strToTitle</a> </dd>
<dd>
<a class="el" href="stringoptions_8h.html#aab9de6ad843adcbc21001f7f93f1e888" title="Do not lowercase non-initial parts of words when titlecasing. ">U_TITLECASE_NO_LOWERCASE</a> </dd>
<dd>
<a class="el" href="stringoptions_8h.html#afc65fa226cac9b8eeef0e877b8a7744e" title="Do not adjust the titlecasing BreakIterator indexes; titlecase exactly the characters at breaks from ...">U_TITLECASE_NO_BREAK_ADJUSTMENT</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000962">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a id="a2ab9b569e7a51ce1effd51fe81939ed3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2ab9b569e7a51ce1effd51fe81939ed3">◆ </a></span>ucasemap_utf8ToUpper()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t ucasemap_utf8ToUpper </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> * </td>
<td class="paramname"><em>csm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>destCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>srcLength</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>pErrorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Uppercase the characters in a UTF-8 string. </p>
<p>Casing is locale-dependent and context-sensitive. The result may be longer or shorter than the original. The source string and the destination buffer must not overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">csm</td><td>UCaseMap service object. </td></tr>
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be NUL-terminated if the buffer is large enough. The contents is undefined in case of failure. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of bytes). 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. </td></tr>
<tr><td class="paramname">src</td><td>The original string. </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be NUL-terminated. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Must be a valid pointer to an error code value, which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The length of the result string, if successful - or in case of a buffer overflow, in which case it will be greater than destCapacity.</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="ustring_8h.html#aa64fbd4ad23af84d01c931d7cfa25f89" title="Uppercase the characters in a string. ">u_strToUpper</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000961">Stable:</a></b></dt><dd>ICU 3.4 </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.14
</small></address>
</body>
</html>