source/samples/citer/readme.txt

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