Sophie

Sophie

distrib > Mageia > 6 > armv5tl > media > core-release > by-pkgid > 3a4e91bde08970529a0aa07935652fe8 > files > 1010

icu-doc-58.2-3.mga6.noarch.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.11"/>
<title>ICU 58.2: unistr.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname">ICU 58.2
   &#160;<span id="projectnumber">58.2</span>
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="pages.html"><span>Related&#160;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&#160;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
<div id="nav-path" class="navpath">
  <ul>
<li class="navelem"><a class="el" href="dir_b2f33c71d4aa5e7af42a1ca61ff5af1b.html">source</a></li><li class="navelem"><a class="el" href="dir_30087b5439e04c85304dbcf15650710b.html">common</a></li><li class="navelem"><a class="el" href="dir_8bf9c54ed6ca2fd1e2117fb037e4ad06.html">unicode</a></li>  </ul>
</div>
</div><!-- top -->
<div class="header">
  <div class="summary">
<a href="#nested-classes">Data Structures</a> &#124;
<a href="#namespaces">Namespaces</a> &#124;
<a href="#define-members">Macros</a> &#124;
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<div class="title">unistr.h File Reference</div>  </div>
</div><!--header-->
<div class="contents">

<p>C++ API: Unicode String.  
<a href="#details">More...</a></p>
<div class="textblock"><code>#include &quot;<a class="el" href="utypes_8h_source.html">unicode/utypes.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="rep_8h_source.html">unicode/rep.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="std__string_8h_source.html">unicode/std_string.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="stringpiece_8h_source.html">unicode/stringpiece.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="bytestream_8h_source.html">unicode/bytestream.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="ucasemap_8h_source.html">unicode/ucasemap.h</a>&quot;</code><br />
</div>
<p><a href="unistr_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="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1UnicodeString.html">icu::UnicodeString</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight"><a class="el" href="classicu_1_1UnicodeString.html" title="UnicodeString is a string class that stores Unicode characters directly and provides similar function...">UnicodeString</a> is a string class that stores Unicode characters directly and provides similar functionality as the Java String and StringBuffer/StringBuilder classes.  <a href="classicu_1_1UnicodeString.html#details">More...</a><br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="namespaces"></a>
Namespaces</h2></td></tr>
<tr class="memitem:namespaceicu"><td class="memItemLeft" align="right" valign="top"> &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceicu.html">icu</a></td></tr>
<tr class="memdesc:namespaceicu"><td class="mdescLeft">&#160;</td><td class="mdescRight">File <a class="el" href="coll_8h.html" title="C++ API: Collation Service. ">coll.h</a>. <br /></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:a7fd781b068b28ee2db708090aa32df8f"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#a7fd781b068b28ee2db708090aa32df8f">U_COMPARE_CODE_POINT_ORDER</a>&#160;&#160;&#160;0x8000</td></tr>
<tr class="memdesc:a7fd781b068b28ee2db708090aa32df8f"><td class="mdescLeft">&#160;</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">&#160;</td></tr>
<tr class="memitem:ae90f6d771de19edc50bf989e607ddf19"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#ae90f6d771de19edc50bf989e607ddf19">U_STRING_CASE_MAPPER_DEFINED</a></td></tr>
<tr class="separator:ae90f6d771de19edc50bf989e607ddf19"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a308c066384b8560030fb3482bcb13381"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#a308c066384b8560030fb3482bcb13381">US_INV</a>&#160;&#160;&#160;<a class="el" href="classicu_1_1UnicodeString.html#a301902493406de453a439dfadfdd032fa050455dd0665a3c65d041ae02565f74b">icu::UnicodeString::kInvariant</a></td></tr>
<tr class="memdesc:a308c066384b8560030fb3482bcb13381"><td class="mdescLeft">&#160;</td><td class="mdescRight">Constant to be used in the UnicodeString(char *, int32_t, EInvariant) constructor which constructs a Unicode string from an invariant-character char * string.  <a href="#a308c066384b8560030fb3482bcb13381">More...</a><br /></td></tr>
<tr class="separator:a308c066384b8560030fb3482bcb13381"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aeab1ff09f666cf5fce35fc88cf37d714"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#aeab1ff09f666cf5fce35fc88cf37d714">UNICODE_STRING</a>(cs,  _length)&#160;&#160;&#160;<a class="el" href="classicu_1_1UnicodeString.html">icu::UnicodeString</a>(<a class="el" href="umachine_8h.html#aa8cecfc5c5c054d2875c03e77b7be15d">TRUE</a>, (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *)L ## cs, _length)</td></tr>
<tr class="memdesc:aeab1ff09f666cf5fce35fc88cf37d714"><td class="mdescLeft">&#160;</td><td class="mdescRight">Unicode String literals in C++.  <a href="#aeab1ff09f666cf5fce35fc88cf37d714">More...</a><br /></td></tr>
<tr class="separator:aeab1ff09f666cf5fce35fc88cf37d714"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a6cd56429cbf4fe567a97c9d1a46e96ae"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#a6cd56429cbf4fe567a97c9d1a46e96ae">UNICODE_STRING_SIMPLE</a>(cs)&#160;&#160;&#160;<a class="el" href="unistr_8h.html#aeab1ff09f666cf5fce35fc88cf37d714">UNICODE_STRING</a>(cs, -1)</td></tr>
<tr class="memdesc:a6cd56429cbf4fe567a97c9d1a46e96ae"><td class="mdescLeft">&#160;</td><td class="mdescRight">Unicode String literals in C++.  <a href="#a6cd56429cbf4fe567a97c9d1a46e96ae">More...</a><br /></td></tr>
<tr class="separator:a6cd56429cbf4fe567a97c9d1a46e96ae"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a486b34c4465b862509e8ed28f01fbe49"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#a486b34c4465b862509e8ed28f01fbe49">UNISTR_FROM_CHAR_EXPLICIT</a></td></tr>
<tr class="memdesc:a486b34c4465b862509e8ed28f01fbe49"><td class="mdescLeft">&#160;</td><td class="mdescRight">This can be defined to be empty or "explicit".  <a href="#a486b34c4465b862509e8ed28f01fbe49">More...</a><br /></td></tr>
<tr class="separator:a486b34c4465b862509e8ed28f01fbe49"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac4830e8bd24a0774bedb97358e733c1f"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#ac4830e8bd24a0774bedb97358e733c1f">UNISTR_FROM_STRING_EXPLICIT</a></td></tr>
<tr class="memdesc:ac4830e8bd24a0774bedb97358e733c1f"><td class="mdescLeft">&#160;</td><td class="mdescRight">This can be defined to be empty or "explicit".  <a href="#ac4830e8bd24a0774bedb97358e733c1f">More...</a><br /></td></tr>
<tr class="separator:ac4830e8bd24a0774bedb97358e733c1f"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae7130a84a4e48a45005b55a047fc3506"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#ae7130a84a4e48a45005b55a047fc3506">UNISTR_OBJECT_SIZE</a>&#160;&#160;&#160;64</td></tr>
<tr class="memdesc:ae7130a84a4e48a45005b55a047fc3506"><td class="mdescLeft">&#160;</td><td class="mdescRight">Desired sizeof(UnicodeString) in bytes.  <a href="#ae7130a84a4e48a45005b55a047fc3506">More...</a><br /></td></tr>
<tr class="separator:ae7130a84a4e48a45005b55a047fc3506"><td class="memSeparator" colspan="2">&#160;</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:aed084b0ce7fd57c71dc5747f03c9879a"><td class="memItemLeft" align="right" valign="top">typedef int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="unistr_8h.html#aed084b0ce7fd57c71dc5747f03c9879a">UStringCaseMapper</a>(const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr class="memdesc:aed084b0ce7fd57c71dc5747f03c9879a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Internal string case mapping function type.  <a href="#aed084b0ce7fd57c71dc5747f03c9879a">More...</a><br /></td></tr>
<tr class="separator:aed084b0ce7fd57c71dc5747f03c9879a"><td class="memSeparator" colspan="2">&#160;</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&#160;</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">&#160;</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">&#160;</td></tr>
<tr class="memitem:aba07a6dabd3ae5f5ee729f556a9cb960"><td class="memItemLeft" align="right" valign="top"><a class="el" href="utypes_8h.html#a559955ec3bc692657c5d8b1c6de8e334">U_COMMON_API</a> UnicodeString&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceicu.html#aba07a6dabd3ae5f5ee729f556a9cb960">icu::operator+</a> (const UnicodeString &amp;s1, const UnicodeString &amp;s2)</td></tr>
<tr class="memdesc:aba07a6dabd3ae5f5ee729f556a9cb960"><td class="mdescLeft">&#160;</td><td class="mdescRight">Create a new <a class="el" href="classicu_1_1UnicodeString.html" title="UnicodeString is a string class that stores Unicode characters directly and provides similar function...">UnicodeString</a> with the concatenation of two others.  <a href="namespaceicu.html#aba07a6dabd3ae5f5ee729f556a9cb960">More...</a><br /></td></tr>
<tr class="separator:aba07a6dabd3ae5f5ee729f556a9cb960"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>C++ API: Unicode String. </p>

<p>Definition in file <a class="el" href="unistr_8h_source.html">unistr.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&#160;&#160;&#160;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#_stable002061">Stable:</a></b></dt><dd>ICU 2.2 </dd></dl>

<p>Definition at line <a class="el" href="unistr_8h_source.html#l00047">47</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
<a class="anchor" id="ae90f6d771de19edc50bf989e607ddf19"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define U_STRING_CASE_MAPPER_DEFINED</td>
        </tr>
      </table>
</div><div class="memdoc">
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000189">Internal:</a></b></dt><dd>Do not use.</dd></dl>
<p>This API is for internal use only. </p>

<p>Definition at line <a class="el" href="unistr_8h_source.html#l00063">63</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
<a class="anchor" id="aeab1ff09f666cf5fce35fc88cf37d714"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define UNICODE_STRING</td>
          <td>(</td>
          <td class="paramtype">&#160;</td>
          <td class="paramname">cs, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">&#160;</td>
          <td class="paramname">_length&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td>&#160;&#160;&#160;<a class="el" href="classicu_1_1UnicodeString.html">icu::UnicodeString</a>(<a class="el" href="umachine_8h.html#aa8cecfc5c5c054d2875c03e77b7be15d">TRUE</a>, (const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *)L ## cs, _length)</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Unicode String literals in C++. </p>
<p>Dependent on the platform properties, different UnicodeString constructors should be used to create a UnicodeString object from a string literal. 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>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><dl class="stable"><dt><b><a class="el" href="stable.html#_stable002063">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>

<p>Definition at line <a class="el" href="unistr_8h_source.html#l00120">120</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
<a class="anchor" id="a6cd56429cbf4fe567a97c9d1a46e96ae"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define UNICODE_STRING_SIMPLE</td>
          <td>(</td>
          <td class="paramtype">&#160;</td>
          <td class="paramname">cs</td><td>)</td>
          <td>&#160;&#160;&#160;<a class="el" href="unistr_8h.html#aeab1ff09f666cf5fce35fc88cf37d714">UNICODE_STRING</a>(cs, -1)</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Unicode String literals in C++. </p>
<p>Dependent on the platform properties, different UnicodeString constructors should be used to create a UnicodeString object from a string literal. The macros are defined for improved 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>The string parameter must be a C string literal. </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable002064">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>

<p>Definition at line <a class="el" href="unistr_8h_source.html#l00140">140</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
<a class="anchor" id="a486b34c4465b862509e8ed28f01fbe49"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define UNISTR_FROM_CHAR_EXPLICIT</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This can be defined to be empty or "explicit". </p>
<p>If explicit, then the UnicodeString(UChar) and UnicodeString(UChar32) constructors are marked as explicit, preventing their inadvertent use. </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable002065">Stable:</a></b></dt><dd>ICU 49 </dd></dl>

<p>Definition at line <a class="el" href="unistr_8h_source.html#l00155">155</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
<a class="anchor" id="ac4830e8bd24a0774bedb97358e733c1f"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define UNISTR_FROM_STRING_EXPLICIT</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This can be defined to be empty or "explicit". </p>
<p>If explicit, then the UnicodeString(const char *) and UnicodeString(const UChar *) constructors are marked as explicit, preventing their inadvertent use.</p>
<p>In particular, this helps prevent accidentally depending on ICU conversion code by passing a string literal into an API with a const UnicodeString &amp; parameter. </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable002066">Stable:</a></b></dt><dd>ICU 49 </dd></dl>

<p>Definition at line <a class="el" href="unistr_8h_source.html#l00175">175</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
<a class="anchor" id="ae7130a84a4e48a45005b55a047fc3506"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define UNISTR_OBJECT_SIZE&#160;&#160;&#160;64</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Desired sizeof(UnicodeString) in bytes. </p>
<p>It should be a multiple of sizeof(pointer) to avoid unusable space for padding. The object size may want to be a multiple of 16 bytes, which is a common granularity for heap allocation.</p>
<p>Any space inside the object beyond sizeof(vtable pointer) + 2 is available for storing short strings inside the object. The bigger the object, the longer a string that can be stored inside the object, without additional heap allocation.</p>
<p>Depending on a platform's pointer size, pointer alignment requirements, and struct padding, the compiler will usually round up sizeof(UnicodeString) to 4 * sizeof(pointer) (or 3 * sizeof(pointer) for P128 data models), to hold the fields for heap-allocated strings. Such a minimum size also ensures that the object is easily large enough to hold at least 2 UChars, for one supplementary code point (U16_MAX_LENGTH).</p>
<p>sizeof(UnicodeString) &gt;= 48 should work for all known platforms.</p>
<p>For example, on a 64-bit machine where sizeof(vtable pointer) is 8, sizeof(UnicodeString) = 64 would leave space for (64 - sizeof(vtable pointer) - 2) / U_SIZEOF_UCHAR = (64 - 8 - 2) / 2 = 27 UChars stored inside the object.</p>
<p>The minimum object size on a 64-bit machine would be 4 * sizeof(pointer) = 4 * 8 = 32 bytes, and the internal buffer would hold up to 11 UChars in that case.</p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="utf16_8h.html#ab14454ab71a81f0cf86e523e50690eee" title="The maximum number of 16-bit code units per Unicode code point (U+0000..U+10ffff). ">U16_MAX_LENGTH</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002067">Stable:</a></b></dt><dd>ICU 56 </dd></dl>

<p>Definition at line <a class="el" href="unistr_8h_source.html#l00213">213</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
<a class="anchor" id="a308c066384b8560030fb3482bcb13381"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define US_INV&#160;&#160;&#160;<a class="el" href="classicu_1_1UnicodeString.html#a301902493406de453a439dfadfdd032fa050455dd0665a3c65d041ae02565f74b">icu::UnicodeString::kInvariant</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Constant to be used in the UnicodeString(char *, int32_t, EInvariant) constructor which constructs a Unicode string from an invariant-character char * string. </p>
<p>About invariant characters see <a class="el" href="utypes_8h.html" title="Basic definitions for ICU, for both C and C++ APIs. ">utypes.h</a>. This constructor has no runtime dependency on conversion code and is therefore recommended over ones taking a charset name string (where the empty string "" indicates invariant-character conversion).</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002062">Stable:</a></b></dt><dd>ICU 3.2 </dd></dl>

<p>Definition at line <a class="el" href="unistr_8h_source.html#l00098">98</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
<h2 class="groupheader">Typedef Documentation</h2>
<a class="anchor" id="aed084b0ce7fd57c71dc5747f03c9879a"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef int32_t UStringCaseMapper(const <a class="el" href="ucasemap_8h.html#a2c127e061c4bc5f4ccc9defbe01f9dca">UCaseMap</a> *csm, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *src, int32_t srcLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Internal string case mapping function type. </p>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000190">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="unistr_8h_source.html#l00070">70</a> of file <a class="el" href="unistr_8h_source.html">unistr.h</a>.</p>

</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.11
</small></address>
</body>
</html>