Home | History | Annotate | Download | only in samples
      1 ## Copyright (c) 2002-2010, International Business Machines Corporation 
      2 ## and others. All Rights Reserved.
      3 
      4 This directory contains sample code
      5 Below is a short description of the contents of this directory.
      6 
      7 break - demonstrates how to use BreakIterators in C and C++.
      8 
      9 cal      - prints out a calendar. 
     10 
     11 case    - demonstrates how to do Unicode case conversion in C and C++.
     12 
     13 csdet   -  demonstrates using ICU's CharSet Detection API
     14 
     15 date     - prints out the current date, localized. 
     16 
     17 datefmt  - an exercise using the date formatting API
     18 
     19 layout   - demonstrates the ICU LayoutEngine
     20 
     21 legacy   - demonstrates using two versions of ICU in one application
     22 
     23 msgfmt   - demonstrates the use of the Message Format
     24 
     25 numfmt   - demonstrates the use of the number format
     26 
     27 props    - demonstrates the use of Unicode properties
     28 
     29 strsrch - demonstrates how to search for patterns in Unicode text using the usearch interface.
     30 
     31 translit - demonstrates the use of ICU transliteration
     32 
     33 uciter8.c - demonstrates how to leniently read 8-bit Unicode text.
     34 
     35 ucnv     - demonstrates the use of ICU codepage conversion
     36 
     37 udata    - demonstrates the use of ICU low level data routines (reader/writer in 'all' MSVC solution)
     38 
     39 ufortune - demonstrates packaging and use of resources in an application
     40 
     41 ugrep  - demonstrates ICU Regular Expressions. 
     42 
     43 uresb    - demonstrates building and loading resource bundles
     44 
     45 ustring  - 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