uconfig.h File Reference

Switches for excluding parts of ICU library code modules. More...

Go to the source code of this file.

Defines

#define UCONFIG_ONLY_COLLATION   0
 This switch turns off modules that are not needed for collation.
#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.
#define UCONFIG_NO_CONVERSION   0
 ICU will not completely build with this switch turned on.
#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.

#define UCONFIG_NO_NORMALIZATION   0
 This switch turns off normalization.
#define UCONFIG_NO_BREAK_ITERATION   0
 This switch turns off break iteration.
#define UCONFIG_NO_IDNA   0
 This switch turns off IDNA.
#define UCONFIG_NO_COLLATION   0
 This switch turns off collation and collation-based string search.
#define UCONFIG_NO_FORMATTING   0
 This switch turns off formatting and calendar/timezone services.
#define UCONFIG_NO_TRANSLITERATION   0
 This switch turns off transliteration.
#define UCONFIG_NO_REGULAR_EXPRESSIONS   0
 This switch turns off regular expressions.
#define UCONFIG_NO_SERVICE   0
 This switch turns off service registration.


Detailed Description

Switches for excluding parts of ICU library code modules.

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.

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.


Define Documentation

#define UCONFIG_NO_BREAK_ITERATION   0

This switch turns off break iteration.

Stable:
ICU 2.4

Definition at line 150 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 172 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.

Stable:
ICU 3.2

Definition at line 98 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.

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

Definition at line 87 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 182 of file uconfig.h.

#define UCONFIG_NO_IDNA   0

This switch turns off IDNA.

Stable:
ICU 2.6

Definition at line 160 of file uconfig.h.

#define UCONFIG_NO_LEGACY_CONVERSION   0

This switch turns off all converters except for

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 118 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 130 of file uconfig.h.

#define UCONFIG_NO_REGULAR_EXPRESSIONS   0

This switch turns off regular expressions.

Stable:
ICU 2.4

Definition at line 202 of file uconfig.h.

#define UCONFIG_NO_SERVICE   0

This switch turns off service registration.

Stable:
ICU 3.2

Definition at line 212 of file uconfig.h.

#define UCONFIG_NO_TRANSLITERATION   0

This switch turns off transliteration.

Stable:
ICU 2.4

Definition at line 192 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_LEGACY_CONVERSION 1 as well.

Stable:
ICU 2.4

Definition at line 49 of file uconfig.h.


Generated on Mon Aug 13 07:17:26 2007 for ICU 3.6 by  doxygen 1.5.2