]> git.saurik.com Git - apple/icu.git/blame - icuSources/samples/ucnv/readme.txt
ICU-461.12.tar.gz
[apple/icu.git] / icuSources / samples / ucnv / readme.txt
CommitLineData
729e4ab9 1Copyright (C) 2002-2010, International Business Machines
b75a7d8f
A
2Corporation and others. All Rights Reserved.
3
4convsamp: a sample program which demonstrates using ICU conversion
5
6This sample demonstrates
7 Opening and closing converters using the C api
8 String manipulation in C
9 Writing a custom conversion callback function
10
11
12Files:
13 convsamp.c Main source file
14 flagcb.h codepage output convenience header
15 flagcb.c codepage output convenience implementation
73c04bcf
A
16 ucnv.sln Windows MSVC workspace. Double-click this to get started.
17 ucnv.vcproj Windows MSVC project file
b75a7d8f
A
18
19To Build ucnv on Windows
20 1. Install and build ICU
73c04bcf 21 2. In MSVC, open the workspace file icu\samples\ucnv\ucnv.sln
b75a7d8f
A
22 3. Choose a Debug or Release build.
23 4. Build.
24
25To Run on Windows
26 1. Start a command shell window
27 2. Add ICU's bin directory to the path, e.g.
28 set PATH=c:\icu\bin;%PATH%
29 (Use the path to where ever ICU is on your system.)
30 3. cd into the ufortune directory, e.g.
31 cd c:\icu\source\samples\ucnv\debug
32 4. Run it
33 ucnv
729e4ab9 34 WARNING: The .bin and .txt files must be in the same directory as the executable, which is not the case by default on some systems.
b75a7d8f
A
35
36To Build on Unixes
37 1. Build ICU.
38 Specify an ICU install directory when running configure,
39 using the --prefix option. The steps to build ICU will look something
40 like this:
41 cd <icu directory>/source
42 runConfigureICU <platform-name> --prefix <icu install directory> [other options]
43 gmake all
44
45 2. Install ICU,
46 gmake install
47
48 3. Build
49 set the variable ICU_PREFIX=<icu install>
50 gmake all
51
52 To Run on Unixes
53 cd <icu directory>/source/samples/ucnv
54
55 gmake check
56 -or-
57
58 export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH
59 convsamp
60
61
62 Note: The name of the LD_LIBRARY_PATH variable is different on some systems.
63 If in doubt, run the sample using "gmake check", and note the name of
64 the variable that is used there. LD_LIBRARY_PATH is the correct name
65 for Linux and Solaris.
66