| ## Copyright (C) 2016 and later: Unicode, Inc. and others. |
| ## License & terms of use: http://www.unicode.org/copyright.html |
| ## |
| ## Copyright (c) 2002-2010, International Business Machines Corporation |
| ## and others. All Rights Reserved. |
| |
| This directory contains sample code using ICU4C routines. Below is a |
| short description of the contents of this directory. |
| |
| break - demonstrates how to use BreakIterators in C and C++. |
| |
| cal - prints out a calendar. |
| |
| case - demonstrates how to do Unicode case conversion in C and C++. |
| |
| coll - shows how collation compares strings |
| |
| csdet - demonstrates using ICU's CharSet Detection API |
| |
| date - prints out the current date, localized. |
| |
| datecal - demonstrates how a calendar object provides information |
| |
| datefmt - an exercise using the date formatting API |
| |
| dtitvfmtsample - shows how date interval format uses predefined skeletons |
| |
| dtptngsample - uses DateTimePatternGenerator to create customized date/time pattern |
| |
| layout - demonstrates the ICU LayoutEngine (obsolete) |
| |
| legacy - demonstrates using two versions of ICU in one application (obsolete) |
| |
| msgfmt - demonstrates the use of the Message Format |
| |
| numfmt - demonstrates the use of the number format |
| |
| plurfmtsample - uses PluralFormat and Messageformat to get Plural Form |
| |
| props - demonstrates the use of Unicode properties |
| |
| strsrch - demonstrates how to search for patterns in Unicode text using the usearch interface. |
| |
| translit - demonstrates the use of ICU transliteration |
| |
| uciter8 - demonstrates how to leniently read 8-bit Unicode text. |
| |
| ucnv - demonstrates the use of ICU codepage conversion |
| |
| udata - demonstrates the use of ICU low level data routines (reader/writer in 'all' MSVC solution) |
| |
| ufortune - demonstrates packaging and use of resources in an application |
| |
| ugrep - demonstrates ICU Regular Expressions. |
| |
| uresb - demonstrates building and loading resource bundles |
| |
| ustring - demonstrates ICU string manipulation functions |
| |
| |
| == |
| * Where can I find more sample code? |
| |
| - The "uconv" utility is a full-featured command line application. |
| It is normally built with ICU, and is located in icu/source/extra/uconv |
| |
| - The "icu-demos" contains other applications and libraries not |
| included with ICU. You can check it out from https://github.com/unicode-org/icu-demos |
| using github clone. See the README file for additional information. |
| |
| == |
| * How do I build the samples? |
| |
| - See the Readme in each subdirectory |
| |
| To build all samples at once: |
| |
| Windows MSVC: |
| - build ICU |
| - open 'all' project file in 'all' subdirectory |
| - build project |
| - sample executables will be located in /x86/Debug folders of each sample subdirectory |
| |
| Unix: - build and install (make install) ICU |
| - be sure 'icu-config' is accessible from the PATH |
| - type 'make all-samples' from this directory |
| (other targets: clean-samples, check-samples) |
| Note: 'make all-samples' won't work correctly in out of source builds. |
| |
| Note that legacy and layout are obsolete samples that may not compile or run without |
| adjustments to their makefiles. |