61 lines
2.2 KiB
Plaintext
61 lines
2.2 KiB
Plaintext
Note: now has error messages, see root.txt.. more submissions wanted!
|
||
For now, we're just using OS level error messages for file access
|
||
email them to: srl@jtcsv.com thanks!
|
||
-----------------------------------------
|
||
|
||
|
||
uconv
|
||
=====
|
||
|
||
uconv demonstration example of ICU and codepage conversion.
|
||
The purpose is to be a replacement tool for the UNIX iconv program, and
|
||
to show how to use the class UnicodeConverterCPP.
|
||
|
||
Compiling
|
||
=========
|
||
|
||
See the README in the parent (icuapps) directory.
|
||
|
||
Running
|
||
=======
|
||
|
||
uconv converts files from one encoding to another. Just type uconv and it
|
||
will tell you the usage. It works similar to the iconv found in UNIX98
|
||
compliant systems.
|
||
|
||
TESTING uconv
|
||
=============
|
||
|
||
In the utf8 and charset directories you can find some texts, which you can use to test uconv
|
||
with. In the charset directory you can find texts encoded in different codepages.
|
||
Not all the codepages are supported by uconv yet, i.e. no euc* are supported.
|
||
|
||
Note on running the example in Linux/UNIX (1999)
|
||
================================================
|
||
|
||
The i18n support in Linux isn't as good as it should be, so to display other
|
||
than ISO-8859-x on your console means problems. But there is much work in
|
||
progress to eliminate this. In the meantime, please have a look at the
|
||
"UTF8 and Unicode FAQ for UNIX/Linux": http://www.cl.cam.ac.uk/~mgk25/unicode.html
|
||
|
||
To be able to display Unicode characters from far-away languages
|
||
you need a suitable font. The easiest is to use Roman Czyborra's free unicode
|
||
font. The font is not beautiful, but useful for testing purposes. Have a look at:
|
||
"Proposal for GNU Unicode font" http://czyborra.com/unifont/. This is
|
||
not a TrueType font so it won't work in Windows and on Macs.
|
||
|
||
|
||
Note on TMAKE (and those strange *.pro files)
|
||
=============================================
|
||
|
||
Maybe you noticed the *.pro file. This is a source-file for the
|
||
Makefile-generator tmake, which was written by Troll Tech.
|
||
It works in both UNIX and Windows, but you need to have Perl
|
||
installed. More information can be found on
|
||
http://www.troll.no/freebies/tmake.html.
|
||
Usage: tmake uconv.pro > Makefile
|
||
|
||
Hope this will get you going with the ICU library
|
||
|
||
Jonas Utterstr<74>m <jonas.utterstrom@vittran.norrnod.se>
|