1Copyright (c) 2002-2010, International Business Machines Corporation and others. All Rights Reserved.
2udata: Low level ICU data
3
4This sample demonstrates
5    Using the low level ICU data handling interfaces (udata) to create
6 and later access user data.
7
8Files:
9    writer.c       C source for Writer application, will generate data file to be read by Reader.
10    reader.c       C source for Reader application, will read file created by Writer
11    udata.sln      Windows MSVC workspace.  Double-click this to get started.
12    udata.vcproj   Windows MSVC project file
13
14To Build udata on Windows
15    1.  Install and build ICU
16    2.  In MSVC, open the workspace file icu\samples\udata\udata.sln
17    3.  Choose a Debug or Release build.
18    4.  Build.
19
20To Run on Windows
21    1.  Start a command shell window
22    2.  Add ICU's bin directory to the path, e.g.
23            set PATH=c:\icu\bin;%PATH%
24        (Use the path to where ever ICU is on your system.)
25    3.  cd into the udata directory, e.g.
26            cd c:\icu\source\samples\udata\debug
27    4.  Run it
28            writer
29            reader
30    IMPORTANT: On some systems, the reader and writer executables may not be in the same directory.  If this is the case, this will likely cause a problem with reader looking for the .dat file in the wrong directory).
31
32To Build on Unixes
33    1.  Build ICU.
34        Specify an ICU install directory when running configure,
35        using the --prefix option.  The steps to build ICU will look something
36        like this:
37           cd <icu directory>/source
38           runConfigureICU <platform-name> --prefix <icu install directory> [other options]
39           gmake all
40
41    2.  Install ICU,
42           gmake install
43
44    3.  Compile
45           You will need to set ICU_PATH to the location of your ICU source tree, for example ICU_PATH=/home/srl/icu   (containing source, etc.)
46           cd <icu directory>/source/samples/udata
47           gmake ICU_PATH=<icu source directory> ICU_PREFIX=<icu install directory)
48
49 To Run on Unixes
50           cd <icu directory>/source/samples/udata
51           gmake ICU_PREFIX=<icu install directory>  check
52               -or-
53
54           export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH
55           writer
56           reader
57
58 Note:  The name of the LD_LIBRARY_PATH variable is different on some systems.
59        If in doubt, run the sample using "gmake check", and note the name of
60        the variable that is used there.  LD_LIBRARY_PATH is the correct name
61        for Linux and Solaris.
62
63