=======================
UTF8String & UCS4String
=======================

This pair of classes, and they are very much a pair, just as UCS-4 and UTF-8
themselves are very much a pair, provide a mechanism for manipulating UNICODE
strings stored in either format. UTF8String is principally a conversion class,
whereas UCS4String is more of an editing class. Both insist on validated
content, so direct writing to arrays is not possible; however, both provide
handy and powerful iterators.

The source is fairly well documented, and utf8test.cpp provides examples of how
to use the classes.

If you use these classes, please report any bugs you find. Comments/Criticism
welcome.

Regards, Frank

6th May, 2002
Francis James Franklin <fjf@alinameridon.com>
=============================================

==============================
UTF8StringPair & UTF8StringMap
==============================

UTF8StringMap is a kind of hash-map or ordered vector of UTF8StringPair.

Like UTF8String & UCS4String it has a copy-on-write (COW) implementation; COW
is awkward in multi-threaded applications, but can have considerable benefits
where lots of copying is likely.

The UTF8StringPair class is *not* the same as the earlier sub-class/structure
UTF8String::UTF8StringPair used by substring_replace ().

Regards, Frank

8th August, 2002
Francis James Franklin <fjf@alinameridon.com>
=============================================
