indigo. icu. ustring

Created03.05.2005
Last modified03.05.2005

These functions provide general Unicode string handling.

See the official documentation at http://icu.sourceforge.net- /apiref- /icu4c- /ustring_8h.html.

Summary
Compare two Unicode strings (binary order).
Compare two strings case-insensitively using full case folding.
Uppercase the characters in a string.
Lowercase the characters in a string.

Functions

u_strCompare()

int32_t function(UChar *s1,
int32_t length1,
UChar *s2,
int32_t length2,
UBool codePointOrder) u_strCompare

Compare two Unicode strings (binary order).  The comparison can be done in code unit order or in code point order.  They differ only in UTF-16 when comparing supplementary code points (U+10000..U+10ffff) to BMP code points near the end of the BMP (i.e., U+e000..U+ffff).  In code unit order, high BMP code points sort after supplementary code points because they are stored as pairs of surrogates which are at U+d800..U+dfff.

u_strCaseCompare()

int32_t function(UChar *s1,
int32_t length1,
UChar *s2,
int32_t length2,
uint32_t options,
UErrorCode *pErrorCode) u_strCaseCompare

Compare two strings case-insensitively using full case folding.  The comparison can be done in UTF-16 code unit order or in code point order.  They differ only when comparing supplementary code points (U+10000..U+10ffff) to BMP code points near the end of the BMP (i.e.  U+e000..U+ffff).  In code unit order, high BMP code points sort after supplementary code points because they are stored as pairs of surrogates which are at U+d800..U+dfff.

u_strToUpper()

int32_t function(UChar *dest,
int32_t destCapacity,
UChar *src,
int32_t srcLength,
char *locale,
UErrorCode *pErrorCode) u_strToUpper

Uppercase the characters in a string.  Casing is locale-dependent and context-sensitive.  The result may be longer or shorter than the original.  The source string and the destination buffer are allowed to overlap.

u_strToLower()

int32_t function(UChar *dest,
int32_t destCapacity,
UChar *src,
int32_t srcLength,
char *locale,
UErrorCode *pErrorCode) u_strToLower

Lowercase the characters in a string.  Casing is locale-dependent and context-sensitive.  The result may be longer or shorter than the original.  The source string and the destination buffer are allowed to overlap.

int32_t function(UChar *s1,
int32_t length1,
UChar *s2,
int32_t length2,
UBool codePointOrder) u_strCompare
Compare two Unicode strings (binary order).
int32_t function(UChar *s1,
int32_t length1,
UChar *s2,
int32_t length2,
uint32_t options,
UErrorCode *pErrorCode) u_strCaseCompare
Compare two strings case-insensitively using full case folding.
int32_t function(UChar *dest,
int32_t destCapacity,
UChar *src,
int32_t srcLength,
char *locale,
UErrorCode *pErrorCode) u_strToUpper
Uppercase the characters in a string.
int32_t function(UChar *dest,
int32_t destCapacity,
UChar *src,
int32_t srcLength,
char *locale,
UErrorCode *pErrorCode) u_strToLower
Lowercase the characters in a string.