1Copyright (c) 2003-2010, International Business Machines Corporation and others. All Rights Reserved.
2citer: Character Iteration
3
4This sample demonstrates
5         Demonstrating ICU's CharacterIterator
6
7
8Files:
9    citer.cpp      Main source file in C++
10    citer.sln      Windows MSVC workspace.  Double-click this to get started.
11    citer.vcproj   Windows MSVC project file
12
13To Build citer on Windows
14    1.  Install and build ICU
15    2.  In MSVC, open the workspace file icu\samples\citer\citer.sln
16    3.  Choose a Debug or Release build.
17    4.  Build.
18
19To Run on Windows
20    1.  Start a command shell window
21    2.  Add ICU's bin directory to the path, e.g.
22            set PATH=c:\icu\bin;%PATH%
23        (Use the path to where ever ICU is on your system.)
24    3.  cd into the citer directory, e.g.
25            cd c:\icu\source\samples\citer\debug
26            (note that it may be in a different relative directory than most of the other samples).
27    4.  Run it
28            citer
29
30To Build on Unixes
31    1.  Build ICU.
32        Specify an ICU install directory when running configure,
33        using the --prefix option.  The steps to build ICU will look something
34        like this:
35           cd <icu directory>/source
36           runConfigureICU <platform-name> --prefix <icu install directory> [other options]
37           gmake all
38
39    2.  Install ICU,
40           gmake install
41
42    3.  Compile
43           cd <icu directory>/source/samples/citer
44           gmake ICU_PREFIX=<icu install directory)
45
46 To Run on Unixes
47           cd <icu directory>/source/samples/citer
48
49           gmake ICU_PREFIX=<icu install directory>  check
50               -or-
51
52           export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH
53           citer
54
55
56 Note:  The name of the LD_LIBRARY_PATH variable is different on some systems.
57        If in doubt, run the sample using "gmake check", and note the name of
58        the variable that is used there.  LD_LIBRARY_PATH is the correct name
59        for Linux and Solaris.
60
61