intl/icu/source/common/unicode/uconfig.h@6474c204b198
intl/icu/source/common/unicode/uconfig.h
Wed, 31 Dec 2014 06:09:35 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Wed, 31 Dec 2014 06:09:35 +0100
- changeset 0
- 6474c204b198
- permissions
- -rw-r--r--
Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.
1 /*
2 **********************************************************************
3 * Copyright (C) 2002-2013, International Business Machines
4 * Corporation and others. All Rights Reserved.
5 **********************************************************************
6 * file name: uconfig.h
7 * encoding: US-ASCII
8 * tab size: 8 (not used)
9 * indentation:4
10 *
11 * created on: 2002sep19
12 * created by: Markus W. Scherer
13 */
15 #ifndef __UCONFIG_H__
16 #define __UCONFIG_H__
19 /*!
20 * \file
21 * \brief User-configurable settings
22 *
23 * Miscellaneous switches:
24 *
25 * A number of macros affect a variety of minor aspects of ICU.
26 * Most of them used to be defined elsewhere (e.g., in utypes.h or platform.h)
27 * and moved here to make them easier to find.
28 *
29 * Switches for excluding parts of ICU library code modules:
30 *
31 * Changing these macros allows building partial, smaller libraries for special purposes.
32 * By default, all modules are built.
33 * The switches are fairly coarse, controlling large modules.
34 * Basic services cannot be turned off.
35 *
36 * Building with any of these options does not guarantee that the
37 * ICU build process will completely work. It is recommended that
38 * the ICU libraries and data be built using the normal build.
39 * At that time you should remove the data used by those services.
40 * After building the ICU data library, you should rebuild the ICU
41 * libraries with these switches customized to your needs.
42 *
43 * @stable ICU 2.4
44 */
46 /**
47 * If this switch is defined, ICU will attempt to load a header file named "uconfig_local.h"
48 * prior to determining default settings for uconfig variables.
49 *
50 * @internal ICU 4.0
51 */
52 #if defined(UCONFIG_USE_LOCAL)
53 #include "uconfig_local.h"
54 #endif
56 /**
57 * \def U_DEBUG
58 * Determines whether to include debugging code.
59 * Automatically set on Windows, but most compilers do not have
60 * related predefined macros.
61 * @internal
62 */
63 #ifdef U_DEBUG
64 /* Use the predefined value. */
65 #elif defined(_DEBUG)
66 /*
67 * _DEBUG is defined by Visual Studio debug compilation.
68 * Do *not* test for its NDEBUG macro: It is an orthogonal macro
69 * which disables assert().
70 */
71 # define U_DEBUG 1
72 # else
73 # define U_DEBUG 0
74 #endif
76 /**
77 * Determines wheter to enable auto cleanup of libraries.
78 * @internal
79 */
80 #ifndef UCLN_NO_AUTO_CLEANUP
81 #define UCLN_NO_AUTO_CLEANUP 1
82 #endif
84 /**
85 * \def U_DISABLE_RENAMING
86 * Determines whether to disable renaming or not.
87 * @internal
88 */
89 #ifndef U_DISABLE_RENAMING
90 #define U_DISABLE_RENAMING 0
91 #endif
93 /**
94 * \def U_NO_DEFAULT_INCLUDE_UTF_HEADERS
95 * Determines whether utypes.h includes utf.h, utf8.h, utf16.h and utf_old.h.
96 * utypes.h includes those headers if this macro is defined to 0.
97 * Otherwise, each those headers must be included explicitly when using one of their macros.
98 * Defaults to 0 for backward compatibility, except inside ICU.
99 * @stable ICU 49
100 */
101 #ifdef U_NO_DEFAULT_INCLUDE_UTF_HEADERS
102 /* Use the predefined value. */
103 #elif defined(U_COMBINED_IMPLEMENTATION) || defined(U_COMMON_IMPLEMENTATION) || defined(U_I18N_IMPLEMENTATION) || \
104 defined(U_IO_IMPLEMENTATION) || defined(U_LAYOUT_IMPLEMENTATION) || defined(U_LAYOUTEX_IMPLEMENTATION) || \
105 defined(U_TOOLUTIL_IMPLEMENTATION)
106 # define U_NO_DEFAULT_INCLUDE_UTF_HEADERS 1
107 #else
108 # define U_NO_DEFAULT_INCLUDE_UTF_HEADERS 0
109 #endif
111 /**
112 * \def U_OVERRIDE_CXX_ALLOCATION
113 * Determines whether to override new and delete.
114 * ICU is normally built such that all of its C++ classes, via their UMemory base,
115 * override operators new and delete to use its internal, customizable,
116 * non-exception-throwing memory allocation functions. (Default value 1 for this macro.)
117 *
118 * This is especially important when the application and its libraries use multiple heaps.
119 * For example, on Windows, this allows the ICU DLL to be used by
120 * applications that statically link the C Runtime library.
121 *
122 * @stable ICU 2.2
123 */
124 #ifndef U_OVERRIDE_CXX_ALLOCATION
125 #define U_OVERRIDE_CXX_ALLOCATION 1
126 #endif
128 /**
129 * \def U_ENABLE_TRACING
130 * Determines whether to enable tracing.
131 * @internal
132 */
133 #ifndef U_ENABLE_TRACING
134 #define U_ENABLE_TRACING 0
135 #endif
137 /**
138 * \def U_ENABLE_DYLOAD
139 * Whether to enable Dynamic loading in ICU.
140 * @internal
141 */
142 #ifndef U_ENABLE_DYLOAD
143 #define U_ENABLE_DYLOAD 1
144 #endif
146 /**
147 * \def U_CHECK_DYLOAD
148 * Whether to test Dynamic loading as an OS capability.
149 * @internal
150 */
151 #ifndef U_CHECK_DYLOAD
152 #define U_CHECK_DYLOAD 1
153 #endif
156 /**
157 * \def U_DEFAULT_SHOW_DRAFT
158 * Do we allow ICU users to use the draft APIs by default?
159 * @internal
160 */
161 #ifndef U_DEFAULT_SHOW_DRAFT
162 #define U_DEFAULT_SHOW_DRAFT 1
163 #endif
165 /*===========================================================================*/
166 /* Custom icu entry point renaming */
167 /*===========================================================================*/
169 /**
170 * \def U_HAVE_LIB_SUFFIX
171 * 1 if a custom library suffix is set.
172 * @internal
173 */
174 #ifdef U_HAVE_LIB_SUFFIX
175 /* Use the predefined value. */
176 #elif defined(U_LIB_SUFFIX_C_NAME)
177 # define U_HAVE_LIB_SUFFIX 1
178 #endif
180 /**
181 * \def U_LIB_SUFFIX_C_NAME_STRING
182 * Defines the library suffix as a string with C syntax.
183 * @internal
184 */
185 #ifdef U_LIB_SUFFIX_C_NAME_STRING
186 /* Use the predefined value. */
187 #elif defined(U_LIB_SUFFIX_C_NAME)
188 # define U_LIB_SUFFIX_C_NAME_STRING #U_LIB_SUFFIX_C_NAME
189 #else
190 # define U_LIB_SUFFIX_C_NAME_STRING ""
191 #endif
193 /* common/i18n library switches --------------------------------------------- */
195 /**
196 * \def UCONFIG_ONLY_COLLATION
197 * This switch turns off modules that are not needed for collation.
198 *
199 * It does not turn off legacy conversion because that is necessary
200 * for ICU to work on EBCDIC platforms (for the default converter).
201 * If you want "only collation" and do not build for EBCDIC,
202 * then you can define UCONFIG_NO_LEGACY_CONVERSION 1 as well.
203 *
204 * @stable ICU 2.4
205 */
206 #ifndef UCONFIG_ONLY_COLLATION
207 # define UCONFIG_ONLY_COLLATION 0
208 #endif
210 #if UCONFIG_ONLY_COLLATION
211 /* common library */
212 # define UCONFIG_NO_BREAK_ITERATION 1
213 # define UCONFIG_NO_IDNA 1
215 /* i18n library */
216 # if UCONFIG_NO_COLLATION
217 # error Contradictory collation switches in uconfig.h.
218 # endif
219 # define UCONFIG_NO_FORMATTING 1
220 # define UCONFIG_NO_TRANSLITERATION 1
221 # define UCONFIG_NO_REGULAR_EXPRESSIONS 1
222 #endif
224 /* common library switches -------------------------------------------------- */
226 /**
227 * \def UCONFIG_NO_FILE_IO
228 * This switch turns off all file access in the common library
229 * where file access is only used for data loading.
230 * ICU data must then be provided in the form of a data DLL (or with an
231 * equivalent way to link to the data residing in an executable,
232 * as in building a combined library with both the common library's code and
233 * the data), or via udata_setCommonData().
234 * Application data must be provided via udata_setAppData() or by using
235 * "open" functions that take pointers to data, for example ucol_openBinary().
236 *
237 * File access is not used at all in the i18n library.
238 *
239 * File access cannot be turned off for the icuio library or for the ICU
240 * test suites and ICU tools.
241 *
242 * @stable ICU 3.6
243 */
244 #ifndef UCONFIG_NO_FILE_IO
245 # define UCONFIG_NO_FILE_IO 0
246 #endif
248 /**
249 * \def UCONFIG_NO_CONVERSION
250 * ICU will not completely build with this switch turned on.
251 * This switch turns off all converters.
252 *
253 * You may want to use this together with U_CHARSET_IS_UTF8 defined to 1
254 * in utypes.h if char* strings in your environment are always in UTF-8.
255 *
256 * @stable ICU 3.2
257 * @see U_CHARSET_IS_UTF8
258 */
259 #ifndef UCONFIG_NO_CONVERSION
260 # define UCONFIG_NO_CONVERSION 0
261 #endif
263 #if UCONFIG_NO_CONVERSION
264 # define UCONFIG_NO_LEGACY_CONVERSION 1
265 #endif
267 /**
268 * \def UCONFIG_NO_LEGACY_CONVERSION
269 * This switch turns off all converters except for
270 * - Unicode charsets (UTF-7/8/16/32, CESU-8, SCSU, BOCU-1)
271 * - US-ASCII
272 * - ISO-8859-1
273 *
274 * Turning off legacy conversion is not possible on EBCDIC platforms
275 * because they need ibm-37 or ibm-1047 default converters.
276 *
277 * @stable ICU 2.4
278 */
279 #ifndef UCONFIG_NO_LEGACY_CONVERSION
280 # define UCONFIG_NO_LEGACY_CONVERSION 0
281 #endif
283 /**
284 * \def UCONFIG_NO_NORMALIZATION
285 * This switch turns off normalization.
286 * It implies turning off several other services as well, for example
287 * collation and IDNA.
288 *
289 * @stable ICU 2.6
290 */
291 #ifndef UCONFIG_NO_NORMALIZATION
292 # define UCONFIG_NO_NORMALIZATION 0
293 #elif UCONFIG_NO_NORMALIZATION
294 /* common library */
295 /* ICU 50 CJK dictionary BreakIterator uses normalization */
296 # define UCONFIG_NO_BREAK_ITERATION 1
297 /* IDNA (UTS #46) is implemented via normalization */
298 # define UCONFIG_NO_IDNA 1
300 /* i18n library */
301 # if UCONFIG_ONLY_COLLATION
302 # error Contradictory collation switches in uconfig.h.
303 # endif
304 # define UCONFIG_NO_COLLATION 1
305 # define UCONFIG_NO_TRANSLITERATION 1
306 #endif
308 /**
309 * \def UCONFIG_NO_BREAK_ITERATION
310 * This switch turns off break iteration.
311 *
312 * @stable ICU 2.4
313 */
314 #ifndef UCONFIG_NO_BREAK_ITERATION
315 # define UCONFIG_NO_BREAK_ITERATION 0
316 #endif
318 /**
319 * \def UCONFIG_NO_IDNA
320 * This switch turns off IDNA.
321 *
322 * @stable ICU 2.6
323 */
324 #ifndef UCONFIG_NO_IDNA
325 # define UCONFIG_NO_IDNA 0
326 #endif
328 /**
329 * \def UCONFIG_MSGPAT_DEFAULT_APOSTROPHE_MODE
330 * Determines the default UMessagePatternApostropheMode.
331 * See the documentation for that enum.
332 *
333 * @stable ICU 4.8
334 */
335 #ifndef UCONFIG_MSGPAT_DEFAULT_APOSTROPHE_MODE
336 # define UCONFIG_MSGPAT_DEFAULT_APOSTROPHE_MODE UMSGPAT_APOS_DOUBLE_OPTIONAL
337 #endif
339 /* i18n library switches ---------------------------------------------------- */
341 /**
342 * \def UCONFIG_NO_COLLATION
343 * This switch turns off collation and collation-based string search.
344 *
345 * @stable ICU 2.4
346 */
347 #ifndef UCONFIG_NO_COLLATION
348 # define UCONFIG_NO_COLLATION 0
349 #endif
351 /**
352 * \def UCONFIG_NO_FORMATTING
353 * This switch turns off formatting and calendar/timezone services.
354 *
355 * @stable ICU 2.4
356 */
357 #ifndef UCONFIG_NO_FORMATTING
358 # define UCONFIG_NO_FORMATTING 0
359 #endif
361 /**
362 * \def UCONFIG_NO_TRANSLITERATION
363 * This switch turns off transliteration.
364 *
365 * @stable ICU 2.4
366 */
367 #ifndef UCONFIG_NO_TRANSLITERATION
368 # define UCONFIG_NO_TRANSLITERATION 0
369 #endif
371 /**
372 * \def UCONFIG_NO_REGULAR_EXPRESSIONS
373 * This switch turns off regular expressions.
374 *
375 * @stable ICU 2.4
376 */
377 #ifndef UCONFIG_NO_REGULAR_EXPRESSIONS
378 # define UCONFIG_NO_REGULAR_EXPRESSIONS 0
379 #endif
381 /**
382 * \def UCONFIG_NO_SERVICE
383 * This switch turns off service registration.
384 *
385 * @stable ICU 3.2
386 */
387 #ifndef UCONFIG_NO_SERVICE
388 # define UCONFIG_NO_SERVICE 0
389 #endif
391 /**
392 * \def UCONFIG_HAVE_PARSEALLINPUT
393 * This switch turns on the "parse all input" attribute. Binary incompatible.
394 *
395 * @internal
396 */
397 #ifndef UCONFIG_HAVE_PARSEALLINPUT
398 # define UCONFIG_HAVE_PARSEALLINPUT 1
399 #endif
402 /**
403 * \def UCONFIG_FORMAT_FASTPATHS_49
404 * This switch turns on other formatting fastpaths. Binary incompatible in object DecimalFormat and DecimalFormatSymbols
405 *
406 * @internal
407 */
408 #ifndef UCONFIG_FORMAT_FASTPATHS_49
409 # define UCONFIG_FORMAT_FASTPATHS_49 1
410 #endif
412 #endif
