<!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.6"/>
<title>ICU 53.1: ustring.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">ICU 53.1
 <span id="projectnumber">53.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.6 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="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>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark"> </span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(11)"><span class="SelectionMark"> </span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(12)"><span class="SelectionMark"> </span>Pages</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_55bf5c6bcedc2c5705af95fc7596ac50.html">icu</a></li><li class="navelem"><a class="el" href="dir_17c4e3d278dd0be6889e0e8c41145d45.html">source</a></li><li class="navelem"><a class="el" href="dir_9d30126de01c6acabed440c3eefed2e6.html">common</a></li><li class="navelem"><a class="el" href="dir_09927d28e4089b088d7b70dcc744d58d.html">unicode</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#define-members">Macros</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">ustring.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>C API: Unicode string handling functions.
<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="putil_8h_source.html">unicode/putil.h</a>"</code><br/>
<code>#include "<a class="el" href="uiter_8h_source.html">unicode/uiter.h</a>"</code><br/>
</div>
<p><a href="ustring_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="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:a08c0431a8c9c65e9578b12978681bbc8"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a08c0431a8c9c65e9578b12978681bbc8">UBRK_TYPEDEF_UBREAK_ITERATOR</a></td></tr>
<tr class="separator:a08c0431a8c9c65e9578b12978681bbc8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7fd781b068b28ee2db708090aa32df8f"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a7fd781b068b28ee2db708090aa32df8f">U_COMPARE_CODE_POINT_ORDER</a>   0x8000</td></tr>
<tr class="memdesc:a7fd781b068b28ee2db708090aa32df8f"><td class="mdescLeft"> </td><td class="mdescRight">Option bit for u_strCaseCompare, u_strcasecmp, unorm_compare, etc: Compare strings in code point order instead of code unit order. <a href="#a7fd781b068b28ee2db708090aa32df8f">More...</a><br/></td></tr>
<tr class="separator:a7fd781b068b28ee2db708090aa32df8f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:adf24e553d2f30e3bde48ff98d9b0e6bc"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#adf24e553d2f30e3bde48ff98d9b0e6bc">U_STRING_DECL</a>(var, cs, length)   static const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> var[(length)+1]=L ## cs</td></tr>
<tr class="memdesc:adf24e553d2f30e3bde48ff98d9b0e6bc"><td class="mdescLeft"> </td><td class="mdescRight">Unicode String literals in C. <a href="#adf24e553d2f30e3bde48ff98d9b0e6bc">More...</a><br/></td></tr>
<tr class="separator:adf24e553d2f30e3bde48ff98d9b0e6bc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af0dccce2caf6c8c657b65112f393a75b"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#af0dccce2caf6c8c657b65112f393a75b">U_STRING_INIT</a>(var, cs, length)</td></tr>
<tr class="separator:af0dccce2caf6c8c657b65112f393a75b"><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:adb85bb46d5f93c87098e11deab50bef4"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a></td></tr>
<tr class="memdesc:adb85bb46d5f93c87098e11deab50bef4"><td class="mdescLeft"> </td><td class="mdescRight">Simple declaration for <a class="el" href="ustring_8h.html#a8c6202ad4ac954e225aae061b184e450" title="Titlecase a string. ">u_strToTitle()</a> to avoid including <a class="el" href="ubrk_8h.html" title="C API: BreakIterator. ">unicode/ubrk.h</a>. <a href="#adb85bb46d5f93c87098e11deab50bef4">More...</a><br/></td></tr>
<tr class="separator:adb85bb46d5f93c87098e11deab50bef4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2425cebd8a8a7138eeaf3edd0cd948d8"><td class="memItemLeft" align="right" valign="top">typedef <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>(* </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a2425cebd8a8a7138eeaf3edd0cd948d8">UNESCAPE_CHAR_AT</a> )(int32_t offset, void *context)</td></tr>
<tr class="memdesc:a2425cebd8a8a7138eeaf3edd0cd948d8"><td class="mdescLeft"> </td><td class="mdescRight">Callback function for <a class="el" href="ustring_8h.html#ab688f2c7edad54064c3d8c72735461f6" title="Unescape a single sequence. ">u_unescapeAt()</a> that returns a character of the source text given an offset and a context pointer. <a href="#a2425cebd8a8a7138eeaf3edd0cd948d8">More...</a><br/></td></tr>
<tr class="separator:a2425cebd8a8a7138eeaf3edd0cd948d8"><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:gac4d8a5581fc5bde71d62ebd0a7a84ec5"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__ustring__ustrlen.html#gac4d8a5581fc5bde71d62ebd0a7a84ec5">u_strlen</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s)</td></tr>
<tr class="memdesc:gac4d8a5581fc5bde71d62ebd0a7a84ec5"><td class="mdescLeft"> </td><td class="mdescRight">Determine the length of an array of UChar. <a href="group__ustring__ustrlen.html#gac4d8a5581fc5bde71d62ebd0a7a84ec5">More...</a><br/></td></tr>
<tr class="separator:gac4d8a5581fc5bde71d62ebd0a7a84ec5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aec4a609dd5039d940e8e9524d743c88b"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aec4a609dd5039d940e8e9524d743c88b">u_countChar32</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, int32_t length)</td></tr>
<tr class="memdesc:aec4a609dd5039d940e8e9524d743c88b"><td class="mdescLeft"> </td><td class="mdescRight">Count Unicode code points in the length UChar code units of the string. <a href="#aec4a609dd5039d940e8e9524d743c88b">More...</a><br/></td></tr>
<tr class="separator:aec4a609dd5039d940e8e9524d743c88b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aabfeafb91e43b3a2c8bdd46c0743d4b2"><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="ustring_8h.html#aabfeafb91e43b3a2c8bdd46c0743d4b2">u_strHasMoreChar32Than</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, int32_t length, int32_t number)</td></tr>
<tr class="memdesc:aabfeafb91e43b3a2c8bdd46c0743d4b2"><td class="mdescLeft"> </td><td class="mdescRight">Check if the string contains more Unicode code points than a certain number. <a href="#aabfeafb91e43b3a2c8bdd46c0743d4b2">More...</a><br/></td></tr>
<tr class="separator:aabfeafb91e43b3a2c8bdd46c0743d4b2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a36b9bb0598b2c314c9e5fc1aaa59cbd8"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a36b9bb0598b2c314c9e5fc1aaa59cbd8">u_strcat</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dst, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src)</td></tr>
<tr class="memdesc:a36b9bb0598b2c314c9e5fc1aaa59cbd8"><td class="mdescLeft"> </td><td class="mdescRight">Concatenate two ustrings. <a href="#a36b9bb0598b2c314c9e5fc1aaa59cbd8">More...</a><br/></td></tr>
<tr class="separator:a36b9bb0598b2c314c9e5fc1aaa59cbd8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7ef9c4fbf2506fd23fae363b0b92fd11"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a7ef9c4fbf2506fd23fae363b0b92fd11">u_strncat</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dst, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t n)</td></tr>
<tr class="memdesc:a7ef9c4fbf2506fd23fae363b0b92fd11"><td class="mdescLeft"> </td><td class="mdescRight">Concatenate two ustrings. <a href="#a7ef9c4fbf2506fd23fae363b0b92fd11">More...</a><br/></td></tr>
<tr class="separator:a7ef9c4fbf2506fd23fae363b0b92fd11"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a074dcf5f1a5b5c4088561ac5ac87883a"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a074dcf5f1a5b5c4088561ac5ac87883a">u_strstr</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *substring)</td></tr>
<tr class="memdesc:a074dcf5f1a5b5c4088561ac5ac87883a"><td class="mdescLeft"> </td><td class="mdescRight">Find the first occurrence of a substring in a string. <a href="#a074dcf5f1a5b5c4088561ac5ac87883a">More...</a><br/></td></tr>
<tr class="separator:a074dcf5f1a5b5c4088561ac5ac87883a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a47bdb20c28603ab39e66c9e518b5b3b6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a47bdb20c28603ab39e66c9e518b5b3b6">u_strFindFirst</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, int32_t length, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *substring, int32_t subLength)</td></tr>
<tr class="memdesc:a47bdb20c28603ab39e66c9e518b5b3b6"><td class="mdescLeft"> </td><td class="mdescRight">Find the first occurrence of a substring in a string. <a href="#a47bdb20c28603ab39e66c9e518b5b3b6">More...</a><br/></td></tr>
<tr class="separator:a47bdb20c28603ab39e66c9e518b5b3b6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a39bb46b446b73a54204ba3016edb6737"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a39bb46b446b73a54204ba3016edb6737">u_strchr</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> c)</td></tr>
<tr class="memdesc:a39bb46b446b73a54204ba3016edb6737"><td class="mdescLeft"> </td><td class="mdescRight">Find the first occurrence of a BMP code point in a string. <a href="#a39bb46b446b73a54204ba3016edb6737">More...</a><br/></td></tr>
<tr class="separator:a39bb46b446b73a54204ba3016edb6737"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a789d1e49355c54ae92ad5bd579c1019b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a789d1e49355c54ae92ad5bd579c1019b">u_strchr32</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> c)</td></tr>
<tr class="memdesc:a789d1e49355c54ae92ad5bd579c1019b"><td class="mdescLeft"> </td><td class="mdescRight">Find the first occurrence of a code point in a string. <a href="#a789d1e49355c54ae92ad5bd579c1019b">More...</a><br/></td></tr>
<tr class="separator:a789d1e49355c54ae92ad5bd579c1019b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a55b181aa1237366b05f3b1cc158dda95"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a55b181aa1237366b05f3b1cc158dda95">u_strrstr</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *substring)</td></tr>
<tr class="memdesc:a55b181aa1237366b05f3b1cc158dda95"><td class="mdescLeft"> </td><td class="mdescRight">Find the last occurrence of a substring in a string. <a href="#a55b181aa1237366b05f3b1cc158dda95">More...</a><br/></td></tr>
<tr class="separator:a55b181aa1237366b05f3b1cc158dda95"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0304151e1130c43372d51f97d0fb2b0f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f">u_strFindLast</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, int32_t length, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *substring, int32_t subLength)</td></tr>
<tr class="memdesc:a0304151e1130c43372d51f97d0fb2b0f"><td class="mdescLeft"> </td><td class="mdescRight">Find the last occurrence of a substring in a string. <a href="#a0304151e1130c43372d51f97d0fb2b0f">More...</a><br/></td></tr>
<tr class="separator:a0304151e1130c43372d51f97d0fb2b0f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a16488aa76883493fdecf3b15b0576d59"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a16488aa76883493fdecf3b15b0576d59">u_strrchr</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> c)</td></tr>
<tr class="memdesc:a16488aa76883493fdecf3b15b0576d59"><td class="mdescLeft"> </td><td class="mdescRight">Find the last occurrence of a BMP code point in a string. <a href="#a16488aa76883493fdecf3b15b0576d59">More...</a><br/></td></tr>
<tr class="separator:a16488aa76883493fdecf3b15b0576d59"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2fca97af95e51306fedaf103b10fa993"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a2fca97af95e51306fedaf103b10fa993">u_strrchr32</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> c)</td></tr>
<tr class="memdesc:a2fca97af95e51306fedaf103b10fa993"><td class="mdescLeft"> </td><td class="mdescRight">Find the last occurrence of a code point in a string. <a href="#a2fca97af95e51306fedaf103b10fa993">More...</a><br/></td></tr>
<tr class="separator:a2fca97af95e51306fedaf103b10fa993"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa5c78a0cf3c46e90c96c8e5ff5abef29"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aa5c78a0cf3c46e90c96c8e5ff5abef29">u_strpbrk</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *string, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *matchSet)</td></tr>
<tr class="memdesc:aa5c78a0cf3c46e90c96c8e5ff5abef29"><td class="mdescLeft"> </td><td class="mdescRight">Locates the first occurrence in the string <code>string</code> of any of the characters in the string <code>matchSet</code>. <a href="#aa5c78a0cf3c46e90c96c8e5ff5abef29">More...</a><br/></td></tr>
<tr class="separator:aa5c78a0cf3c46e90c96c8e5ff5abef29"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a46705ee9aa862bb21100514f96417b17"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a46705ee9aa862bb21100514f96417b17">u_strcspn</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *string, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *matchSet)</td></tr>
<tr class="memdesc:a46705ee9aa862bb21100514f96417b17"><td class="mdescLeft"> </td><td class="mdescRight">Returns the number of consecutive characters in <code>string</code>, beginning with the first, that do not occur somewhere in <code>matchSet</code>. <a href="#a46705ee9aa862bb21100514f96417b17">More...</a><br/></td></tr>
<tr class="separator:a46705ee9aa862bb21100514f96417b17"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:abbbb5b3b858f9e9113beaf315aa7085a"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#abbbb5b3b858f9e9113beaf315aa7085a">u_strspn</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *string, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *matchSet)</td></tr>
<tr class="memdesc:abbbb5b3b858f9e9113beaf315aa7085a"><td class="mdescLeft"> </td><td class="mdescRight">Returns the number of consecutive characters in <code>string</code>, beginning with the first, that occur somewhere in <code>matchSet</code>. <a href="#abbbb5b3b858f9e9113beaf315aa7085a">More...</a><br/></td></tr>
<tr class="separator:abbbb5b3b858f9e9113beaf315aa7085a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:accb09fb94f8b6c7b83162c3a24b698de"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#accb09fb94f8b6c7b83162c3a24b698de">u_strtok_r</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *delim, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> **saveState)</td></tr>
<tr class="memdesc:accb09fb94f8b6c7b83162c3a24b698de"><td class="mdescLeft"> </td><td class="mdescRight">The string tokenizer API allows an application to break a string into tokens. <a href="#accb09fb94f8b6c7b83162c3a24b698de">More...</a><br/></td></tr>
<tr class="separator:accb09fb94f8b6c7b83162c3a24b698de"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:abdb8af67ab5198b9db020afa9c3114b3"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#abdb8af67ab5198b9db020afa9c3114b3">u_strcmp</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2)</td></tr>
<tr class="memdesc:abdb8af67ab5198b9db020afa9c3114b3"><td class="mdescLeft"> </td><td class="mdescRight">Compare two Unicode strings for bitwise equality (code unit order). <a href="#abdb8af67ab5198b9db020afa9c3114b3">More...</a><br/></td></tr>
<tr class="separator:abdb8af67ab5198b9db020afa9c3114b3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa89255f4b7d6fa58e219da1abe22c733"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aa89255f4b7d6fa58e219da1abe22c733">u_strcmpCodePointOrder</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2)</td></tr>
<tr class="memdesc:aa89255f4b7d6fa58e219da1abe22c733"><td class="mdescLeft"> </td><td class="mdescRight">Compare two Unicode strings in code point order. <a href="#aa89255f4b7d6fa58e219da1abe22c733">More...</a><br/></td></tr>
<tr class="separator:aa89255f4b7d6fa58e219da1abe22c733"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a51fe041d3e4e408595d665c0f5f68715"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a51fe041d3e4e408595d665c0f5f68715">u_strCompare</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, int32_t length1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2, int32_t length2, <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> codePointOrder)</td></tr>
<tr class="memdesc:a51fe041d3e4e408595d665c0f5f68715"><td class="mdescLeft"> </td><td class="mdescRight">Compare two Unicode strings (binary order). <a href="#a51fe041d3e4e408595d665c0f5f68715">More...</a><br/></td></tr>
<tr class="separator:a51fe041d3e4e408595d665c0f5f68715"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aecf733c47b2a1b353947b2264f724897"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aecf733c47b2a1b353947b2264f724897">u_strCompareIter</a> (<a class="el" href="structUCharIterator.html">UCharIterator</a> *iter1, <a class="el" href="structUCharIterator.html">UCharIterator</a> *iter2, <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> codePointOrder)</td></tr>
<tr class="memdesc:aecf733c47b2a1b353947b2264f724897"><td class="mdescLeft"> </td><td class="mdescRight">Compare two Unicode strings (binary order) as presented by <a class="el" href="structUCharIterator.html" title="C API for code unit iteration. ">UCharIterator</a> objects. <a href="#aecf733c47b2a1b353947b2264f724897">More...</a><br/></td></tr>
<tr class="separator:aecf733c47b2a1b353947b2264f724897"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a56c7ed13d57379ff8b5f0736b0628e09"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a56c7ed13d57379ff8b5f0736b0628e09">u_strCaseCompare</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, int32_t length1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2, int32_t length2, uint32_t options, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a56c7ed13d57379ff8b5f0736b0628e09"><td class="mdescLeft"> </td><td class="mdescRight">Compare two strings case-insensitively using full case folding. <a href="#a56c7ed13d57379ff8b5f0736b0628e09">More...</a><br/></td></tr>
<tr class="separator:a56c7ed13d57379ff8b5f0736b0628e09"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6c672ffda88b342f9cc1f53a7c8d28c3"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a6c672ffda88b342f9cc1f53a7c8d28c3">u_strncmp</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *ucs1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *ucs2, int32_t n)</td></tr>
<tr class="memdesc:a6c672ffda88b342f9cc1f53a7c8d28c3"><td class="mdescLeft"> </td><td class="mdescRight">Compare two ustrings for bitwise equality. <a href="#a6c672ffda88b342f9cc1f53a7c8d28c3">More...</a><br/></td></tr>
<tr class="separator:a6c672ffda88b342f9cc1f53a7c8d28c3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad7191a125406dd8e7770dbbfb38951ee"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ad7191a125406dd8e7770dbbfb38951ee">u_strncmpCodePointOrder</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2, int32_t n)</td></tr>
<tr class="memdesc:ad7191a125406dd8e7770dbbfb38951ee"><td class="mdescLeft"> </td><td class="mdescRight">Compare two Unicode strings in code point order. <a href="#ad7191a125406dd8e7770dbbfb38951ee">More...</a><br/></td></tr>
<tr class="separator:ad7191a125406dd8e7770dbbfb38951ee"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa610819a5a35df058577f78c68ad0ab0"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aa610819a5a35df058577f78c68ad0ab0">u_strcasecmp</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2, uint32_t options)</td></tr>
<tr class="memdesc:aa610819a5a35df058577f78c68ad0ab0"><td class="mdescLeft"> </td><td class="mdescRight">Compare two strings case-insensitively using full case folding. <a href="#aa610819a5a35df058577f78c68ad0ab0">More...</a><br/></td></tr>
<tr class="separator:aa610819a5a35df058577f78c68ad0ab0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ab9cf5ce80a494a8c1501fb76ab93d4c0"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ab9cf5ce80a494a8c1501fb76ab93d4c0">u_strncasecmp</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2, int32_t n, uint32_t options)</td></tr>
<tr class="memdesc:ab9cf5ce80a494a8c1501fb76ab93d4c0"><td class="mdescLeft"> </td><td class="mdescRight">Compare two strings case-insensitively using full case folding. <a href="#ab9cf5ce80a494a8c1501fb76ab93d4c0">More...</a><br/></td></tr>
<tr class="separator:ab9cf5ce80a494a8c1501fb76ab93d4c0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0bedcdf1bf8a8fe806ce224444a984ae"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a0bedcdf1bf8a8fe806ce224444a984ae">u_memcasecmp</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2, int32_t length, uint32_t options)</td></tr>
<tr class="memdesc:a0bedcdf1bf8a8fe806ce224444a984ae"><td class="mdescLeft"> </td><td class="mdescRight">Compare two strings case-insensitively using full case folding. <a href="#a0bedcdf1bf8a8fe806ce224444a984ae">More...</a><br/></td></tr>
<tr class="separator:a0bedcdf1bf8a8fe806ce224444a984ae"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a46360874cb6a798ad8a0a5e19d72a82a"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a46360874cb6a798ad8a0a5e19d72a82a">u_strcpy</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dst, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src)</td></tr>
<tr class="memdesc:a46360874cb6a798ad8a0a5e19d72a82a"><td class="mdescLeft"> </td><td class="mdescRight">Copy a ustring. <a href="#a46360874cb6a798ad8a0a5e19d72a82a">More...</a><br/></td></tr>
<tr class="separator:a46360874cb6a798ad8a0a5e19d72a82a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0886e9d12ac63f891f2336ea8c16c042"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a0886e9d12ac63f891f2336ea8c16c042">u_strncpy</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dst, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t n)</td></tr>
<tr class="memdesc:a0886e9d12ac63f891f2336ea8c16c042"><td class="mdescLeft"> </td><td class="mdescRight">Copy a ustring. <a href="#a0886e9d12ac63f891f2336ea8c16c042">More...</a><br/></td></tr>
<tr class="separator:a0886e9d12ac63f891f2336ea8c16c042"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0f2d5d46acef8e0eac711bef15e7531f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a0f2d5d46acef8e0eac711bef15e7531f">u_uastrcpy</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dst, const char *src)</td></tr>
<tr class="memdesc:a0f2d5d46acef8e0eac711bef15e7531f"><td class="mdescLeft"> </td><td class="mdescRight">Copy a byte string encoded in the default codepage to a ustring. <a href="#a0f2d5d46acef8e0eac711bef15e7531f">More...</a><br/></td></tr>
<tr class="separator:a0f2d5d46acef8e0eac711bef15e7531f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7ac7463dd6e3e36128aad288eacace8f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a7ac7463dd6e3e36128aad288eacace8f">u_uastrncpy</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dst, const char *src, int32_t n)</td></tr>
<tr class="memdesc:a7ac7463dd6e3e36128aad288eacace8f"><td class="mdescLeft"> </td><td class="mdescRight">Copy a byte string encoded in the default codepage to a ustring. <a href="#a7ac7463dd6e3e36128aad288eacace8f">More...</a><br/></td></tr>
<tr class="separator:a7ac7463dd6e3e36128aad288eacace8f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ac80eca8339bf48f3cb650d31d4a9ef80"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ac80eca8339bf48f3cb650d31d4a9ef80">u_austrcpy</a> (char *dst, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src)</td></tr>
<tr class="memdesc:ac80eca8339bf48f3cb650d31d4a9ef80"><td class="mdescLeft"> </td><td class="mdescRight">Copy ustring to a byte string encoded in the default codepage. <a href="#ac80eca8339bf48f3cb650d31d4a9ef80">More...</a><br/></td></tr>
<tr class="separator:ac80eca8339bf48f3cb650d31d4a9ef80"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:afe9d06488aa9de15f273f96f60635a6a"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#afe9d06488aa9de15f273f96f60635a6a">u_austrncpy</a> (char *dst, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t n)</td></tr>
<tr class="memdesc:afe9d06488aa9de15f273f96f60635a6a"><td class="mdescLeft"> </td><td class="mdescRight">Copy ustring to a byte string encoded in the default codepage. <a href="#afe9d06488aa9de15f273f96f60635a6a">More...</a><br/></td></tr>
<tr class="separator:afe9d06488aa9de15f273f96f60635a6a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a8a3bf2aff3864c0b910b15ea6e0be69e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a8a3bf2aff3864c0b910b15ea6e0be69e">u_memcpy</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t count)</td></tr>
<tr class="memdesc:a8a3bf2aff3864c0b910b15ea6e0be69e"><td class="mdescLeft"> </td><td class="mdescRight">Synonym for memcpy(), but with UChars only. <a href="#a8a3bf2aff3864c0b910b15ea6e0be69e">More...</a><br/></td></tr>
<tr class="separator:a8a3bf2aff3864c0b910b15ea6e0be69e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a98f0ccf16176d7a507102b21f2083311"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a98f0ccf16176d7a507102b21f2083311">u_memmove</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t count)</td></tr>
<tr class="memdesc:a98f0ccf16176d7a507102b21f2083311"><td class="mdescLeft"> </td><td class="mdescRight">Synonym for memmove(), but with UChars only. <a href="#a98f0ccf16176d7a507102b21f2083311">More...</a><br/></td></tr>
<tr class="separator:a98f0ccf16176d7a507102b21f2083311"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa3c77f7315557f775c4a8aeeda627382"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aa3c77f7315557f775c4a8aeeda627382">u_memset</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> c, int32_t count)</td></tr>
<tr class="memdesc:aa3c77f7315557f775c4a8aeeda627382"><td class="mdescLeft"> </td><td class="mdescRight">Initialize <code>count</code> characters of <code>dest</code> to <code>c</code>. <a href="#aa3c77f7315557f775c4a8aeeda627382">More...</a><br/></td></tr>
<tr class="separator:aa3c77f7315557f775c4a8aeeda627382"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a95643325eec27e247d28531f3c68600b"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a95643325eec27e247d28531f3c68600b">u_memcmp</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *buf1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *buf2, int32_t count)</td></tr>
<tr class="memdesc:a95643325eec27e247d28531f3c68600b"><td class="mdescLeft"> </td><td class="mdescRight">Compare the first <code>count</code> UChars of each buffer. <a href="#a95643325eec27e247d28531f3c68600b">More...</a><br/></td></tr>
<tr class="separator:a95643325eec27e247d28531f3c68600b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6c4db093aa0c52bb47711953cc709b1b"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a6c4db093aa0c52bb47711953cc709b1b">u_memcmpCodePointOrder</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s1, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s2, int32_t count)</td></tr>
<tr class="memdesc:a6c4db093aa0c52bb47711953cc709b1b"><td class="mdescLeft"> </td><td class="mdescRight">Compare two Unicode strings in code point order. <a href="#a6c4db093aa0c52bb47711953cc709b1b">More...</a><br/></td></tr>
<tr class="separator:a6c4db093aa0c52bb47711953cc709b1b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ac30e88d264feb6ffd977b6a661d29f24"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ac30e88d264feb6ffd977b6a661d29f24">u_memchr</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> c, int32_t count)</td></tr>
<tr class="memdesc:ac30e88d264feb6ffd977b6a661d29f24"><td class="mdescLeft"> </td><td class="mdescRight">Find the first occurrence of a BMP code point in a string. <a href="#ac30e88d264feb6ffd977b6a661d29f24">More...</a><br/></td></tr>
<tr class="separator:ac30e88d264feb6ffd977b6a661d29f24"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a14f1a66d758f90167c1bf91aee634b71"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a14f1a66d758f90167c1bf91aee634b71">u_memchr32</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> c, int32_t count)</td></tr>
<tr class="memdesc:a14f1a66d758f90167c1bf91aee634b71"><td class="mdescLeft"> </td><td class="mdescRight">Find the first occurrence of a code point in a string. <a href="#a14f1a66d758f90167c1bf91aee634b71">More...</a><br/></td></tr>
<tr class="separator:a14f1a66d758f90167c1bf91aee634b71"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af5002dc5e89378549c68313968790ed7"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#af5002dc5e89378549c68313968790ed7">u_memrchr</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> c, int32_t count)</td></tr>
<tr class="memdesc:af5002dc5e89378549c68313968790ed7"><td class="mdescLeft"> </td><td class="mdescRight">Find the last occurrence of a BMP code point in a string. <a href="#af5002dc5e89378549c68313968790ed7">More...</a><br/></td></tr>
<tr class="separator:af5002dc5e89378549c68313968790ed7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa012a35978c2e4a5aa4073d6c3edf7e5"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aa012a35978c2e4a5aa4073d6c3edf7e5">u_memrchr32</a> (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *s, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> c, int32_t count)</td></tr>
<tr class="memdesc:aa012a35978c2e4a5aa4073d6c3edf7e5"><td class="mdescLeft"> </td><td class="mdescRight">Find the last occurrence of a code point in a string. <a href="#aa012a35978c2e4a5aa4073d6c3edf7e5">More...</a><br/></td></tr>
<tr class="separator:aa012a35978c2e4a5aa4073d6c3edf7e5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7aad56a2a6f7cbe3b2fb802a218d239b"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a7aad56a2a6f7cbe3b2fb802a218d239b">u_unescape</a> (const char *src, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity)</td></tr>
<tr class="memdesc:a7aad56a2a6f7cbe3b2fb802a218d239b"><td class="mdescLeft"> </td><td class="mdescRight">Unescape a string of characters and write the resulting Unicode characters to the destination buffer. <a href="#a7aad56a2a6f7cbe3b2fb802a218d239b">More...</a><br/></td></tr>
<tr class="separator:a7aad56a2a6f7cbe3b2fb802a218d239b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ab688f2c7edad54064c3d8c72735461f6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ab688f2c7edad54064c3d8c72735461f6">u_unescapeAt</a> (<a class="el" href="ustring_8h.html#a2425cebd8a8a7138eeaf3edd0cd948d8">UNESCAPE_CHAR_AT</a> charAt, int32_t *offset, int32_t length, void *context)</td></tr>
<tr class="memdesc:ab688f2c7edad54064c3d8c72735461f6"><td class="mdescLeft"> </td><td class="mdescRight">Unescape a single sequence. <a href="#ab688f2c7edad54064c3d8c72735461f6">More...</a><br/></td></tr>
<tr class="separator:ab688f2c7edad54064c3d8c72735461f6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a14740e3b734ffa82205d4762fcacb5e1"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a14740e3b734ffa82205d4762fcacb5e1">u_strToUpper</a> (<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, const char *locale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a14740e3b734ffa82205d4762fcacb5e1"><td class="mdescLeft"> </td><td class="mdescRight">Uppercase the characters in a string. <a href="#a14740e3b734ffa82205d4762fcacb5e1">More...</a><br/></td></tr>
<tr class="separator:a14740e3b734ffa82205d4762fcacb5e1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ae3ed589f5ce0d550c228ee69bfed58fb"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ae3ed589f5ce0d550c228ee69bfed58fb">u_strToLower</a> (<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, const char *locale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:ae3ed589f5ce0d550c228ee69bfed58fb"><td class="mdescLeft"> </td><td class="mdescRight">Lowercase the characters in a string. <a href="#ae3ed589f5ce0d550c228ee69bfed58fb">More...</a><br/></td></tr>
<tr class="separator:ae3ed589f5ce0d550c228ee69bfed58fb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a8c6202ad4ac954e225aae061b184e450"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a8c6202ad4ac954e225aae061b184e450">u_strToTitle</a> (<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="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a> *titleIter, const char *locale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a8c6202ad4ac954e225aae061b184e450"><td class="mdescLeft"> </td><td class="mdescRight">Titlecase a string. <a href="#a8c6202ad4ac954e225aae061b184e450">More...</a><br/></td></tr>
<tr class="separator:a8c6202ad4ac954e225aae061b184e450"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ab6709b5a5c1606cf0d3ea24934d9acce"><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ab6709b5a5c1606cf0d3ea24934d9acce">u_strFoldCase</a> (<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, uint32_t options, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:ab6709b5a5c1606cf0d3ea24934d9acce"><td class="mdescLeft"> </td><td class="mdescRight">Case-folds the characters in a string. <a href="#ab6709b5a5c1606cf0d3ea24934d9acce">More...</a><br/></td></tr>
<tr class="separator:ab6709b5a5c1606cf0d3ea24934d9acce"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a184562a078b0a961d9281b0c29bb5406"><td class="memItemLeft" align="right" valign="top">wchar_t * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a184562a078b0a961d9281b0c29bb5406">u_strToWCS</a> (wchar_t *dest, int32_t destCapacity, int32_t *pDestLength, 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:a184562a078b0a961d9281b0c29bb5406"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-16 string to a wchar_t string. <a href="#a184562a078b0a961d9281b0c29bb5406">More...</a><br/></td></tr>
<tr class="separator:a184562a078b0a961d9281b0c29bb5406"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad7f574ab350d889fce6e44514807728d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ad7f574ab350d889fce6e44514807728d">u_strFromWCS</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, int32_t *pDestLength, const wchar_t *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:ad7f574ab350d889fce6e44514807728d"><td class="mdescLeft"> </td><td class="mdescRight">Convert a wchar_t string to UTF-16. <a href="#ad7f574ab350d889fce6e44514807728d">More...</a><br/></td></tr>
<tr class="separator:ad7f574ab350d889fce6e44514807728d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0ca7af2cf47b116454eed92331594afa"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a0ca7af2cf47b116454eed92331594afa">u_strToUTF8</a> (char *dest, int32_t destCapacity, int32_t *pDestLength, 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:a0ca7af2cf47b116454eed92331594afa"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-16 string to UTF-8. <a href="#a0ca7af2cf47b116454eed92331594afa">More...</a><br/></td></tr>
<tr class="separator:a0ca7af2cf47b116454eed92331594afa"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a5f9ff224b11166a106d1b3ac26454cd4"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a5f9ff224b11166a106d1b3ac26454cd4">u_strFromUTF8</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, int32_t *pDestLength, const char *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a5f9ff224b11166a106d1b3ac26454cd4"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-8 string to UTF-16. <a href="#a5f9ff224b11166a106d1b3ac26454cd4">More...</a><br/></td></tr>
<tr class="separator:a5f9ff224b11166a106d1b3ac26454cd4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7a79e37a3b1a261a9326029d2a1b1b80"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a7a79e37a3b1a261a9326029d2a1b1b80">u_strToUTF8WithSub</a> (char *dest, int32_t destCapacity, int32_t *pDestLength, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t srcLength, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> subchar, int32_t *pNumSubstitutions, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a7a79e37a3b1a261a9326029d2a1b1b80"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-16 string to UTF-8. <a href="#a7a79e37a3b1a261a9326029d2a1b1b80">More...</a><br/></td></tr>
<tr class="separator:a7a79e37a3b1a261a9326029d2a1b1b80"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0e9b7cd493c351804322ad1805fbe775"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a0e9b7cd493c351804322ad1805fbe775">u_strFromUTF8WithSub</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, int32_t *pDestLength, const char *src, int32_t srcLength, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> subchar, int32_t *pNumSubstitutions, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a0e9b7cd493c351804322ad1805fbe775"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-8 string to UTF-16. <a href="#a0e9b7cd493c351804322ad1805fbe775">More...</a><br/></td></tr>
<tr class="separator:a0e9b7cd493c351804322ad1805fbe775"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ae5d278594ac005f683bf35e8e4373130"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ae5d278594ac005f683bf35e8e4373130">u_strFromUTF8Lenient</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, int32_t *pDestLength, const char *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:ae5d278594ac005f683bf35e8e4373130"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-8 string to UTF-16. <a href="#ae5d278594ac005f683bf35e8e4373130">More...</a><br/></td></tr>
<tr class="separator:ae5d278594ac005f683bf35e8e4373130"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a471e6e4857f06b262ceac485b7ffcae4"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a471e6e4857f06b262ceac485b7ffcae4">u_strToUTF32</a> (<a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> *dest, int32_t destCapacity, int32_t *pDestLength, 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:a471e6e4857f06b262ceac485b7ffcae4"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-16 string to UTF-32. <a href="#a471e6e4857f06b262ceac485b7ffcae4">More...</a><br/></td></tr>
<tr class="separator:a471e6e4857f06b262ceac485b7ffcae4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0b6154c1f288ec9a4d25fb0678cd90a0"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#a0b6154c1f288ec9a4d25fb0678cd90a0">u_strFromUTF32</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, int32_t *pDestLength, const <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:a0b6154c1f288ec9a4d25fb0678cd90a0"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-32 string to UTF-16. <a href="#a0b6154c1f288ec9a4d25fb0678cd90a0">More...</a><br/></td></tr>
<tr class="separator:a0b6154c1f288ec9a4d25fb0678cd90a0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aadb94acab6ec4c8f8b93f88d2da376a3"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aadb94acab6ec4c8f8b93f88d2da376a3">u_strToUTF32WithSub</a> (<a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> *dest, int32_t destCapacity, int32_t *pDestLength, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t srcLength, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> subchar, int32_t *pNumSubstitutions, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:aadb94acab6ec4c8f8b93f88d2da376a3"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-16 string to UTF-32. <a href="#aadb94acab6ec4c8f8b93f88d2da376a3">More...</a><br/></td></tr>
<tr class="separator:aadb94acab6ec4c8f8b93f88d2da376a3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ae6a665906f6ec6902fa755bfc43e1000"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ae6a665906f6ec6902fa755bfc43e1000">u_strFromUTF32WithSub</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, int32_t *pDestLength, const <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> *src, int32_t srcLength, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> subchar, int32_t *pNumSubstitutions, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:ae6a665906f6ec6902fa755bfc43e1000"><td class="mdescLeft"> </td><td class="mdescRight">Convert a UTF-32 string to UTF-16. <a href="#ae6a665906f6ec6902fa755bfc43e1000">More...</a><br/></td></tr>
<tr class="separator:ae6a665906f6ec6902fa755bfc43e1000"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ac3f8c6911cbb97e1797c73f4b3ae6c51"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#ac3f8c6911cbb97e1797c73f4b3ae6c51">u_strToJavaModifiedUTF8</a> (char *dest, int32_t destCapacity, int32_t *pDestLength, 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:ac3f8c6911cbb97e1797c73f4b3ae6c51"><td class="mdescLeft"> </td><td class="mdescRight">Convert a 16-bit Unicode string to Java Modified UTF-8. <a href="#ac3f8c6911cbb97e1797c73f4b3ae6c51">More...</a><br/></td></tr>
<tr class="separator:ac3f8c6911cbb97e1797c73f4b3ae6c51"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aef59ec61e141905bf7b5970ae21f5dd2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustring_8h.html#aef59ec61e141905bf7b5970ae21f5dd2">u_strFromJavaModifiedUTF8WithSub</a> (<a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, int32_t *pDestLength, const char *src, int32_t srcLength, <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> subchar, int32_t *pNumSubstitutions, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:aef59ec61e141905bf7b5970ae21f5dd2"><td class="mdescLeft"> </td><td class="mdescRight">Convert a Java Modified UTF-8 string to a 16-bit Unicode string. <a href="#aef59ec61e141905bf7b5970ae21f5dd2">More...</a><br/></td></tr>
<tr class="separator:aef59ec61e141905bf7b5970ae21f5dd2"><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 string handling functions. </p>
<p>These C API functions provide general Unicode string handling.</p>
<p>Some functions are equivalent in name, signature, and behavior to the ANSI C <string.h> functions. (For example, they do not check for bad arguments like NULL string pointers.) In some cases, only the thread-safe variant of such a function is implemented here (see <a class="el" href="ustring_8h.html#accb09fb94f8b6c7b83162c3a24b698de" title="The string tokenizer API allows an application to break a string into tokens. ">u_strtok_r()</a>).</p>
<p>Other functions provide more Unicode-specific functionality like locale-specific upper/lower-casing and string comparison in code point order.</p>
<p>ICU uses 16-bit Unicode (UTF-16) in the form of arrays of UChar code units. UTF-16 encodes each Unicode code point with either one or two UChar code units. (This is the default form of Unicode, and a forward-compatible extension of the original, fixed-width form that was known as UCS-2. UTF-16 superseded UCS-2 with Unicode 2.0 in 1996.)</p>
<p>Some APIs accept a 32-bit UChar32 value for a single code point.</p>
<p>ICU also handles 16-bit Unicode text with unpaired surrogates. Such text is not well-formed UTF-16. Code-point-related functions treat unpaired surrogates as surrogate code points, i.e., as separate units.</p>
<p>Although UTF-16 is a variable-width encoding form (like some legacy multi-byte encodings), it is much more efficient even for random access because the code unit values for single-unit characters vs. lead units vs. trail units are completely disjoint. This means that it is easy to determine character (code point) boundaries from random offsets in the string.</p>
<p>Unicode (UTF-16) string processing is optimized for the single-unit case. Although it is important to support supplementary characters (which use pairs of lead/trail code units called "surrogates"), their occurrence is rare. Almost all characters in modern use require only a single UChar code unit (i.e., their code point values are <=0xffff).</p>
<p>For more details see the User Guide Strings chapter (<a href="http://icu-project.org/userguide/strings.html">http://icu-project.org/userguide/strings.html</a>). For a discussion of the handling of unpaired surrogates see also Jitterbug 2145 and its icu mailing list proposal on 2002-sep-18. </p>
<p>Definition in file <a class="el" href="ustring_8h_source.html">ustring.h</a>.</p>
</div><h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="a7fd781b068b28ee2db708090aa32df8f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define U_COMPARE_CODE_POINT_ORDER   0x8000</td>
</tr>
</table>
</div><div class="memdoc">
<p>Option bit for u_strCaseCompare, u_strcasecmp, unorm_compare, etc: Compare strings in code point order instead of code unit order. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002574">Stable:</a></b></dt><dd>ICU 2.2 </dd></dl>
<p>Definition at line <a class="el" href="ustring_8h_source.html#l00505">505</a> of file <a class="el" href="ustring_8h_source.html">ustring.h</a>.</p>
</div>
</div>
<a class="anchor" id="adf24e553d2f30e3bde48ff98d9b0e6bc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define U_STRING_DECL</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">var, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">cs, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">length </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   static const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> var[(length)+1]=L ## cs</td>
</tr>
</table>
</div><div class="memdoc">
<p>Unicode String literals in C. </p>
<p>We need one macro to declare a variable for the string and to statically preinitialize it if possible, and a second macro to dynamically intialize such a string variable if necessary.</p>
<p>The macros are defined for maximum performance. They work only for strings that contain "invariant characters", i.e., only latin letters, digits, and some punctuation. See <a class="el" href="utypes_8h.html" title="Basic definitions for ICU, for both C and C++ APIs. ">utypes.h</a> for details.</p>
<p>A pair of macros for a single string must be used with the same parameters. The string parameter must be a C string literal. The length of the string, not including the terminating <code>NUL</code>, must be specified as a constant. The U_STRING_DECL macro should be invoked exactly once for one such string variable before it is used.</p>
<p>Usage: </p>
<pre>
U_STRING_DECL(ustringVar1, "Quick-Fox 2", 11);
U_STRING_DECL(ustringVar2, "jumps 5%", 8);
static UBool didInit=FALSE;</pre><pre> int32_t function() {
if(!didInit) {
U_STRING_INIT(ustringVar1, "Quick-Fox 2", 11);
U_STRING_INIT(ustringVar2, "jumps 5%", 8);
didInit=TRUE;
}
return u_strcmp(ustringVar1, ustringVar2);
}
</pre><p>Note that the macros will NOT consistently work if their argument is another <code>#define</code>. The following will not work on all platforms, don't use it.</p>
<pre>
#define GLUCK "Mr. Gluck"
<a class="el" href="ustring_8h.html#adf24e553d2f30e3bde48ff98d9b0e6bc" title="Unicode String literals in C. ">U_STRING_DECL(var, GLUCK, 9)</a>
<a class="el" href="ustring_8h.html#af0dccce2caf6c8c657b65112f393a75b">U_STRING_INIT(var, GLUCK, 9)</a>
</pre><p>Instead, use the string literal "Mr. Gluck" as the argument to both macro calls.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002596">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="ustring_8h_source.html#l00946">946</a> of file <a class="el" href="ustring_8h_source.html">ustring.h</a>.</p>
</div>
</div>
<a class="anchor" id="af0dccce2caf6c8c657b65112f393a75b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define U_STRING_INIT</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">var, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">cs, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">length </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002597">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="ustring_8h_source.html#l00948">948</a> of file <a class="el" href="ustring_8h_source.html">ustring.h</a>.</p>
</div>
</div>
<a class="anchor" id="a08c0431a8c9c65e9578b12978681bbc8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UBRK_TYPEDEF_UBREAK_ITERATOR</td>
</tr>
</table>
</div><div class="memdoc">
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000184">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. </dd></dl>
<p>Definition at line <a class="el" href="ustring_8h_source.html#l00029">29</a> of file <a class="el" href="ustring_8h_source.html">ustring.h</a>.</p>
</div>
</div>
<h2 class="groupheader">Typedef Documentation</h2>
<a class="anchor" id="adb85bb46d5f93c87098e11deab50bef4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a> <a class="el" href="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Simple declaration for <a class="el" href="ustring_8h.html#a8c6202ad4ac954e225aae061b184e450" title="Titlecase a string. ">u_strToTitle()</a> to avoid including <a class="el" href="ubrk_8h.html" title="C API: BreakIterator. ">unicode/ubrk.h</a>. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002552">Stable:</a></b></dt><dd>ICU 2.1 </dd></dl>
<p>Definition at line <a class="el" href="ustring_8h_source.html#l00031">31</a> of file <a class="el" href="ustring_8h_source.html">ustring.h</a>.</p>
</div>
</div>
<a class="anchor" id="a2425cebd8a8a7138eeaf3edd0cd948d8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>( * UNESCAPE_CHAR_AT)(int32_t offset, void *context)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Callback function for <a class="el" href="ustring_8h.html#ab688f2c7edad54064c3d8c72735461f6" title="Unescape a single sequence. ">u_unescapeAt()</a> that returns a character of the source text given an offset and a context pointer. </p>
<p>The context pointer will be whatever is passed into <a class="el" href="ustring_8h.html#ab688f2c7edad54064c3d8c72735461f6" title="Unescape a single sequence. ">u_unescapeAt()</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">offset</td><td>pointer to the offset that will be passed to <a class="el" href="ustring_8h.html#ab688f2c7edad54064c3d8c72735461f6" title="Unescape a single sequence. ">u_unescapeAt()</a>. </td></tr>
<tr><td class="paramname">context</td><td>an opaque pointer passed directly into <a class="el" href="ustring_8h.html#ab688f2c7edad54064c3d8c72735461f6" title="Unescape a single sequence. ">u_unescapeAt()</a> </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>the character represented by the escape sequence at offset </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#ab688f2c7edad54064c3d8c72735461f6" title="Unescape a single sequence. ">u_unescapeAt</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002599">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="ustring_8h_source.html#l01023">1023</a> of file <a class="el" href="ustring_8h_source.html">ustring.h</a>.</p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="ac80eca8339bf48f3cb650d31d4a9ef80"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* u_austrcpy </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dst</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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy ustring to a byte string encoded in the default codepage. </p>
<p>Adds a null terminator. Performs a UChar to host byte conversion</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination string. </td></tr>
<tr><td class="paramname">src</td><td>The source string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dst</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002585">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="afe9d06488aa9de15f273f96f60635a6a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* u_austrncpy </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dst</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>n</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy ustring to a byte string encoded in the default codepage. </p>
<p>Copies at most <code>n</code> characters. The result will be null terminated if the length of <code>src</code> is less than <code>n</code>. Performs a UChar to host byte conversion</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination string. </td></tr>
<tr><td class="paramname">src</td><td>The source string. </td></tr>
<tr><td class="paramname">n</td><td>The maximum number of characters to copy. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dst</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002586">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aec4a609dd5039d940e8e9524d743c88b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_countChar32 </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Count Unicode code points in the length UChar code units of the string. </p>
<p>A code point may occupy either one or two UChar code units. Counting code points involves reading all code units.</p>
<p>This functions is basically the inverse of the <a class="el" href="utf16_8h.html#ad70d5a679bd03c63131219c7808d9de9" title="Advance the string offset from one code point boundary to the n-th next one, i.e., move forward by n code points. ">U16_FWD_N()</a> macro (see <a class="el" href="utf_8h.html" title="C API: Code point macros. ">utf.h</a>).</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The input string. </td></tr>
<tr><td class="paramname">length</td><td>The number of UChar code units to be checked, or -1 to count all code points before the first NUL (U+0000). </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The number of code points in the specified code units. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002554">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a0bedcdf1bf8a8fe806ce224444a984ae"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_memcasecmp </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</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>s2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length</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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two strings case-insensitively using full case folding. </p>
<p>This is equivalent to u_strcmp(u_strFoldCase(s1, n, options), u_strFoldCase(s2, n, options)).</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>A string to compare. </td></tr>
<tr><td class="paramname">s2</td><td>A string to compare. </td></tr>
<tr><td class="paramname">length</td><td>The number of characters in each string to case-fold and then compare. </td></tr>
<tr><td class="paramname">options</td><td>A bit set of options:<ul>
<li>U_FOLD_CASE_DEFAULT or 0 is used for default options: Comparison in code unit order with default case folding.</li>
<li>U_COMPARE_CODE_POINT_ORDER Set to choose code point order instead of code unit order (see u_strCompare for details).</li>
<li>U_FOLD_CASE_EXCLUDE_SPECIAL_I</li>
</ul>
</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A negative, zero, or positive integer indicating the comparison result. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002580">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ac30e88d264feb6ffd977b6a661d29f24"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_memchr </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</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>c</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the first occurrence of a BMP code point in a string. </p>
<p>A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NUL character is found at the string terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (contains <code>count</code> UChars). </td></tr>
<tr><td class="paramname">c</td><td>The BMP code point to find. </td></tr>
<tr><td class="paramname">count</td><td>The length of the string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the first occurrence of <code>c</code> in <code>s</code> or <code>NULL</code> if <code>c</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002592">Stable:</a></b></dt><dd>ICU 2.0</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a39bb46b446b73a54204ba3016edb6737" title="Find the first occurrence of a BMP code point in a string. ">u_strchr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a14f1a66d758f90167c1bf91aee634b71" title="Find the first occurrence of a code point in a string. ">u_memchr32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a47bdb20c28603ab39e66c9e518b5b3b6" title="Find the first occurrence of a substring in a string. ">u_strFindFirst</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a14f1a66d758f90167c1bf91aee634b71"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_memchr32 </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>c</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the first occurrence of a code point in a string. </p>
<p>A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NUL character is found at the string terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (contains <code>count</code> UChars). </td></tr>
<tr><td class="paramname">c</td><td>The code point to find. </td></tr>
<tr><td class="paramname">count</td><td>The length of the string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the first occurrence of <code>c</code> in <code>s</code> or <code>NULL</code> if <code>c</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002593">Stable:</a></b></dt><dd>ICU 2.0</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a789d1e49355c54ae92ad5bd579c1019b" title="Find the first occurrence of a code point in a string. ">u_strchr32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#ac30e88d264feb6ffd977b6a661d29f24" title="Find the first occurrence of a BMP code point in a string. ">u_memchr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a47bdb20c28603ab39e66c9e518b5b3b6" title="Find the first occurrence of a substring in a string. ">u_strFindFirst</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a95643325eec27e247d28531f3c68600b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_memcmp </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>buf1</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>buf2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare the first <code>count</code> UChars of each buffer. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">buf1</td><td>The first string to compare. </td></tr>
<tr><td class="paramname">buf2</td><td>The second string to compare. </td></tr>
<tr><td class="paramname">count</td><td>The maximum number of UChars to compare. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>When buf1 < buf2, a negative number is returned. When buf1 == buf2, 0 is returned. When buf1 > buf2, a positive number is returned. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002590">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a6c4db093aa0c52bb47711953cc709b1b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_memcmpCodePointOrder </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</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>s2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two Unicode strings in code point order. </p>
<p>This is different in UTF-16 from <a class="el" href="ustring_8h.html#a95643325eec27e247d28531f3c68600b" title="Compare the first count UChars of each buffer. ">u_memcmp()</a> if supplementary characters are present. For details, see <a class="el" href="ustring_8h.html#a51fe041d3e4e408595d665c0f5f68715" title="Compare two Unicode strings (binary order). ">u_strCompare()</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>A string to compare. </td></tr>
<tr><td class="paramname">s2</td><td>A string to compare. </td></tr>
<tr><td class="paramname">count</td><td>The maximum number of characters to compare. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a negative/zero/positive integer corresponding to whether the first string is less than/equal to/greater than the second one in code point order </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002591">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a8a3bf2aff3864c0b910b15ea6e0be69e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_memcpy </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">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>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Synonym for memcpy(), but with UChars only. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>The destination string </td></tr>
<tr><td class="paramname">src</td><td>The source string (can be NULL/invalid if count<=0) </td></tr>
<tr><td class="paramname">count</td><td>The number of characters to copy; no-op if <=0 </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dest</code> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002587">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a98f0ccf16176d7a507102b21f2083311"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_memmove </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">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>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Synonym for memmove(), but with UChars only. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>The destination string </td></tr>
<tr><td class="paramname">src</td><td>The source string (can be NULL/invalid if count<=0) </td></tr>
<tr><td class="paramname">count</td><td>The number of characters to move; no-op if <=0 </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dest</code> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002588">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="af5002dc5e89378549c68313968790ed7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_memrchr </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</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>c</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the last occurrence of a BMP code point in a string. </p>
<p>A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NUL character is found at the string terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (contains <code>count</code> UChars). </td></tr>
<tr><td class="paramname">c</td><td>The BMP code point to find. </td></tr>
<tr><td class="paramname">count</td><td>The length of the string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the last occurrence of <code>c</code> in <code>s</code> or <code>NULL</code> if <code>c</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002594">Stable:</a></b></dt><dd>ICU 2.4</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a16488aa76883493fdecf3b15b0576d59" title="Find the last occurrence of a BMP code point in a string. ">u_strrchr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#aa012a35978c2e4a5aa4073d6c3edf7e5" title="Find the last occurrence of a code point in a string. ">u_memrchr32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f" title="Find the last occurrence of a substring in a string. ">u_strFindLast</a> </dd></dl>
</div>
</div>
<a class="anchor" id="aa012a35978c2e4a5aa4073d6c3edf7e5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_memrchr32 </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>c</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the last occurrence of a code point in a string. </p>
<p>A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NUL character is found at the string terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (contains <code>count</code> UChars). </td></tr>
<tr><td class="paramname">c</td><td>The code point to find. </td></tr>
<tr><td class="paramname">count</td><td>The length of the string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the last occurrence of <code>c</code> in <code>s</code> or <code>NULL</code> if <code>c</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002595">Stable:</a></b></dt><dd>ICU 2.4</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a2fca97af95e51306fedaf103b10fa993" title="Find the last occurrence of a code point in a string. ">u_strrchr32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#af5002dc5e89378549c68313968790ed7" title="Find the last occurrence of a BMP code point in a string. ">u_memrchr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f" title="Find the last occurrence of a substring in a string. ">u_strFindLast</a> </dd></dl>
</div>
</div>
<a class="anchor" id="aa3c77f7315557f775c4a8aeeda627382"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_memset </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> </td>
<td class="paramname"><em>c</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize <code>count</code> characters of <code>dest</code> to <code>c</code>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>The destination string. </td></tr>
<tr><td class="paramname">c</td><td>The character to initialize the string. </td></tr>
<tr><td class="paramname">count</td><td>The maximum number of characters to set. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dest</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002589">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aa610819a5a35df058577f78c68ad0ab0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strcasecmp </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</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>s2</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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two strings case-insensitively using full case folding. </p>
<p>This is equivalent to u_strcmp(u_strFoldCase(s1, options), u_strFoldCase(s2, options)).</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>A string to compare. </td></tr>
<tr><td class="paramname">s2</td><td>A string to compare. </td></tr>
<tr><td class="paramname">options</td><td>A bit set of options:<ul>
<li>U_FOLD_CASE_DEFAULT or 0 is used for default options: Comparison in code unit order with default case folding.</li>
<li>U_COMPARE_CODE_POINT_ORDER Set to choose code point order instead of code unit order (see u_strCompare for details).</li>
<li>U_FOLD_CASE_EXCLUDE_SPECIAL_I</li>
</ul>
</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A negative, zero, or positive integer indicating the comparison result. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002578">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a56c7ed13d57379ff8b5f0736b0628e09"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strCaseCompare </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length1</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>s2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length2</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>Compare two strings case-insensitively using full case folding. </p>
<p>This is equivalent to u_strCompare(u_strFoldCase(s1, options), u_strFoldCase(s2, options), (options&U_COMPARE_CODE_POINT_ORDER)!=0).</p>
<p>The comparison can be done in UTF-16 code unit order or in code point order. They differ only when comparing supplementary code points (U+10000..U+10ffff) to BMP code points near the end of the BMP (i.e., U+e000..U+ffff). In code unit order, high BMP code points sort after supplementary code points because they are stored as pairs of surrogates which are at U+d800..U+dfff.</p>
<p>This functions works with strings of different explicitly specified lengths unlike the ANSI C-like <a class="el" href="ustring_8h.html#abdb8af67ab5198b9db020afa9c3114b3" title="Compare two Unicode strings for bitwise equality (code unit order). ">u_strcmp()</a> and <a class="el" href="ustring_8h.html#a95643325eec27e247d28531f3c68600b" title="Compare the first count UChars of each buffer. ">u_memcmp()</a> etc. NUL-terminated strings are possible with length arguments of -1.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>First source string. </td></tr>
<tr><td class="paramname">length1</td><td>Length of first source string, or -1 if NUL-terminated.</td></tr>
<tr><td class="paramname">s2</td><td>Second source string. </td></tr>
<tr><td class="paramname">length2</td><td>Length of second source string, or -1 if NUL-terminated.</td></tr>
<tr><td class="paramname">options</td><td>A bit set of options:<ul>
<li>U_FOLD_CASE_DEFAULT or 0 is used for default options: Comparison in code unit order with default case folding.</li>
<li>U_COMPARE_CODE_POINT_ORDER Set to choose code point order instead of code unit order (see u_strCompare for details).</li>
<li>U_FOLD_CASE_EXCLUDE_SPECIAL_I</li>
</ul>
</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><0 or 0 or >0 as usual for string comparisons</dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002575">Stable:</a></b></dt><dd>ICU 2.2 </dd></dl>
</div>
</div>
<a class="anchor" id="a36b9bb0598b2c314c9e5fc1aaa59cbd8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strcat </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>dst</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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Concatenate two ustrings. </p>
<p>Appends a copy of <code>src</code>, including the null terminator, to <code>dst</code>. The initial copied character from <code>src</code> overwrites the null terminator in <code>dst</code>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination string. </td></tr>
<tr><td class="paramname">src</td><td>The source string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dst</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002556">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a39bb46b446b73a54204ba3016edb6737"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strchr </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</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>c</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the first occurrence of a BMP code point in a string. </p>
<p>A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NUL character is found at the string terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (NUL-terminated). </td></tr>
<tr><td class="paramname">c</td><td>The BMP code point to find. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the first occurrence of <code>c</code> in <code>s</code> or <code>NULL</code> if <code>c</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002560">Stable:</a></b></dt><dd>ICU 2.0</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a789d1e49355c54ae92ad5bd579c1019b" title="Find the first occurrence of a code point in a string. ">u_strchr32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#ac30e88d264feb6ffd977b6a661d29f24" title="Find the first occurrence of a BMP code point in a string. ">u_memchr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a074dcf5f1a5b5c4088561ac5ac87883a" title="Find the first occurrence of a substring in a string. ">u_strstr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a47bdb20c28603ab39e66c9e518b5b3b6" title="Find the first occurrence of a substring in a string. ">u_strFindFirst</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a789d1e49355c54ae92ad5bd579c1019b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strchr32 </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>c</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the first occurrence of a code point in a string. </p>
<p>A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NUL character is found at the string terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (NUL-terminated). </td></tr>
<tr><td class="paramname">c</td><td>The code point to find. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the first occurrence of <code>c</code> in <code>s</code> or <code>NULL</code> if <code>c</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002561">Stable:</a></b></dt><dd>ICU 2.0</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a39bb46b446b73a54204ba3016edb6737" title="Find the first occurrence of a BMP code point in a string. ">u_strchr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a14f1a66d758f90167c1bf91aee634b71" title="Find the first occurrence of a code point in a string. ">u_memchr32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a074dcf5f1a5b5c4088561ac5ac87883a" title="Find the first occurrence of a substring in a string. ">u_strstr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a47bdb20c28603ab39e66c9e518b5b3b6" title="Find the first occurrence of a substring in a string. ">u_strFindFirst</a> </dd></dl>
</div>
</div>
<a class="anchor" id="abdb8af67ab5198b9db020afa9c3114b3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strcmp </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</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>s2</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two Unicode strings for bitwise equality (code unit order). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>A string to compare. </td></tr>
<tr><td class="paramname">s2</td><td>A string to compare. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 if <code>s1</code> and <code>s2</code> are bitwise equal; a negative value if <code>s1</code> is bitwise less than <code>s2,</code>; a positive value if <code>s1</code> is bitwise greater than <code>s2</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002570">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aa89255f4b7d6fa58e219da1abe22c733"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strcmpCodePointOrder </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</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>s2</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two Unicode strings in code point order. </p>
<p>See u_strCompare for details.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>A string to compare. </td></tr>
<tr><td class="paramname">s2</td><td>A string to compare. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a negative/zero/positive integer corresponding to whether the first string is less than/equal to/greater than the second one in code point order </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002571">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a51fe041d3e4e408595d665c0f5f68715"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strCompare </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length1</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>s2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td>
<td class="paramname"><em>codePointOrder</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two Unicode strings (binary order). </p>
<p>The comparison can be done in code unit order or in code point order. They differ only in UTF-16 when comparing supplementary code points (U+10000..U+10ffff) to BMP code points near the end of the BMP (i.e., U+e000..U+ffff). In code unit order, high BMP code points sort after supplementary code points because they are stored as pairs of surrogates which are at U+d800..U+dfff.</p>
<p>This functions works with strings of different explicitly specified lengths unlike the ANSI C-like <a class="el" href="ustring_8h.html#abdb8af67ab5198b9db020afa9c3114b3" title="Compare two Unicode strings for bitwise equality (code unit order). ">u_strcmp()</a> and <a class="el" href="ustring_8h.html#a95643325eec27e247d28531f3c68600b" title="Compare the first count UChars of each buffer. ">u_memcmp()</a> etc. NUL-terminated strings are possible with length arguments of -1.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>First source string. </td></tr>
<tr><td class="paramname">length1</td><td>Length of first source string, or -1 if NUL-terminated.</td></tr>
<tr><td class="paramname">s2</td><td>Second source string. </td></tr>
<tr><td class="paramname">length2</td><td>Length of second source string, or -1 if NUL-terminated.</td></tr>
<tr><td class="paramname">codePointOrder</td><td>Choose between code unit order (FALSE) and code point order (TRUE).</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><0 or 0 or >0 as usual for string comparisons</dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002572">Stable:</a></b></dt><dd>ICU 2.2 </dd></dl>
</div>
</div>
<a class="anchor" id="aecf733c47b2a1b353947b2264f724897"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strCompareIter </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structUCharIterator.html">UCharIterator</a> * </td>
<td class="paramname"><em>iter1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structUCharIterator.html">UCharIterator</a> * </td>
<td class="paramname"><em>iter2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td>
<td class="paramname"><em>codePointOrder</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two Unicode strings (binary order) as presented by <a class="el" href="structUCharIterator.html" title="C API for code unit iteration. ">UCharIterator</a> objects. </p>
<p>Works otherwise just like <a class="el" href="ustring_8h.html#a51fe041d3e4e408595d665c0f5f68715" title="Compare two Unicode strings (binary order). ">u_strCompare()</a>.</p>
<p>Both iterators are reset to their start positions. When the function returns, it is undefined where the iterators have stopped.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">iter1</td><td>First source string iterator. </td></tr>
<tr><td class="paramname">iter2</td><td>Second source string iterator. </td></tr>
<tr><td class="paramname">codePointOrder</td><td>Choose between code unit order (FALSE) and code point order (TRUE).</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><0 or 0 or >0 as usual for string comparisons</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a51fe041d3e4e408595d665c0f5f68715" title="Compare two Unicode strings (binary order). ">u_strCompare</a></dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002573">Stable:</a></b></dt><dd>ICU 2.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a46360874cb6a798ad8a0a5e19d72a82a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strcpy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>dst</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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy a ustring. </p>
<p>Adds a null terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination string. </td></tr>
<tr><td class="paramname">src</td><td>The source string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dst</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002581">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a46705ee9aa862bb21100514f96417b17"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strcspn </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>string</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>matchSet</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the number of consecutive characters in <code>string</code>, beginning with the first, that do not occur somewhere in <code>matchSet</code>. </p>
<p>Works just like C's strcspn but with Unicode.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string in which to search, NUL-terminated. </td></tr>
<tr><td class="paramname">matchSet</td><td>A NUL-terminated string defining a set of code points for which to search in the text string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The number of initial characters in <code>string</code> that do not occur in <code>matchSet</code>. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#abbbb5b3b858f9e9113beaf315aa7085a" title="Returns the number of consecutive characters in string, beginning with the first, that occur somewher...">u_strspn</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002567">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a47bdb20c28603ab39e66c9e518b5b3b6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFindFirst </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length</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>substring</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>subLength</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the first occurrence of a substring in a string. </p>
<p>The substring is found at code point boundaries. That means that if the substring begins with a trail surrogate or ends with a lead surrogate, then it is found only if these surrogates stand alone in the text. Otherwise, the substring edge units would be matched against halves of surrogate pairs.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search. </td></tr>
<tr><td class="paramname">length</td><td>The length of s (number of UChars), or -1 if it is NUL-terminated. </td></tr>
<tr><td class="paramname">substring</td><td>The substring to find (NUL-terminated). </td></tr>
<tr><td class="paramname">subLength</td><td>The length of substring (number of UChars), or -1 if it is NUL-terminated. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the first occurrence of <code>substring</code> in <code>s</code>, or <code>s</code> itself if the <code>substring</code> is empty, or <code>NULL</code> if <code>substring</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002559">Stable:</a></b></dt><dd>ICU 2.4</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a074dcf5f1a5b5c4088561ac5ac87883a" title="Find the first occurrence of a substring in a string. ">u_strstr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f" title="Find the last occurrence of a substring in a string. ">u_strFindLast</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a0304151e1130c43372d51f97d0fb2b0f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFindLast </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length</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>substring</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>subLength</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the last occurrence of a substring in a string. </p>
<p>The substring is found at code point boundaries. That means that if the substring begins with a trail surrogate or ends with a lead surrogate, then it is found only if these surrogates stand alone in the text. Otherwise, the substring edge units would be matched against halves of surrogate pairs.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search. </td></tr>
<tr><td class="paramname">length</td><td>The length of s (number of UChars), or -1 if it is NUL-terminated. </td></tr>
<tr><td class="paramname">substring</td><td>The substring to find (NUL-terminated). </td></tr>
<tr><td class="paramname">subLength</td><td>The length of substring (number of UChars), or -1 if it is NUL-terminated. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the last occurrence of <code>substring</code> in <code>s</code>, or <code>s</code> itself if the <code>substring</code> is empty, or <code>NULL</code> if <code>substring</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002563">Stable:</a></b></dt><dd>ICU 2.4</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a074dcf5f1a5b5c4088561ac5ac87883a" title="Find the first occurrence of a substring in a string. ">u_strstr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f" title="Find the last occurrence of a substring in a string. ">u_strFindLast</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ab6709b5a5c1606cf0d3ea24934d9acce"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strFoldCase </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">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>Case-folds the characters in a 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 are allowed to overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </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 zero-terminated. </td></tr>
<tr><td class="paramname">options</td><td>Either U_FOLD_CASE_DEFAULT or U_FOLD_CASE_EXCLUDE_SPECIAL_I </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. It may be greater than destCapacity. In that case, only some of the result was written to the destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002604">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aef59ec61e141905bf7b5970ae21f5dd2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFromJavaModifiedUTF8WithSub </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">int32_t * </td>
<td class="paramname"><em>pDestLength</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="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>subchar</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"><em>pNumSubstitutions</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>Convert a Java Modified UTF-8 string to a 16-bit Unicode string. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<p>This function behaves according to the documentation for Java DataInput.readUTF() except that it takes a length parameter rather than interpreting the first two input bytes as the length. See <a href="http://java.sun.com/javase/6/docs/api/java/io/DataInput.html#readUTF()">http://java.sun.com/javase/6/docs/api/java/io/DataInput.html#readUTF()</a></p>
<p>The output string may not be well-formed UTF-16.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-terminated. </td></tr>
<tr><td class="paramname">subchar</td><td>The substitution character to use in place of an illegal input sequence, or U_SENTINEL if the function is to return with U_INVALID_CHAR_FOUND instead. A substitution character can be any valid Unicode code point (up to U+10FFFF) except for surrogate code points (U+D800..U+DFFF). The recommended value is U+FFFD "REPLACEMENT CHARACTER". </td></tr>
<tr><td class="paramname">pNumSubstitutions</td><td>Output parameter receiving the number of substitutions if subchar>=0. Set to 0 if no substitutions occur or subchar<0. pNumSubstitutions can be NULL. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Pointer to a standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The pointer to destination buffer. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a0e9b7cd493c351804322ad1805fbe775" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8WithSub</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#ae5d278594ac005f683bf35e8e4373130" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8Lenient</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#ac3f8c6911cbb97e1797c73f4b3ae6c51" title="Convert a 16-bit Unicode string to Java Modified UTF-8. ">u_strToJavaModifiedUTF8</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002617">Stable:</a></b></dt><dd>ICU 4.4 </dd></dl>
</div>
</div>
<a class="anchor" id="a0b6154c1f288ec9a4d25fb0678cd90a0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFromUTF32 </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">int32_t * </td>
<td class="paramname"><em>pDestLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</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>Convert a UTF-32 string to UTF-16. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-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 pointer to destination buffer. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#ae6a665906f6ec6902fa755bfc43e1000" title="Convert a UTF-32 string to UTF-16. ">u_strFromUTF32WithSub</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a471e6e4857f06b262ceac485b7ffcae4" title="Convert a UTF-16 string to UTF-32. ">u_strToUTF32</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002613">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ae6a665906f6ec6902fa755bfc43e1000"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFromUTF32WithSub </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">int32_t * </td>
<td class="paramname"><em>pDestLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</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="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>subchar</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"><em>pNumSubstitutions</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>Convert a UTF-32 string to UTF-16. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<p>Same as <a class="el" href="ustring_8h.html#a0b6154c1f288ec9a4d25fb0678cd90a0" title="Convert a UTF-32 string to UTF-16. ">u_strFromUTF32()</a> except for the additional subchar which is output for illegal input sequences, instead of stopping with the U_INVALID_CHAR_FOUND error code. With subchar==U_SENTINEL, this function behaves exactly like <a class="el" href="ustring_8h.html#a0b6154c1f288ec9a4d25fb0678cd90a0" title="Convert a UTF-32 string to UTF-16. ">u_strFromUTF32()</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-terminated. </td></tr>
<tr><td class="paramname">subchar</td><td>The substitution character to use in place of an illegal input sequence, or U_SENTINEL if the function is to return with U_INVALID_CHAR_FOUND instead. A substitution character can be any valid Unicode code point (up to U+10FFFF) except for surrogate code points (U+D800..U+DFFF). The recommended value is U+FFFD "REPLACEMENT CHARACTER". </td></tr>
<tr><td class="paramname">pNumSubstitutions</td><td>Output parameter receiving the number of substitutions if subchar>=0. Set to 0 if no substitutions occur or subchar<0. pNumSubstitutions can be NULL. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Pointer to a standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The pointer to destination buffer. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a0b6154c1f288ec9a4d25fb0678cd90a0" title="Convert a UTF-32 string to UTF-16. ">u_strFromUTF32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#aadb94acab6ec4c8f8b93f88d2da376a3" title="Convert a UTF-16 string to UTF-32. ">u_strToUTF32WithSub</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002615">Stable:</a></b></dt><dd>ICU 4.2 </dd></dl>
</div>
</div>
<a class="anchor" id="a5f9ff224b11166a106d1b3ac26454cd4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFromUTF8 </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">int32_t * </td>
<td class="paramname"><em>pDestLength</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>Convert a UTF-8 string to UTF-16. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-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 pointer to destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002608">Stable:</a></b></dt><dd>ICU 2.0 <dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a0e9b7cd493c351804322ad1805fbe775" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8WithSub</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#ae5d278594ac005f683bf35e8e4373130" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8Lenient</a> </dd></dl>
</dd></dl>
</div>
</div>
<a class="anchor" id="ae5d278594ac005f683bf35e8e4373130"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFromUTF8Lenient </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">int32_t * </td>
<td class="paramname"><em>pDestLength</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>Convert a UTF-8 string to UTF-16. </p>
<p>Same as <a class="el" href="ustring_8h.html#a5f9ff224b11166a106d1b3ac26454cd4" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8()</a> except that this function is designed to be very fast, which it achieves by being lenient about malformed UTF-8 sequences. This function is intended for use in environments where UTF-8 text is expected to be well-formed.</p>
<p>Its semantics are:</p>
<ul>
<li>Well-formed UTF-8 text is correctly converted to well-formed UTF-16 text.</li>
<li>The function will not read beyond the input string, nor write beyond the destCapacity.</li>
<li>Malformed UTF-8 results in "garbage" 16-bit Unicode strings which may not be well-formed UTF-16. The function will resynchronize to valid code point boundaries within a small number of code points after an illegal sequence.</li>
<li>Non-shortest forms are not detected and will result in "spoofing" output.</li>
</ul>
<p>For further performance improvement, if srcLength is given (>=0), then it must be destCapacity>=srcLength.</p>
<p>There is no inverse u_strToUTF8Lenient() function because there is practically no performance gain from not checking that a UTF-16 string is well-formed.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). Unlike for other ICU functions, if srcLength>=0 then it must be destCapacity>=srcLength. </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. Unlike for other ICU functions, if srcLength>=0 but destCapacity<srcLength, then *pDestLength will be set to srcLength (and U_BUFFER_OVERFLOW_ERROR will be set) regardless of the actual result length. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-terminated. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Pointer to a standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The pointer to destination buffer. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a5f9ff224b11166a106d1b3ac26454cd4" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0e9b7cd493c351804322ad1805fbe775" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8WithSub</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a7a79e37a3b1a261a9326029d2a1b1b80" title="Convert a UTF-16 string to UTF-8. ">u_strToUTF8WithSub</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002611">Stable:</a></b></dt><dd>ICU 3.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a0e9b7cd493c351804322ad1805fbe775"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFromUTF8WithSub </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">int32_t * </td>
<td class="paramname"><em>pDestLength</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="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>subchar</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"><em>pNumSubstitutions</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>Convert a UTF-8 string to UTF-16. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<p>Same as <a class="el" href="ustring_8h.html#a5f9ff224b11166a106d1b3ac26454cd4" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8()</a> except for the additional subchar which is output for illegal input sequences, instead of stopping with the U_INVALID_CHAR_FOUND error code. With subchar==U_SENTINEL, this function behaves exactly like <a class="el" href="ustring_8h.html#a5f9ff224b11166a106d1b3ac26454cd4" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8()</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-terminated. </td></tr>
<tr><td class="paramname">subchar</td><td>The substitution character to use in place of an illegal input sequence, or U_SENTINEL if the function is to return with U_INVALID_CHAR_FOUND instead. A substitution character can be any valid Unicode code point (up to U+10FFFF) except for surrogate code points (U+D800..U+DFFF). The recommended value is U+FFFD "REPLACEMENT CHARACTER". </td></tr>
<tr><td class="paramname">pNumSubstitutions</td><td>Output parameter receiving the number of substitutions if subchar>=0. Set to 0 if no substitutions occur or subchar<0. pNumSubstitutions can be NULL. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Pointer to a standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The pointer to destination buffer. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a5f9ff224b11166a106d1b3ac26454cd4" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#ae5d278594ac005f683bf35e8e4373130" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8Lenient</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a7a79e37a3b1a261a9326029d2a1b1b80" title="Convert a UTF-16 string to UTF-8. ">u_strToUTF8WithSub</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002610">Stable:</a></b></dt><dd>ICU 3.6 </dd></dl>
</div>
</div>
<a class="anchor" id="ad7f574ab350d889fce6e44514807728d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strFromWCS </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">int32_t * </td>
<td class="paramname"><em>pDestLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const wchar_t * </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>Convert a wchar_t string to UTF-16. </p>
<p>If it is known at compile time that wchar_t strings are in UTF-16 or UTF-32, then this function simply calls the fast, dedicated function for that. Otherwise, two conversions wchar_t* -> default charset -> UTF-16 are performed.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-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 pointer to destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002606">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aabfeafb91e43b3a2c8bdd46c0743d4b2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> u_strHasMoreChar32Than </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>number</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Check if the string contains more Unicode code points than a certain number. </p>
<p>This is more efficient than counting all code points in the entire string and comparing that number with a threshold. This function may not need to scan the string at all if the length is known (not -1 for NUL-termination) and falls within a certain range, and never needs to count more than 'number+1' code points. Logically equivalent to (u_countChar32(s, length)>number). A Unicode code point may occupy either one or two UChar code units.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The input string. </td></tr>
<tr><td class="paramname">length</td><td>The length of the string, or -1 if it is NUL-terminated. </td></tr>
<tr><td class="paramname">number</td><td>The number of code points in the string is compared against the 'number' parameter. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Boolean value for whether the string contains more Unicode code points than 'number'. Same as (u_countChar32(s, length)>number). </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002555">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
</div>
</div>
<a class="anchor" id="ab9cf5ce80a494a8c1501fb76ab93d4c0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strncasecmp </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</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>s2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>n</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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two strings case-insensitively using full case folding. </p>
<p>This is equivalent to u_strcmp(u_strFoldCase(s1, at most n, options), u_strFoldCase(s2, at most n, options)).</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>A string to compare. </td></tr>
<tr><td class="paramname">s2</td><td>A string to compare. </td></tr>
<tr><td class="paramname">n</td><td>The maximum number of characters each string to case-fold and then compare. </td></tr>
<tr><td class="paramname">options</td><td>A bit set of options:<ul>
<li>U_FOLD_CASE_DEFAULT or 0 is used for default options: Comparison in code unit order with default case folding.</li>
<li>U_COMPARE_CODE_POINT_ORDER Set to choose code point order instead of code unit order (see u_strCompare for details).</li>
<li>U_FOLD_CASE_EXCLUDE_SPECIAL_I</li>
</ul>
</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A negative, zero, or positive integer indicating the comparison result. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002579">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a7ef9c4fbf2506fd23fae363b0b92fd11"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strncat </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>dst</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>n</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Concatenate two ustrings. </p>
<p>Appends at most <code>n</code> characters from <code>src</code> to <code>dst</code>. Adds a terminating NUL. If src is too long, then only <code>n-1</code> characters will be copied before the terminating NUL. If <code>n<=0</code> then dst is not modified.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination string. </td></tr>
<tr><td class="paramname">src</td><td>The source string (can be NULL/invalid if n<=0). </td></tr>
<tr><td class="paramname">n</td><td>The maximum number of characters to append; no-op if <=0. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dst</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002557">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a6c672ffda88b342f9cc1f53a7c8d28c3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strncmp </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>ucs1</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>ucs2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>n</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two ustrings for bitwise equality. </p>
<p>Compares at most <code>n</code> characters.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ucs1</td><td>A string to compare (can be NULL/invalid if n<=0). </td></tr>
<tr><td class="paramname">ucs2</td><td>A string to compare (can be NULL/invalid if n<=0). </td></tr>
<tr><td class="paramname">n</td><td>The maximum number of characters to compare; always returns 0 if n<=0. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 if <code>s1</code> and <code>s2</code> are bitwise equal; a negative value if <code>s1</code> is bitwise less than <code>s2</code>; a positive value if <code>s1</code> is bitwise greater than <code>s2</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002576">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ad7191a125406dd8e7770dbbfb38951ee"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strncmpCodePointOrder </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s1</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>s2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>n</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two Unicode strings in code point order. </p>
<p>This is different in UTF-16 from <a class="el" href="ustring_8h.html#a6c672ffda88b342f9cc1f53a7c8d28c3" title="Compare two ustrings for bitwise equality. ">u_strncmp()</a> if supplementary characters are present. For details, see <a class="el" href="ustring_8h.html#a51fe041d3e4e408595d665c0f5f68715" title="Compare two Unicode strings (binary order). ">u_strCompare()</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>A string to compare. </td></tr>
<tr><td class="paramname">s2</td><td>A string to compare. </td></tr>
<tr><td class="paramname">n</td><td>The maximum number of characters to compare. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a negative/zero/positive integer corresponding to whether the first string is less than/equal to/greater than the second one in code point order </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002577">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a0886e9d12ac63f891f2336ea8c16c042"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strncpy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>dst</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>n</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy a ustring. </p>
<p>Copies at most <code>n</code> characters. The result will be null terminated if the length of <code>src</code> is less than <code>n</code>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination string. </td></tr>
<tr><td class="paramname">src</td><td>The source string (can be NULL/invalid if n<=0). </td></tr>
<tr><td class="paramname">n</td><td>The maximum number of characters to copy; no-op if <=0. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dst</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002582">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aa5c78a0cf3c46e90c96c8e5ff5abef29"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strpbrk </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>string</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>matchSet</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Locates the first occurrence in the string <code>string</code> of any of the characters in the string <code>matchSet</code>. </p>
<p>Works just like C's strpbrk but with Unicode.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string in which to search, NUL-terminated. </td></tr>
<tr><td class="paramname">matchSet</td><td>A NUL-terminated string defining a set of code points for which to search in the text string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the character in <code>string</code> that matches one of the characters in <code>matchSet</code>, or NULL if no such character is found. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002566">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a16488aa76883493fdecf3b15b0576d59"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strrchr </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</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>c</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the last occurrence of a BMP code point in a string. </p>
<p>A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NUL character is found at the string terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (NUL-terminated). </td></tr>
<tr><td class="paramname">c</td><td>The BMP code point to find. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the last occurrence of <code>c</code> in <code>s</code> or <code>NULL</code> if <code>c</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002564">Stable:</a></b></dt><dd>ICU 2.4</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a2fca97af95e51306fedaf103b10fa993" title="Find the last occurrence of a code point in a string. ">u_strrchr32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#af5002dc5e89378549c68313968790ed7" title="Find the last occurrence of a BMP code point in a string. ">u_memrchr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a55b181aa1237366b05f3b1cc158dda95" title="Find the last occurrence of a substring in a string. ">u_strrstr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f" title="Find the last occurrence of a substring in a string. ">u_strFindLast</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a2fca97af95e51306fedaf103b10fa993"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strrchr32 </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>c</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the last occurrence of a code point in a string. </p>
<p>A surrogate code point is found only if its match in the text is not part of a surrogate pair. A NUL character is found at the string terminator.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (NUL-terminated). </td></tr>
<tr><td class="paramname">c</td><td>The code point to find. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the last occurrence of <code>c</code> in <code>s</code> or <code>NULL</code> if <code>c</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002565">Stable:</a></b></dt><dd>ICU 2.4</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a16488aa76883493fdecf3b15b0576d59" title="Find the last occurrence of a BMP code point in a string. ">u_strrchr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a14f1a66d758f90167c1bf91aee634b71" title="Find the first occurrence of a code point in a string. ">u_memchr32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a55b181aa1237366b05f3b1cc158dda95" title="Find the last occurrence of a substring in a string. ">u_strrstr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f" title="Find the last occurrence of a substring in a string. ">u_strFindLast</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a55b181aa1237366b05f3b1cc158dda95"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strrstr </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</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>substring</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the last occurrence of a substring in a string. </p>
<p>The substring is found at code point boundaries. That means that if the substring begins with a trail surrogate or ends with a lead surrogate, then it is found only if these surrogates stand alone in the text. Otherwise, the substring edge units would be matched against halves of surrogate pairs.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (NUL-terminated). </td></tr>
<tr><td class="paramname">substring</td><td>The substring to find (NUL-terminated). </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the last occurrence of <code>substring</code> in <code>s</code>, or <code>s</code> itself if the <code>substring</code> is empty, or <code>NULL</code> if <code>substring</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002562">Stable:</a></b></dt><dd>ICU 2.4</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a074dcf5f1a5b5c4088561ac5ac87883a" title="Find the first occurrence of a substring in a string. ">u_strstr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a47bdb20c28603ab39e66c9e518b5b3b6" title="Find the first occurrence of a substring in a string. ">u_strFindFirst</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f" title="Find the last occurrence of a substring in a string. ">u_strFindLast</a> </dd></dl>
</div>
</div>
<a class="anchor" id="abbbb5b3b858f9e9113beaf315aa7085a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strspn </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>string</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>matchSet</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the number of consecutive characters in <code>string</code>, beginning with the first, that occur somewhere in <code>matchSet</code>. </p>
<p>Works just like C's strspn but with Unicode.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">string</td><td>The string in which to search, NUL-terminated. </td></tr>
<tr><td class="paramname">matchSet</td><td>A NUL-terminated string defining a set of code points for which to search in the text string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The number of initial characters in <code>string</code> that do occur in <code>matchSet</code>. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a46705ee9aa862bb21100514f96417b17" title="Returns the number of consecutive characters in string, beginning with the first, that do not occur s...">u_strcspn</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002568">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a074dcf5f1a5b5c4088561ac5ac87883a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strstr </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>s</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>substring</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the first occurrence of a substring in a string. </p>
<p>The substring is found at code point boundaries. That means that if the substring begins with a trail surrogate or ends with a lead surrogate, then it is found only if these surrogates stand alone in the text. Otherwise, the substring edge units would be matched against halves of surrogate pairs.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>The string to search (NUL-terminated). </td></tr>
<tr><td class="paramname">substring</td><td>The substring to find (NUL-terminated). </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the first occurrence of <code>substring</code> in <code>s</code>, or <code>s</code> itself if the <code>substring</code> is empty, or <code>NULL</code> if <code>substring</code> is not in <code>s</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002558">Stable:</a></b></dt><dd>ICU 2.0</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a55b181aa1237366b05f3b1cc158dda95" title="Find the last occurrence of a substring in a string. ">u_strrstr</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a47bdb20c28603ab39e66c9e518b5b3b6" title="Find the first occurrence of a substring in a string. ">u_strFindFirst</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0304151e1130c43372d51f97d0fb2b0f" title="Find the last occurrence of a substring in a string. ">u_strFindLast</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ac3f8c6911cbb97e1797c73f4b3ae6c51"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* u_strToJavaModifiedUTF8 </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">int32_t * </td>
<td class="paramname"><em>pDestLength</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>Convert a 16-bit Unicode string to Java Modified UTF-8. </p>
<p>See <a href="http://java.sun.com/javase/6/docs/api/java/io/DataInput.html#modified-utf-8">http://java.sun.com/javase/6/docs/api/java/io/DataInput.html#modified-utf-8</a></p>
<p>This function behaves according to the documentation for Java DataOutput.writeUTF() except that it does not encode the output length in the destination buffer and does not have an output length restriction. See <a href="http://java.sun.com/javase/6/docs/api/java/io/DataOutput.html#writeUTF(java.lang.String)">http://java.sun.com/javase/6/docs/api/java/io/DataOutput.html#writeUTF(java.lang.String)</a></p>
<p>The input string need not be well-formed UTF-16. (Therefore there is no subchar parameter.)</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of chars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-terminated. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Pointer to a standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The pointer to destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002616">Stable:</a></b></dt><dd>ICU 4.4 <dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a7a79e37a3b1a261a9326029d2a1b1b80" title="Convert a UTF-16 string to UTF-8. ">u_strToUTF8WithSub</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#aef59ec61e141905bf7b5970ae21f5dd2" title="Convert a Java Modified UTF-8 string to a 16-bit Unicode string. ">u_strFromJavaModifiedUTF8WithSub</a> </dd></dl>
</dd></dl>
</div>
</div>
<a class="anchor" id="accb09fb94f8b6c7b83162c3a24b698de"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_strtok_r </td>
<td>(</td>
<td class="paramtype"><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">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>delim</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>saveState</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>The string tokenizer API allows an application to break a string into tokens. </p>
<p>Unlike strtok(), the saveState (the current pointer within the original string) is maintained in saveState. In the first call, the argument src is a pointer to the string. In subsequent calls to return successive tokens of that string, src must be specified as NULL. The value saveState is set by this function to maintain the function's position within the string, and on each subsequent call you must give this argument the same variable. This function does handle surrogate pairs. This function is similar to the strtok_r() the POSIX Threads Extension (1003.1c-1995) version.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">src</td><td>String containing token(s). This string will be modified. After the first call to <a class="el" href="ustring_8h.html#accb09fb94f8b6c7b83162c3a24b698de" title="The string tokenizer API allows an application to break a string into tokens. ">u_strtok_r()</a>, this argument must be NULL to get to the next token. </td></tr>
<tr><td class="paramname">delim</td><td>Set of delimiter characters (Unicode code points). </td></tr>
<tr><td class="paramname">saveState</td><td>The current pointer within the original string, which is set by this function. The saveState parameter should the address of a local variable of type UChar *. (i.e. defined "Uhar *myLocalSaveState" and use &myLocalSaveState for this parameter). </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the next token found in src, or NULL when there are no more tokens. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002569">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ae3ed589f5ce0d550c228ee69bfed58fb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strToLower </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">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>Lowercase the characters in a 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 are allowed to overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </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 zero-terminated. </td></tr>
<tr><td class="paramname">locale</td><td>The locale to consider, or "" for the root locale or NULL for the default locale. </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. It may be greater than destCapacity. In that case, only some of the result was written to the destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002602">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a8c6202ad4ac954e225aae061b184e450"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strToTitle </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="ubrk_8h.html#adb85bb46d5f93c87098e11deab50bef4">UBreakIterator</a> * </td>
<td class="paramname"><em>titleIter</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>Titlecase a 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.</p>
<p>The titlecase break iterator can be provided to customize for arbitrary styles, using rules and dictionaries beyond the standard iterators. It may be more efficient to always provide an iterator to avoid opening and closing one for each string. The standard titlecase iterator for the root locale implements the algorithm of Unicode TR 21.</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 are allowed to overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </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 zero-terminated. </td></tr>
<tr><td class="paramname">titleIter</td><td>A break iterator to find the first characters of words that are to be titlecased. If none is provided (NULL), then a standard titlecase break iterator is opened. </td></tr>
<tr><td class="paramname">locale</td><td>The locale to consider, or "" for the root locale or NULL for the default locale. </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. It may be greater than destCapacity. In that case, only some of the result was written to the destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002603">Stable:</a></b></dt><dd>ICU 2.1 </dd></dl>
</div>
</div>
<a class="anchor" id="a14740e3b734ffa82205d4762fcacb5e1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_strToUpper </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">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>Uppercase the characters in a 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 are allowed to overlap.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </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 zero-terminated. </td></tr>
<tr><td class="paramname">locale</td><td>The locale to consider, or "" for the root locale or NULL for the default locale. </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. It may be greater than destCapacity. In that case, only some of the result was written to the destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002601">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a471e6e4857f06b262ceac485b7ffcae4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a>* u_strToUTF32 </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</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">int32_t * </td>
<td class="paramname"><em>pDestLength</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>Convert a UTF-16 string to UTF-32. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChar32s). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-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 pointer to destination buffer. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#aadb94acab6ec4c8f8b93f88d2da376a3" title="Convert a UTF-16 string to UTF-32. ">u_strToUTF32WithSub</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0b6154c1f288ec9a4d25fb0678cd90a0" title="Convert a UTF-32 string to UTF-16. ">u_strFromUTF32</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002612">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aadb94acab6ec4c8f8b93f88d2da376a3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a>* u_strToUTF32WithSub </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</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">int32_t * </td>
<td class="paramname"><em>pDestLength</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="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>subchar</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"><em>pNumSubstitutions</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>Convert a UTF-16 string to UTF-32. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<p>Same as <a class="el" href="ustring_8h.html#a471e6e4857f06b262ceac485b7ffcae4" title="Convert a UTF-16 string to UTF-32. ">u_strToUTF32()</a> except for the additional subchar which is output for illegal input sequences, instead of stopping with the U_INVALID_CHAR_FOUND error code. With subchar==U_SENTINEL, this function behaves exactly like <a class="el" href="ustring_8h.html#a471e6e4857f06b262ceac485b7ffcae4" title="Convert a UTF-16 string to UTF-32. ">u_strToUTF32()</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of UChar32s). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-terminated. </td></tr>
<tr><td class="paramname">subchar</td><td>The substitution character to use in place of an illegal input sequence, or U_SENTINEL if the function is to return with U_INVALID_CHAR_FOUND instead. A substitution character can be any valid Unicode code point (up to U+10FFFF) except for surrogate code points (U+D800..U+DFFF). The recommended value is U+FFFD "REPLACEMENT CHARACTER". </td></tr>
<tr><td class="paramname">pNumSubstitutions</td><td>Output parameter receiving the number of substitutions if subchar>=0. Set to 0 if no substitutions occur or subchar<0. pNumSubstitutions can be NULL. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Pointer to a standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The pointer to destination buffer. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a471e6e4857f06b262ceac485b7ffcae4" title="Convert a UTF-16 string to UTF-32. ">u_strToUTF32</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#ae6a665906f6ec6902fa755bfc43e1000" title="Convert a UTF-32 string to UTF-16. ">u_strFromUTF32WithSub</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002614">Stable:</a></b></dt><dd>ICU 4.2 </dd></dl>
</div>
</div>
<a class="anchor" id="a0ca7af2cf47b116454eed92331594afa"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* u_strToUTF8 </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">int32_t * </td>
<td class="paramname"><em>pDestLength</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>Convert a UTF-16 string to UTF-8. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of chars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-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 pointer to destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002607">Stable:</a></b></dt><dd>ICU 2.0 <dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a7a79e37a3b1a261a9326029d2a1b1b80" title="Convert a UTF-16 string to UTF-8. ">u_strToUTF8WithSub</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a5f9ff224b11166a106d1b3ac26454cd4" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8</a> </dd></dl>
</dd></dl>
</div>
</div>
<a class="anchor" id="a7a79e37a3b1a261a9326029d2a1b1b80"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* u_strToUTF8WithSub </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">int32_t * </td>
<td class="paramname"><em>pDestLength</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="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> </td>
<td class="paramname"><em>subchar</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"><em>pNumSubstitutions</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>Convert a UTF-16 string to UTF-8. </p>
<p>If the input string is not well-formed, then the U_INVALID_CHAR_FOUND error code is set.</p>
<p>Same as <a class="el" href="ustring_8h.html#a0ca7af2cf47b116454eed92331594afa" title="Convert a UTF-16 string to UTF-8. ">u_strToUTF8()</a> except for the additional subchar which is output for illegal input sequences, instead of stopping with the U_INVALID_CHAR_FOUND error code. With subchar==U_SENTINEL, this function behaves exactly like <a class="el" href="ustring_8h.html#a0ca7af2cf47b116454eed92331594afa" title="Convert a UTF-16 string to UTF-8. ">u_strToUTF8()</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of chars). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-terminated. </td></tr>
<tr><td class="paramname">subchar</td><td>The substitution character to use in place of an illegal input sequence, or U_SENTINEL if the function is to return with U_INVALID_CHAR_FOUND instead. A substitution character can be any valid Unicode code point (up to U+10FFFF) except for surrogate code points (U+D800..U+DFFF). The recommended value is U+FFFD "REPLACEMENT CHARACTER". </td></tr>
<tr><td class="paramname">pNumSubstitutions</td><td>Output parameter receiving the number of substitutions if subchar>=0. Set to 0 if no substitutions occur or subchar<0. pNumSubstitutions can be NULL. </td></tr>
<tr><td class="paramname">pErrorCode</td><td>Pointer to a standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The pointer to destination buffer. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a0ca7af2cf47b116454eed92331594afa" title="Convert a UTF-16 string to UTF-8. ">u_strToUTF8</a> </dd>
<dd>
<a class="el" href="ustring_8h.html#a0e9b7cd493c351804322ad1805fbe775" title="Convert a UTF-8 string to UTF-16. ">u_strFromUTF8WithSub</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002609">Stable:</a></b></dt><dd>ICU 3.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a184562a078b0a961d9281b0c29bb5406"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">wchar_t* u_strToWCS </td>
<td>(</td>
<td class="paramtype">wchar_t * </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">int32_t * </td>
<td class="paramname"><em>pDestLength</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>Convert a UTF-16 string to a wchar_t string. </p>
<p>If it is known at compile time that wchar_t strings are in UTF-16 or UTF-32, then this function simply calls the fast, dedicated function for that. Otherwise, two conversions UTF-16 -> default charset -> wchar_t* are performed.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dest</td><td>A buffer for the result string. The result will be zero-terminated if the buffer is large enough. </td></tr>
<tr><td class="paramname">destCapacity</td><td>The size of the buffer (number of wchar_t's). If it is 0, then dest may be NULL and the function will only return the length of the result without writing any of the result string (pre-flighting). </td></tr>
<tr><td class="paramname">pDestLength</td><td>A pointer to receive the number of units written to the destination. If pDestLength!=NULL then *pDestLength is always set to the number of output units corresponding to the transformation of all the input units, even in case of a buffer overflow. </td></tr>
<tr><td class="paramname">src</td><td>The original source string </td></tr>
<tr><td class="paramname">srcLength</td><td>The length of the original string. If -1, then src must be zero-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 pointer to destination buffer. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002605">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a0f2d5d46acef8e0eac711bef15e7531f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_uastrcpy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>dst</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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy a byte string encoded in the default codepage to a ustring. </p>
<p>Adds a null terminator. Performs a host byte to UChar conversion</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination string. </td></tr>
<tr><td class="paramname">src</td><td>The source string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dst</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002583">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a7ac7463dd6e3e36128aad288eacace8f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* u_uastrncpy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"><em>dst</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>n</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy a byte string encoded in the default codepage to a ustring. </p>
<p>Copies at most <code>n</code> characters. The result will be null terminated if the length of <code>src</code> is less than <code>n</code>. Performs a host byte to UChar conversion</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination string. </td></tr>
<tr><td class="paramname">src</td><td>The source string. </td></tr>
<tr><td class="paramname">n</td><td>The maximum number of characters to copy. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A pointer to <code>dst</code>. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002584">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a7aad56a2a6f7cbe3b2fb802a218d239b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t u_unescape </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"><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></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Unescape a string of characters and write the resulting Unicode characters to the destination buffer. </p>
<p>The following escape sequences are recognized:</p>
<p>\uhhhh 4 hex digits; h in [0-9A-Fa-f] \Uhhhhhhhh 8 hex digits \xhh 1-2 hex digits \x{h...} 1-8 hex digits \ooo 1-3 octal digits; o in [0-7] \cX control-X; X is masked with 0x1F</p>
<p>as well as the standard ANSI C escapes:</p>
<p>\a => U+0007, \b => U+0008, \t => U+0009, \n => U+000A, \v => U+000B, \f => U+000C, \r => U+000D, \e => U+001B, \" => U+0022, \' => U+0027, \? => U+003F, \\ => U+005C</p>
<p>Anything else following a backslash is generically escaped. For example, "[a\\-z]" returns "[a-z]".</p>
<p>If an escape sequence is ill-formed, this method returns an empty string. An example of an ill-formed sequence is "\\u" followed by fewer than 4 hex digits.</p>
<p>The above characters are recognized in the compiler's codepage, that is, they are coded as 'u', '\', etc. Characters that are not parts of escape sequences are converted using <a class="el" href="putil_8h.html#ad2ba2f88b01ea212f2bfbe2c6b0854a7" title="Convert char characters to UChar characters. ">u_charsToUChars()</a>.</p>
<p>This function is similar to UnicodeString::unescape() but not identical to it. The latter takes a source UnicodeString, so it does escape recognition but no conversion.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">src</td><td>a zero-terminated string of invariant characters </td></tr>
<tr><td class="paramname">dest</td><td>pointer to buffer to receive converted and unescaped text and, if there is room, a zero terminator. May be NULL for preflighting, in which case no UChars will be written, but the return value will still be valid. On error, an empty string is stored here (if possible). </td></tr>
<tr><td class="paramname">destCapacity</td><td>the number of UChars that may be written at dest. Ignored if dest == NULL. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>the length of unescaped string. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#ab688f2c7edad54064c3d8c72735461f6" title="Unescape a single sequence. ">u_unescapeAt</a> </dd>
<dd>
UnicodeString::unescape() </dd>
<dd>
UnicodeString::unescapeAt() </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002598">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<a class="anchor" id="ab688f2c7edad54064c3d8c72735461f6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a09fff5c3b5a5b015324dc3ec3cf92809">UChar32</a> u_unescapeAt </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustring_8h.html#a2425cebd8a8a7138eeaf3edd0cd948d8">UNESCAPE_CHAR_AT</a> </td>
<td class="paramname"><em>charAt</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"><em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"><em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>context</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Unescape a single sequence. </p>
<p>The character at offset-1 is assumed (without checking) to be a backslash. This method takes a callback pointer to a function that returns the UChar at a given offset. By varying this callback, ICU functions are able to unescape char* strings, UnicodeString objects, and UFILE pointers.</p>
<p>If offset is out of range, or if the escape sequence is ill-formed, (UChar32)0xFFFFFFFF is returned. See documentation of <a class="el" href="ustring_8h.html#a7aad56a2a6f7cbe3b2fb802a218d239b" title="Unescape a string of characters and write the resulting Unicode characters to the destination buffer...">u_unescape()</a> for a list of recognized sequences.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">charAt</td><td>callback function that returns a UChar of the source text given an offset and a context pointer. </td></tr>
<tr><td class="paramname">offset</td><td>pointer to the offset that will be passed to charAt. The offset value will be updated upon return to point after the last parsed character of the escape sequence. On error the offset is unchanged. </td></tr>
<tr><td class="paramname">length</td><td>the number of characters in the source text. The last character of the source text is considered to be at offset length-1. </td></tr>
<tr><td class="paramname">context</td><td>an opaque pointer passed directly into charAt. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>the character represented by the escape sequence at offset, or (UChar32)0xFFFFFFFF on error. </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="ustring_8h.html#a7aad56a2a6f7cbe3b2fb802a218d239b" title="Unescape a string of characters and write the resulting Unicode characters to the destination buffer...">u_unescape()</a> </dd>
<dd>
UnicodeString::unescape() </dd>
<dd>
UnicodeString::unescapeAt() </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002600">Stable:</a></b></dt><dd>ICU 2.0 </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.6
</small></address>
</body>
</html>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-updates
>
by-pkgid
>
67d6f1fcdf59eeb6f1363fc33c40091c
>
files
>
1409
