<!-- This comment will put IE 6, 7 and 8 in quirks mode -->
<!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"/>
<title>ICU 4.4: uconfig.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javaScript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body onload='searchBox.OnSelectItem(0);'>
<!-- Generated by Doxygen 1.6.1 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<img id="MSearchSelect" src="search/search.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)"/>
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</div>
</li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>uconfig.h File Reference</h1>
<p>Switches for excluding parts of ICU library code modules.
<a href="#_details">More...</a></p>
<p><a href="uconfig_8h_source.html">Go to the source code of this file.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#ada53992bcd80e4cedcaa19627b80ebfe">UCONFIG_ONLY_COLLATION</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">If this switch is defined, ICU will attempt to load a header file named "uconfig_local.h" prior to determining default settings for uconfig variables. <a href="#ada53992bcd80e4cedcaa19627b80ebfe"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#a9c204f328ca0f348182d7fb6d20c47e8">UCONFIG_NO_FILE_IO</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off all file access in the common library where file access is only used for data loading. <a href="#a9c204f328ca0f348182d7fb6d20c47e8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#aaf41571c9594c26947640add578d9b98">UCONFIG_NO_CONVERSION</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">ICU will not completely build with this switch turned on. <a href="#aaf41571c9594c26947640add578d9b98"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#acabbeca768429f4218c03052f51a18ca">UCONFIG_NO_LEGACY_CONVERSION</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off all converters except for</p>
<ul>
<li>Unicode charsets (UTF-7/8/16/32, CESU-8, SCSU, BOCU-1)</li>
<li>US-ASCII</li>
<li>ISO-8859-1. </li>
</ul>
<a href="#acabbeca768429f4218c03052f51a18ca"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#aa2d38e601f89fb17428f51948c584c5e">UCONFIG_NO_NORMALIZATION</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off normalization. <a href="#aa2d38e601f89fb17428f51948c584c5e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#a9805f6a1ddbab690707dd5bac02acb75">UCONFIG_NO_BREAK_ITERATION</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off break iteration. <a href="#a9805f6a1ddbab690707dd5bac02acb75"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#ab7b7ed2538ac4baf798c6d259ea031ae">UCONFIG_NO_IDNA</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off IDNA. <a href="#ab7b7ed2538ac4baf798c6d259ea031ae"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#a8df51da8b14d49bb7f30f4d85b696f1d">UCONFIG_NO_COLLATION</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off collation and collation-based string search. <a href="#a8df51da8b14d49bb7f30f4d85b696f1d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#a5275c907e69e5e080233e6226abf0979">UCONFIG_NO_FORMATTING</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off formatting and calendar/timezone services. <a href="#a5275c907e69e5e080233e6226abf0979"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#a1738a54258452739e85531f850710bd0">UCONFIG_NO_TRANSLITERATION</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off transliteration. <a href="#a1738a54258452739e85531f850710bd0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#abadcf86fb2ad43ae41fd30f750cc67f5">UCONFIG_NO_REGULAR_EXPRESSIONS</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off regular expressions. <a href="#abadcf86fb2ad43ae41fd30f750cc67f5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="uconfig_8h.html#acf867d378b4d1db31be19d6a29cc16fd">UCONFIG_NO_SERVICE</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This switch turns off service registration. <a href="#acf867d378b4d1db31be19d6a29cc16fd"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Switches for excluding parts of ICU library code modules. </p>
<p>Allows to build partial, smaller libraries for special purposes. By default, all modules are built. The switches are fairly coarse, controlling large modules. Basic services cannot be turned off.</p>
<p>Building with any of these options does not guarantee that the ICU build process will completely work. It is recommended that the ICU libraries and data be built using the normal build. At that time you should remove the data used by those services. After building the ICU data library, you should rebuild the ICU libraries with these switches customized to your needs.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001146">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
<p>Definition in file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="a9805f6a1ddbab690707dd5bac02acb75"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_BREAK_ITERATION" ref="a9805f6a1ddbab690707dd5bac02acb75" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_BREAK_ITERATION 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off break iteration. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001152">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00166">166</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="a8df51da8b14d49bb7f30f4d85b696f1d"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_COLLATION" ref="a8df51da8b14d49bb7f30f4d85b696f1d" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_COLLATION 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off collation and collation-based string search. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001154">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00188">188</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="aaf41571c9594c26947640add578d9b98"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_CONVERSION" ref="aaf41571c9594c26947640add578d9b98" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_CONVERSION 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>ICU will not completely build with this switch turned on. </p>
<p>This switch turns off all converters.</p>
<p>You may want to use this together with U_CHARSET_IS_UTF8 defined to 1 in <a class="el" href="utypes_8h.html" title="Basic definitions for ICU, for both C and C++ APIs.">utypes.h</a> if char* strings in your environment are always in UTF-8.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001149">Stable:</a></b></dt><dd>ICU 3.2 </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="utypes_8h.html#a0a33e1edf3cd23d9e9c972b63c9f7943" title="Hardcode the default charset to UTF-8.">U_CHARSET_IS_UTF8</a> </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00114">114</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="a9c204f328ca0f348182d7fb6d20c47e8"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_FILE_IO" ref="a9c204f328ca0f348182d7fb6d20c47e8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_FILE_IO 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off all file access in the common library where file access is only used for data loading. </p>
<p>ICU data must then be provided in the form of a data DLL (or with an equivalent way to link to the data residing in an executable, as in building a combined library with both the common library's code and the data), or via <a class="el" href="udata_8h.html#a467bda719595adb58f959dde735e1153" title="This function bypasses the normal ICU data loading process and allows you to force...">udata_setCommonData()</a>. Application data must be provided via <a class="el" href="udata_8h.html#a406559067e309c05fb90b2d532f11835" title="This function bypasses the normal ICU data loading process for application-specific...">udata_setAppData()</a> or by using "open" functions that take pointers to data, for example <a class="el" href="ucol_8h.html#a467ea0dde69a6990f6ecbb7e30da6003" title="Opens a collator from a collator binary image created using ucol_cloneBinary.">ucol_openBinary()</a>.</p>
<p>File access is not used at all in the i18n library.</p>
<p>File access cannot be turned off for the icuio library or for the ICU test suites and ICU tools.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001148">Stable:</a></b></dt><dd>ICU 3.6 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00099">99</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="a5275c907e69e5e080233e6226abf0979"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_FORMATTING" ref="a5275c907e69e5e080233e6226abf0979" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_FORMATTING 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off formatting and calendar/timezone services. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001155">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00198">198</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="ab7b7ed2538ac4baf798c6d259ea031ae"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_IDNA" ref="ab7b7ed2538ac4baf798c6d259ea031ae" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_IDNA 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off IDNA. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001153">Stable:</a></b></dt><dd>ICU 2.6 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00176">176</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="acabbeca768429f4218c03052f51a18ca"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_LEGACY_CONVERSION" ref="acabbeca768429f4218c03052f51a18ca" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_LEGACY_CONVERSION 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off all converters except for</p>
<ul>
<li>Unicode charsets (UTF-7/8/16/32, CESU-8, SCSU, BOCU-1)</li>
<li>US-ASCII</li>
<li>ISO-8859-1. </li>
</ul>
</p>
<p>Turning off legacy conversion is not possible on EBCDIC platforms because they need ibm-37 or ibm-1047 default converters.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001150">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00134">134</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa2d38e601f89fb17428f51948c584c5e"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_NORMALIZATION" ref="aa2d38e601f89fb17428f51948c584c5e" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_NORMALIZATION 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off normalization. </p>
<p>It implies turning off several other services as well, for example collation and IDNA.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001151">Stable:</a></b></dt><dd>ICU 2.6 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00146">146</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="abadcf86fb2ad43ae41fd30f750cc67f5"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_REGULAR_EXPRESSIONS" ref="abadcf86fb2ad43ae41fd30f750cc67f5" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_REGULAR_EXPRESSIONS 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off regular expressions. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001157">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00218">218</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="acf867d378b4d1db31be19d6a29cc16fd"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_SERVICE" ref="acf867d378b4d1db31be19d6a29cc16fd" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_SERVICE 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off service registration. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001158">Stable:</a></b></dt><dd>ICU 3.2 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00228">228</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="a1738a54258452739e85531f850710bd0"></a><!-- doxytag: member="uconfig.h::UCONFIG_NO_TRANSLITERATION" ref="a1738a54258452739e85531f850710bd0" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_NO_TRANSLITERATION 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This switch turns off transliteration. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001156">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00208">208</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
<a class="anchor" id="ada53992bcd80e4cedcaa19627b80ebfe"></a><!-- doxytag: member="uconfig.h::UCONFIG_ONLY_COLLATION" ref="ada53992bcd80e4cedcaa19627b80ebfe" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define UCONFIG_ONLY_COLLATION 0</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>If this switch is defined, ICU will attempt to load a header file named "uconfig_local.h" prior to determining default settings for uconfig variables. </p>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000086">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. ICU 4.0</dd></dl>
<p>This switch turns off modules that are not needed for collation.</p>
<p>It does not turn off legacy conversion because that is necessary for ICU to work on EBCDIC platforms (for the default converter). If you want "only collation" and do not build for EBCDIC, then you can define UCONFIG_NO_LEGACY_CONVERSION 1 as well.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable001147">Stable:</a></b></dt><dd>ICU 2.4 </dd></dl>
<p>Definition at line <a class="el" href="uconfig_8h_source.html#l00061">61</a> of file <a class="el" href="uconfig_8h_source.html">uconfig.h</a>.</p>
</div>
</div>
</div>
<!--- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Defines</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on 16 Mar 2010 for ICU 4.4 by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
f51238514e2abe817779ad2fe01b0759
>
files
>
704
