Lines Matching +full:cxx +full:- +full:test +full:- +full:suite
1 ---
6 ---
7 <!--
10 -->
16 {: .no_toc .text-delta }
21 ---
26 …International Components for Unicode (ICU) libraries provide robust and full-featured Unicode serv…
49 | ICU, ICU4C & ICU4J Homepage | <http://icu-project.org/> …
50 | FAQ - Frequently Asked Questions about ICU | <https://unicode-org.github.io/icu/userguide/icufaq/…
51 | ICU User's Guide | <https://unicode-org.github.io/icu/> …
52 | How To Use ICU | <https://unicode-org.github.io/icu/userguide/howtous…
53 | Download ICU Releases | <http://site.icu-project.org/download> …
54 | ICU4C API Documentation Online | <http://icu-project.org/apiref/icu4c/> …
55 | Online ICU Demos | <http://demo.icu-project.org/icu-bin/icudemos> …
56 | Contacts and Bug Reports/Feature Requests | <http://site.icu-project.org/contacts> …
58 …ure you understand the [Copyright and License Information](http://source.icu-project.org/repos/icu…
62 See the [ICU download page](http://site.icu-project.org/download/) to find the subpage for the curr…
66 …re](https://htmlpreview.github.io/?https://raw.githubusercontent.com/unicode-org/icu/master/icu4c/…
68 … be found on the main [ICU download page](http://site.icu-project.org/download) in its version-spe…
75 …-to-day development builds of the system, and they are packaged in zip and tar files for convenien…
76 …The packaged snapshots are named `icu-nnnn.zip` or `icu-nnnn.tgz`, where `nnnn` is the version num…
78 …> :point_right: **Note**: There may be additional commits on the `maint-*` branch for a particular…
80 …ent version of all of the files. See our [source repository](http://site.icu-project.org/repositor…
89 |-------------|----------------------------------------------------------------|
114 <td>Modules in i18n are generally the more data-driven, that is to say
115 resource bundle driven, components. These deal with higher-level
145 href="http://site.icu-project.org/repository">the ICU repository</a>.</p>
148 <li><b>in/</b> A directory that contains a pre-built data library for
161 culture-specific localization data. Two special bundles are
165 files. Some of the locale data is split out into the type-specific
204 information, region-specific data, and other data derived from CLDR
218 "https://unicode-org.github.io/icu/userguide/icudata">ICU Data
224 <td><i><ICU></i>/source/test/<b>intltest</b>/</td>
226 <td>A test suite including all C++ APIs. For information about running
227 the test suite, see the build instructions specific to your platform
232 <td><i><ICU></i>/source/test/<b>cintltst</b>/</td>
234 <td>A test suite written in C, including all C APIs. For information
235 about running the test suite, see the build instructions specific to your
240 <td><i><ICU></i>/source/test/<b>iotest</b>/</td>
242 <td>A test suite written in C and C++ to test the icuio library. For
243 information about running the test suite, see the build instructions
248 <td><i><ICU></i>/source/test/<b>testdata</b>/</td>
272 <td>Non-supported API additions. Currently, it contains the 'uconv' tool
293 <td>Contains top-level ICU workspace and project files, for instance to
327 … you have more time to update your code) revert to the default "using" via `-DU_USING_ICU_NAMESPAC…
332 --- icu4c/source/common/unicode/uversion.h (revision 40704)
334 @@ -127,7 +127,7 @@
338 -# define U_USING_ICU_NAMESPACE 0
346 You should turn this off via `-DU_USING_ICU_NAMESPACE=0` or by modifying unicode/uversion.h:
351 --- source/common/unicode/uversion.h (revision 26606)
353 @@ -180,7 +180,8 @@
357 -# define U_USING_ICU_NAMESPACE 1
366 …-8:** On platforms where the default charset is always UTF-8, like MacOS X and some Linux distribu…
367 …You can `-DU_CHARSET_IS_UTF8=1` or modify `unicode/utypes.h` (in ICU 4.8 and below) or modify unic…
372 --- source/common/unicode/utypes.h (revision 26606)
374 @@ -160,7 +160,7 @@
378 -# define U_CHARSET_IS_UTF8 0
385 * **UnicodeString constructors:** The UnicodeString class has several single-argument constructor…
387 …* Consider marking the from-`UChar` and from-`UChar32` constructors explicit via `-DUNISTR_FROM_…
388 …* Consider marking the from-`const char*` and from-`const UChar*` constructors explicit via `-DU…
389 > :point_right: **Note**: The ICU test suites cannot be compiled with these settings.
391 …Beginning with ICU 49, you should define `U_NO_DEFAULT_INCLUDE_UTF_HEADERS` to 1 (via -D or uconfi…
392 > :point_right: **Note**: The ICU test suites cannot be compiled with this setting.
394 …Beginning with ICU 60, you should define `U_HIDE_OBSOLETE_UTF_OLD_H` to 1 (via -D or uconfig.h, as…
395 > :point_right: **Note**: The ICU test suites _can_ be compiled with this setting.
396 …-time or runtime configuration, but the library is platform-specific and cannot be modified. A .da…
397 …ay be hard if ICU is shipped with another shared library (such as the Xerces-C++ XML parser) which…
398 …See the [User Guide ICU Data](https://unicode-org.github.io/icu/userguide/icudata) chapter for mor…
399 …If possible, we recommend building the .dat package. Specify `--with-data-packaging=archive` on th…
400 `runConfigureICU Linux --with-data-packaging=archive`
405 `runConfigureICU Linux --enable-static --disable-shared`
406 …-of-source build:** It is usually desirable to keep the ICU source file tree clean and have build …
408 ~/icu$ git clone https://github.com/unicode-org/icu.git
409 ~/icu$ mkdir icu4c-build
410 ~/icu$ cd icu4c-build
411 ~/icu/icu4c-build$ ../icu/icu4c/source/runConfigureICU Linux
412 ~/icu/icu4c-build$ make check</pre>
416 #### ICU as a System-Level Library
418 …-level library, there are further opportunities and restrictions to consider. For details, see the…
420 …-level library, it is best to load ICU data from the .dat package file because the file system pat…
421 …Consider also setting `-DICU_NO_USER_DATA_OVERRIDE` if you do not want the `ICU_DATA` environment …
422 …nd not yet stable. Applications must not rely on unstable APIs from a system-level library. Define…
423 * **Only C APIs:** Applications must not rely on C++ APIs from a system-level library because bin…
424 …ary entry point names have an ICU version suffix. Turn this off for a system-level installation, t…
425 `runConfigureICU Linux --disable-renaming`
428 ### User-Configurable Settings
430 ICU4C can be customized via a number of user-configurable settings. Many of them are controlled by …
432 …-configurable settings, you can either modify the `uconfig.h` header file by adding a specific `#d…
442 > :point_right: **Note**: [Cygwin](#how-to-build-and-install-on-windows-with-cygwin) is required if…
446 1. Unzip the `icu-XXXX.zip` file into any convenient location.
447 …* You can use the built-in zip functionality of Windows Explorer to do this. Right-click on the …
448 …* Alternatively, you can use a 3<sup>rd</sup> party GUI tool like 7-Zip or WinZip to do this as …
449 … select when you compile ICU. For x86 or 32-bit builds, the binary directory is `bin`. Whereas for…
450 …y ICU building tools, and the test suite projects). Please see the [command line note below](#usin…
451 …-with-other-versions-of-visual-studio) and the notes on [re-targeting the Windows 10 SDK for the U…
452 …orm note](#setting-active-platform) below) and configuration to "Debug" or "Release" (See [Windows…
453 …Debug and Release at the same time, see the [batch configuration note](#batch-configuration) below.
464 * So, for example for x86 (32-bit) and Debug, use the following:
468 For x86 (32-bit) and Release:
472 For x64 (64-bit) and Debug:
476 For x64 (64-bit) and Release:
483 …1. Run the C++ test suite, `intltest`. To do this: set the active startup project to "intltest", …
484 …2. Run the C test suite, `cintltst`. To do this: set the active startup project to "cintltst", an…
485 …3. Run the I/O test suite, `iotest`. To do this: set the active startup project to "iotest", and …
490 …-set (and thus the corresponding version of Visual Studio) that is used to compile ICU is determin…
494 In order to build the non-UWP projects with Visual Studio 2015 you will need to modify the file cal…
498 #### Re-targeting the Windows 10 SDK for the UWP projects
502 …-click on the UWP projects in the 'Solution Explorer' and select the option 'Retarget Projects' fr…
513 - To build the 32-bit Debug version, use the following command line:
517 - To build the 64-bit Release version, use the following command line:
522 - To build the 32-bit Debug version, use the following command line:
526 - To build the 64-bit Release version, use the following command line:
536 - To skip building the UWP projects with a 32-bit Debug build, use the following command line:
540 - To skip building the UWP projects with a 64-bit Release version, use the following command line:
545 …he [How To Build And Install On Windows with Cygwin](#how-to-build-and-install-on-windows-with-cyg…
578 … gcc, please follow the "[How To Build And Install On UNIX](#how-to-build-and-install-on-unix)" in…
583 …`C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\bin\vcvars32.bat` can be used for 32-bit b…
584 …ft Visual Studio 14\VC\bin\x86_amd64\vcvarsx86_amd64.bat` can be used for 64-bit builds on Windows…
585 3. Unzip the icu-XXXX.zip file into any convenient location. Using command line zip, type "unzip -…
587 …te](#setting-active-configuration) and non-functional configure options below; see source for [./r…
589 … check` to run the test suite, which checks for ICU's functionality integrity (See [testing note](…
590 …e `--prefix=` option on `configure` or `runConfigureICU`, ICU will be installed to the directory y…
596 …tory of ICU. To avoid this issue, you can download the ICU source for Unix platforms (icu-xxx.tgz).
598 In addition to the Unix [configuration note](#configuring-icu) the following configure options curr…
600 * `--disable-renaming`
601 * `--enable-tracing`
602 * `--enable-rpath`
603 * `--enable-static` (Requires that U_STATIC_IMPLEMENTATION be defined in user code that links aga…
604 * `--with-data-packaging=files` (The pkgdata tool currently does not work in this mode. Manual pa…
610 * A C++ compiler installed on the target machine (for example: gcc, CC, xlC_r, aCC, cxx, etc...).
613 * For a list of z/OS tools please view the [z/OS build section](#how-to-build-and-install-on-zos-…
617 1. Decompress the icu-_X_._Y_.tgz (or icu-_X_._Y_.tar.gz) file. For example,
619 gunzip -d < icu-_X_._Y_.tgz | tar xvf -
627 chmod +x runConfigureICU configure install-sh
629 …github.com/unicode-org/icu/blob/master/icu4c/source/runConfigureICU) script for your platform. (Se…
635 …-DU_NO_DEFAULT_INCLUDE_UTF_HEADERS=1 -D_REENTRANT -I../common -DU_ATTRIBUTE_DEPRECATED= -O2 -Wall …
641 …will run the test suite, which checks for ICU's functionality integrity (See [testing note](#runni…
646 …e `--prefix=` option on `configure` or `runConfigureICU`, ICU will be installed to the directory y…
650 …--help"` for help on how to run it and a list of supported platforms. You may also want to type `"…
652 …f this causes excessive numbers of warnings on your platform, use the `--disable-strict` option to…
656 You may have to set certain variables if you with to run test programs individually, that is apart …
666 …y installed on your system, it is available at the [z/OS UNIX - Tools and Toys](http://www-03.ibm.…
668 …-1047 (to be exact, the UNIX System Services variant of it). The pax command converts all of the s…
670 …-intensive C and C++ applications such as ICU. XPLINK is enabled on a DLL-by-DLL basis, so if you …
671 … you want to use the rest of ICU without XPLINK, then you must use the --disable-icuio configure o…
684 …ices are the same as the [How To Build And Install On UNIX](#how-to-build-and-install-on-unix) sec…
690 The OS390BATCH environment variable enables non-UNIX support including the batch environment. When …
707 IXMI_XX_IN --> libicui18n_XX_.dll
708 IXMI_XX_UC --> libicuuc_XX_.dll
709 IXMI_XX_DA --> libicudt_XX_e.dll
754 …opers for IBM i — [https://www-356.ibm.com/partnerworld/wps/servlet/ContentHandler/pw_com_porting_…
756 …d information, you should look at the [UNIX build instructions](#how-to-build-and-install-on-unix).
758 …nt, as binary. Also, copy the [unpax-icu.sh](https://github.com/unicode-org/icu/blob/master/icu4c/…
779 gzip -d icu-_X_._Y_.tgz
781 7. Run unpax-icu.sh on the tar file generated from the previous step.
783 unpax-icu.sh icu.tar
791 …n note](#HowToConfigureICU) for details). Note that --with-data-packaging=archive and setting the …
794 ./runConfigureICU IBMi --prefix=_/path/to/somewhere_ --with-data-packaging=archive
797 > :point_right: **Note**: Do not use the -j option
801 11. Test ICU.
805 (The `QIBM_MULTI_THREADED=Y` flag will be automatically applied to intltest - you can look at the […
811 …test-data. In a cross compilation setting, ICU is built on a different system from that which it …
813 …" and the "B" system. System "A" is the actual system we will be running on - the only requirement…
815 …anual/html_node/Specifying-Names.html](http://www.gnu.org/software/autoconf/manual/html_node/Speci…
817 Three initially-empty directories will be used in this example:
834 sh /icu/source/configure --host=i586-pc-haiku--with-cross-build=/buildA
837 > :point_right: **Note**: `--with-cross-build` takes an absolute path.
844 …be created relative to the `--prefix=`dir" configure option (See the [UNIX build instructions](#ho…
848 1. Add a suffix name to the library names. This can be done with the `--with-library-suffix` confi…
851 …tails on customizing ICU are available in the [User's Guide](https://unicode-org.github.io/icu/use…
856 …-------------------------------------|------------------|------------------------|----------------…
857 …es. There are many ways to package and [customize this data](https://unicode-org.github.io/icu/use…
871 …threads. There is no harm in calling `u_init()` in a single-threaded application, on a single-CPU …
879 ICU 3.4 self-initializes properly for multi-threaded use. It achieves this without performance pena…
885 These ICU versions require a call to `u_init()` before multi-threaded use. The services that are di…
891 ICU 2.4 and earlier versions were not prepared for multithreaded use on multi-CPU platforms where t…
893 #### Using ICU in a Multithreaded Environment on HP-UX
895 …-UX, the [`-AA`](http://h21007.www2.hp.com/portal/site/dspp/menuitem.863c3e4cbcdc3f3515b49c108973a…
903 > To use libthread, specify `-lthread` before `-lc` on the ld command line, or last on the cc comma…
905 > To use libpthread, specify `-lpthread` before `-lc` on the ld command line, or last on the cc com…
910 …ps://docs.oracle.com/cd/E19683-01/806-6867/compile-74765/index.html](https://docs.oracle.com/cd/E1…
913 …tp://docs.oracle.com/cd/E19253-01/816-5137/compile-94179/index.html](http://docs.oracle.com/cd/E19…
933 If you are building on a UNIX platform, and if you are installing ICU in a non-standard location, y…
935 … you do not want to have to set this variable, you may instead use the `--enable-rpath` option at …
941 …-support mailing list](http://site.icu-project.org/contacts). Once you have finished porting ICU t…
947 …/static libraries. For details see the User Guide [ICU Data](https://unicode-org.github.io/icu/use…
951 …ICU is safe to use. It is recommended that you try to completely port and test ICU before using th…
955 Try to follow the build steps from the [UNIX](#how-to-build-and-install-on-unix) build instructions…
957 1. Create an mh file in `<ICU>/source/config/`. You can use mh-linux or a similar mh file as your …
962 6. Build and test ICU on your platform. It is very important that you run the tests. If you don't …
969 … **unicode/p_XXXX_.h** (others: pwin32.h, ppalmos.h, ..): Platform-dependent typedefs and defines:
973 * **unicode/putil.h, putil.c**: platform-dependent implementations of various functions that are …
986 Copyright © 1997-2016 International Business Machines Corporation and others. All Rights Reserved.