ICU 56.1: uconfig.h File Reference

ICU 56.1 56.1

- Main Page
- Related Pages
- Modules
- Namespaces
- Data Structures
- Files

- File List
- Globals

Macros
uconfig.h File Reference

User-configurable settings. More...

Go to the source code of this file.

## Macros
#define | U_DEBUG 0
| 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. More...
#define | UCLN_NO_AUTO_CLEANUP 1
| Determines wheter to enable auto cleanup of libraries. More...
#define | U_DISABLE_RENAMING 0
| Determines whether to disable renaming or not. More...
#define | U_NO_DEFAULT_INCLUDE_UTF_HEADERS 0
| Determines whether utypes.h includes utf.h, utf8.h, utf16.h and utf_old.h. More...
#define | U_OVERRIDE_CXX_ALLOCATION 1
| Determines whether to override new and delete. More...
#define | U_ENABLE_TRACING 0
| Determines whether to enable tracing. More...
#define | U_ENABLE_DYLOAD 1
| Whether to enable Dynamic loading in ICU. More...
#define | U_CHECK_DYLOAD 1
| Whether to test Dynamic loading as an OS capability. More...
#define | U_DEFAULT_SHOW_DRAFT 1
| Do we allow ICU users to use the draft APIs by default? More...
#define | U_LIB_SUFFIX_C_NAME_STRING ""
| Defines the library suffix as a string with C syntax. More...
#define | UCONFIG_ONLY_COLLATION 0
| This switch turns off modules that are not needed for collation. More...
#define | UCONFIG_NO_FILE_IO 0
| This switch turns off all file access in the common library where file access is only used for data loading. More...
#define | UCONFIG_NO_CONVERSION 0
| ICU will not completely build with this switch turned on. More...
#define | UCONFIG_ONLY_HTML_CONVERSION 0
| This switch turns off all of the converters NOT listed in the HTML encoding standard: http://www.w3.org/TR/encoding/#names-and-labels. More...
#define | UCONFIG_NO_LEGACY_CONVERSION 0
| This switch turns off all converters except for. More...
#define | UCONFIG_NO_NORMALIZATION 0
| This switch turns off normalization. More...
#define | UCONFIG_NO_BREAK_ITERATION 0
| This switch turns off break iteration. More...
#define | UCONFIG_NO_IDNA 0
| This switch turns off IDNA. More...
#define | UCONFIG_MSGPAT_DEFAULT_APOSTROPHE_MODE UMSGPAT_APOS_DOUBLE_OPTIONAL
| Determines the default UMessagePatternApostropheMode. More...
#define | UCONFIG_NO_COLLATION 0
| This switch turns off collation and collation-based string search. More...
#define | UCONFIG_NO_FORMATTING 0
| This switch turns off formatting and calendar/timezone services. More...
#define | UCONFIG_NO_TRANSLITERATION 0
| This switch turns off transliteration. More...
#define | UCONFIG_NO_REGULAR_EXPRESSIONS 0
| This switch turns off regular expressions. More...
#define | UCONFIG_NO_SERVICE 0
| This switch turns off service registration. More...
#define | UCONFIG_HAVE_PARSEALLINPUT 1
| This switch turns on the "parse all input" attribute. More...
#define | UCONFIG_FORMAT_FASTPATHS_49 1
| This switch turns on other formatting fastpaths. More...
#define | UCONFIG_NO_FILTERED_BREAK_ITERATION 0
| This switch turns off filtered break iteration code. More...

## Detailed Description

User-configurable settings.

Miscellaneous switches:

A number of macros affect a variety of minor aspects of ICU. Most of them used to be defined elsewhere (e.g., in utypes.h or platform.h) and moved here to make them easier to find.

Switches for excluding parts of ICU library code modules:

Changing these macros allows building 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.

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.

Stable:
  ICU 2.4

Definition in file uconfig.h.

## Macro Definition Documentation

#define U_CHECK_DYLOAD 1

Whether to test Dynamic loading as an OS capability.

Internal:
  Do not use. This API is for internal use only.

Definition at line 161 of file uconfig.h.

#define U_DEBUG 0

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.

Internal:
  Do not use. This API is for internal use only. ICU 4.0

Determines whether to include debugging code. Automatically set on Windows, but most compilers do not have related predefined macros.

Internal:
  Do not use. This API is for internal use only.

Definition at line 73 of file uconfig.h.

#define U_DEFAULT_SHOW_DRAFT 1

Do we allow ICU users to use the draft APIs by default?

Internal:
  Do not use. This API is for internal use only.

Definition at line 170 of file uconfig.h.

#define U_DISABLE_RENAMING 0

Determines whether to disable renaming or not.

Internal:
  Do not use. This API is for internal use only.

Definition at line 90 of file uconfig.h.

#define U_ENABLE_DYLOAD 1

Whether to enable Dynamic loading in ICU.

Internal:
  Do not use. This API is for internal use only.

Definition at line 152 of file uconfig.h.

#define U_ENABLE_TRACING 0

Determines whether to enable tracing.

Internal:
  Do not use. This API is for internal use only.

Definition at line 134 of file uconfig.h.

#define U_LIB_SUFFIX_C_NAME_STRING ""

Defines the library suffix as a string with C syntax.

Internal:
  Do not use. This API is for internal use only.

Definition at line 199 of file uconfig.h.

#define U_NO_DEFAULT_INCLUDE_UTF_HEADERS 0

Determines whether utypes.h includes utf.h, utf8.h, utf16.h and utf_old.h.

utypes.h includes those headers if this macro is defined to 0. Otherwise, each those headers must be included explicitly when using one of their macros. Defaults to 0 for backward compatibility, except inside ICU.

Stable:
  ICU 49

Definition at line 108 of file uconfig.h.

#define U_OVERRIDE_CXX_ALLOCATION 1

Determines whether to override new and delete.

ICU is normally built such that all of its C++ classes, via their UMemory base, override operators new and delete to use its internal, customizable, non-exception-throwing memory allocation functions. (Default value 1 for this macro.)

This is especially important when the application and its libraries use multiple heaps. For example, on Windows, this allows the ICU DLL to be used by applications that statically link the C Runtime library.

Stable:
  ICU 2.2

Definition at line 125 of file uconfig.h.

#define UCLN_NO_AUTO_CLEANUP 1

Determines wheter to enable auto cleanup of libraries.

Internal:
  Do not use. This API is for internal use only.

Definition at line 81 of file uconfig.h.

#define UCONFIG_FORMAT_FASTPATHS_49 1

This switch turns on other formatting fastpaths.

Binary incompatible in object DecimalFormat and DecimalFormatSymbols

Internal:
  Do not use. This API is for internal use only.

Definition at line 437 of file uconfig.h.

#define UCONFIG_HAVE_PARSEALLINPUT 1

This switch turns on the "parse all input" attribute.

Binary incompatible.

Internal:
  Do not use. This API is for internal use only.

Definition at line 426 of file uconfig.h.

#define UCONFIG_MSGPAT_DEFAULT_APOSTROPHE_MODE UMSGPAT_APOS_DOUBLE_OPTIONAL

Determines the default UMessagePatternApostropheMode.

See the documentation for that enum.

Stable:
  ICU 4.8

Definition at line 364 of file uconfig.h.

#define UCONFIG_NO_BREAK_ITERATION 0

This switch turns off break iteration.

Stable:
  ICU 2.4

Definition at line 343 of file uconfig.h.

#define UCONFIG_NO_COLLATION 0

This switch turns off collation and collation-based string search.

Stable:
  ICU 2.4

Definition at line 376 of file uconfig.h.

#define UCONFIG_NO_CONVERSION 0

ICU will not completely build with this switch turned on.

This switch turns off all converters.

You may want to use this together with U_CHARSET_IS_UTF8 defined to 1 in utypes.h if char* strings in your environment are always in UTF-8.

Stable:
  ICU 3.2
  See also
    U_CHARSET_IS_UTF8

Definition at line 273 of file uconfig.h.

#define UCONFIG_NO_FILE_IO 0

This switch turns off all file access in the common library where file access is only used for data loading.

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 udata_setCommonData(). Application data must be provided via udata_setAppData() or by using "open" functions that take pointers to data, for example ucol_openBinary().

File access is not used at all in the i18n library.

File access cannot be turned off for the icuio library or for the ICU test suites and ICU tools.

Stable:
  ICU 3.6

Definition at line 254 of file uconfig.h.

#define UCONFIG_NO_FILTERED_BREAK_ITERATION 0

This switch turns off filtered break iteration code.

Internal:
  Do not use. This API is for internal use only.

Definition at line 447 of file uconfig.h.

#define UCONFIG_NO_FORMATTING 0

This switch turns off formatting and calendar/timezone services.

Stable:
  ICU 2.4

Definition at line 386 of file uconfig.h.

#define UCONFIG_NO_IDNA 0

This switch turns off IDNA.

Stable:
  ICU 2.6

Definition at line 353 of file uconfig.h.

#define UCONFIG_NO_LEGACY_CONVERSION 0

This switch turns off all converters except for.

- Unicode charsets (UTF-7/8/16/32, CESU-8, SCSU, BOCU-1)
- US-ASCII
- ISO-8859-1

Turning off legacy conversion is not possible on EBCDIC platforms because they need ibm-37 or ibm-1047 default converters.

Stable:
  ICU 2.4

Definition at line 308 of file uconfig.h.

#define UCONFIG_NO_NORMALIZATION 0

This switch turns off normalization.

It implies turning off several other services as well, for example collation and IDNA.

Stable:
  ICU 2.6

Definition at line 320 of file uconfig.h.

#define UCONFIG_NO_REGULAR_EXPRESSIONS 0

This switch turns off regular expressions.

Stable:
  ICU 2.4

Definition at line 406 of file uconfig.h.

#define UCONFIG_NO_SERVICE 0

This switch turns off service registration.

Stable:
  ICU 3.2

Definition at line 416 of file uconfig.h.

#define UCONFIG_NO_TRANSLITERATION 0

This switch turns off transliteration.

Stable:
  ICU 2.4

Definition at line 396 of file uconfig.h.

#define UCONFIG_ONLY_COLLATION 0

This switch turns off modules that are not needed for collation.

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_CONVERSION or UCONFIG_NO_LEGACY_CONVERSION to 1 as well.

Stable:
  ICU 2.4

Definition at line 216 of file uconfig.h.

#define UCONFIG_ONLY_HTML_CONVERSION 0

This switch turns off all of the converters NOT listed in the HTML encoding standard: http://www.w3.org/TR/encoding/#names-and-labels.

This is not possible on EBCDIC platforms because they need ibm-37 or ibm-1047 default converters.

Draft:
  This API may be changed in the future versions and was introduced in ICU 55

Definition at line 292 of file uconfig.h.