1## Copyright (c) 2002-2010, International Business Machines Corporation 
2## and others. All Rights Reserved.
3
4This directory contains sample code
5Below is a short description of the contents of this directory.
6
7break - demonstrates how to use BreakIterators in C and C++.
8
9cal      - prints out a calendar. 
10
11case    - demonstrates how to do Unicode case conversion in C and C++.
12
13csdet   -  demonstrates using ICU's CharSet Detection API
14
15date     - prints out the current date, localized. 
16
17datefmt  - an exercise using the date formatting API
18
19layout   - demonstrates the ICU LayoutEngine
20
21legacy   - demonstrates using two versions of ICU in one application
22
23msgfmt   - demonstrates the use of the Message Format
24
25numfmt   - demonstrates the use of the number format
26
27props    - demonstrates the use of Unicode properties
28
29strsrch - demonstrates how to search for patterns in Unicode text using the usearch interface.
30
31translit - demonstrates the use of ICU transliteration
32
33uciter8.c - demonstrates how to leniently read 8-bit Unicode text.
34
35ucnv     - demonstrates the use of ICU codepage conversion
36
37udata    - demonstrates the use of ICU low level data routines (reader/writer in 'all' MSVC solution)
38
39ufortune - demonstrates packaging and use of resources in an application
40
41ugrep  - demonstrates ICU Regular Expressions. 
42
43uresb    - demonstrates building and loading resource bundles
44
45ustring  - demonstrates ICU string manipulation functions
46
47
48==
49* Where can I find more sample code?
50
51 - The "uconv" utility is a full-featured command line application.
52    It is normally built with ICU, and is located in icu/source/extra/uconv
53
54 - The "icuapps" CVS module contains other applications and libraries not
55    included with ICU.  You can check it out from the CVS command line
56    by using for example,  "cvs co icuapps" instead of "cvs co icu",
57   or through WebCVS at http://dev.icu-project.org/cgi-bin/viewcvs.cgi/icuapps/
58
59==
60* How do I build the samples?
61
62 - See the Readme in each subdirectory
63
64 To build all samples at once:
65
66    Windows MSVC:   
67            - build ICU
68	    - open 'all' project file in 'all' subdirectory
69            - build project
70            - sample executables will be located in /x86/Debug folders of each sample subdirectory
71
72    Unix:   - build and install (make install) ICU
73            - be sure 'icu-config' is accessible from the PATH
74            - type 'make all-samples' from this directory 
75               (other targets:  clean-samples, check-samples)
76           Note: 'make all-samples' won't work correctly in out of source builds.
77
78            - legacy and layout are not included in these lists,
79                   please see their individual readmes.
80