Unicode Functions


Defines

#define ENCODING_ASCII   ENCODING_ISO2022
#define ENCODING_ISO2022   0
#define ENCODING_Unicode   -1
#define GLYPHSUB_AllowCircleForms   0x00000200
#define GLYPHSUB_AllowCompatForms   0x00000004
#define GLYPHSUB_AllowFontForms   0x00000400
#define GLYPHSUB_AllowFractionForms   0x00000010
#define GLYPHSUB_AllowNarrowForms   0x00000002
#define GLYPHSUB_AllowNoBreakForms   0x00000800
#define GLYPHSUB_AllowPositionalForms   0x00000008
#define GLYPHSUB_AllowSmallForms   0x00000080
#define GLYPHSUB_AllowSquareForms   0x00000100
#define GLYPHSUB_AllowSubscriptForms   0x00000020
#define GLYPHSUB_AllowSuperscriptForms   0x00000040
#define GLYPHSUB_AllowVerticalForms   0x00001000
#define GLYPHSUB_AllowWideForms   0x00000001
#define MUC_THAI_OF   1
#define MUC_THAI_TTF   2
#define MUCEVENT_ComposeOff   0x02
#define MUCEVENT_ComposeOn   0x01
#define MUCEVENT_ComposeToggle   (MUCEVENT_ComposeOn|MUCEVENT_ComposeOff)

Functions

LIBEXPORT int MucCharsetToUnicode (int val, int charset)
LIBEXPORT int MucCharsetToUnicodeBuf (MIUNICODE *buf, int charset)
LIBEXPORT int MucConvertFromISO2022 (void *vcd, const void *vinbuf, char **outbuf)
LIBEXPORT int MucConvertFromUnicode (void *vcd, const MIUNICODE *ucbuf, void **outbufp)
LIBEXPORT int MucConvertISO2022aToUnicode (const void *, MIUNICODE **)
LIBEXPORT int MucConvertISO2022ToUnicode (const void *, MIUNICODE **)
LIBEXPORT int MucConvertToISO2022 (void *vcd, const void *vinbuf, char **outbuf)
LIBEXPORT int MucConvertToUnicode (void *vcd, const void *vinbuf, MIUNICODE **outbuf)
LIBEXPORT int MucConvertUnicodeGen (const MIUNICODE *inbuf, int(*NewCharsetFunc)(int NewCharset, int OldCharset, void *UserData), int(*AddCharsFunc)(UINT8 *chars, int len, void *UserData), void *UserData, UINT32 flags)
LIBEXPORT int MucConvertUnicodeToISO2022 (const MIUNICODE *inbuf, char **outbuf)
LIBEXPORT int MucConvertUnicodeToUTF8 (const MIUNICODE *instr, UINT8 **outstr)
LIBEXPORT int MucConvertUTF8ToUnicode (const UINT8 *instr, MIUNICODE **outstr)
LIBEXPORT MIUNICODE * MucDecompose (const MIUNICODE *string)
LIBEXPORT MIUNICODE * MucDoGlyphSubstitutions (const MIUNICODE *instr, bool(*CB_AllowSub)(const UCDATA *sub, void *cbdata), void *cbdata, UINT32 flags=0)
LIBEXPORT MIUNICODE * MucFlipVisualAndLogicalOrder (const MIUNICODE *)
LIBEXPORT int MucGetDefaultCharsets (int *charset1, int *charset2, int *charset3)
LIBEXPORT CHAR_ENCODING MucGetEncodingFromName (const char *name)
LIBEXPORT CHAR_ENCODING MucGetEncodingFromNum (int num, ENCODELIST_FLAGS flags)
LIBEXPORT int MucGetEncodingNum (CHAR_ENCODING encoding, ENCODELIST_FLAGS flags)
LIBEXPORT int MucGetGlyphDirection (const MIUNICODE *uc, int curdir, UINT8 *glyphflags)
LIBEXPORT const char * MucGetName (CHAR_ENCODING encoding)
LIBEXPORT int MucGetNumEncodings (ENCODELIST_FLAGS flags)
LIBEXPORT int MucGuessJapaneseEncoding (const UINT8 *in, char *encoding)
LIBEXPORT int MucHasRightToLeftTextISO2022 (const char *in)
LIBEXPORT int MucHasRightToLeftTextUC (const MIUNICODE *in)
LIBEXPORT ERRVALUE MucIndicGlyphSubstitutions (const MIUNICODE *instr, MIUNICODE **outstr, SCRIPTTAG script=SCRIPTTAG_Default, INT32 len=-1, bool bApplyRephHack=false)
LIBEXPORT int MucInitConversion (void **handle, const char *encoding, UINT32 flags)
LIBEXPORT bool MucIsThaiLowerVowel (MIUNICODE ch)
LIBEXPORT bool MucIsThaiTone (MIUNICODE ch)
LIBEXPORT bool MucIsThaiUpperVowel (MIUNICODE ch)
LIBEXPORT bool MucIsThaiVowel (MIUNICODE ch)
LIBEXPORT int MucNameToCharset (const char *name, ENCODELIST_FLAGS flags)
LIBEXPORT char * MucNameToDesc (const char *name)
LIBEXPORT MIUNICODE * MucNameToDescUC (const char *name)
LIBEXPORT int MucNameToNum (const char *name, ENCODELIST_FLAGS flags)
LIBEXPORT char * MucNumToDesc (int num, ENCODELIST_FLAGS flags)
LIBEXPORT MIUNICODE * MucNumToDescUC (int num, ENCODELIST_FLAGS flags)
LIBEXPORT const char * MucNumToName (int num, ENCODELIST_FLAGS flags)
LIBEXPORT int MucQuickConvToISO2022 (int encodetype, const void *in, char **outp)
LIBEXPORT int MucQuickConvToUnicode (int encodetype, const void *in, MIUNICODE **ucp)
LIBEXPORT MIUNICODE * MucRecompose (const MIUNICODE *string)
LIBEXPORT void MucReset (void *handle)
LIBEXPORT void MucStopConversion (void *handle)
LIBEXPORT int MucStrLenISO2022 (const void *vinbuf)
LIBEXPORT MIUNICODE * MucThaiShiftTonesAndVowels (const MIUNICODE *str, UINT32 fontencoding)
LIBEXPORT int MucUnicodeToCharset (int val, int charset)
LIBEXPORT MIUNICODE * strntouc (MIUNICODE *dest, const char *source, int len)
LIBEXPORT MIUNICODE * strtouc (MIUNICODE *dest, const char *source)
LIBEXPORT MIUNICODE * strtouccat (MIUNICODE *dest, const char *source)
LIBEXPORT MIUNICODE * strtoucdup (const char *)
bool ucisdigit (MIUNICODE digit)
LIBEXPORT DEPRECATED char * ucntostr (char *dest, const MIUNICODE *source, int len)
LIBEXPORT MIUNICODE * ucstrcat (MIUNICODE *dest, const MIUNICODE *source)
LIBEXPORT MIUNICODE * ucstrchr (const MIUNICODE *p, MIUNICODE value)
LIBEXPORT int ucstrcmp (const MIUNICODE *p1, const MIUNICODE *p2)
LIBEXPORT MIUNICODE * ucstrcpy (MIUNICODE *dest, const MIUNICODE *source)
LIBEXPORT MIUNICODE * ucstrdup (const MIUNICODE *s)
LIBEXPORT int ucstricmp (const MIUNICODE *p1, const MIUNICODE *p2)
LIBEXPORT size_t ucstrlen (const MIUNICODE *p)
LIBEXPORT MIUNICODE * ucstrlwr (MIUNICODE *p)
LIBEXPORT MIUNICODE * ucstrncat (MIUNICODE *p1, const MIUNICODE *p2, int len)
LIBEXPORT int ucstrncmp (const MIUNICODE *p1, const MIUNICODE *p2, int len)
LIBEXPORT MIUNICODE * ucstrncpy (MIUNICODE *dest, const MIUNICODE *source, int len)
LIBEXPORT int ucstrnicmp (const MIUNICODE *p1, const MIUNICODE *p2, int len)
LIBEXPORT MIUNICODE * ucstrpbrk (MIUNICODE *s, MIUNICODE *accept)
LIBEXPORT MIUNICODE * ucstrrchr (MIUNICODE *s, MIUNICODE value)
LIBEXPORT size_t ucstrspn (const MIUNICODE *s, const MIUNICODE *accept)
LIBEXPORT MIUNICODE * ucstrstr (MIUNICODE *s, const MIUNICODE *p)
LIBEXPORT MIUNICODE * ucstrtok (MIUNICODE *s, MIUNICODE *delim)
LIBEXPORT MIUNICODE * ucstrtok2 (MIUNICODE *s, MIUNICODE *delim, MIUNICODE *&state)
LIBEXPORT MIUNICODE * ucstrupr (MIUNICODE *p)
LIBEXPORT DEPRECATED char * uctostr (char *dest, const MIUNICODE *source)
LIBEXPORT DEPRECATED char * uctostrdup (const MIUNICODE *)

Define Documentation

#define ENCODING_ASCII   ENCODING_ISO2022

Definition at line 1580 of file ucstring.h.

#define ENCODING_ISO2022   0

Definition at line 1579 of file ucstring.h.

#define ENCODING_Unicode   -1

Definition at line 1578 of file ucstring.h.

#define GLYPHSUB_AllowCircleForms   0x00000200

Definition at line 1243 of file ucstring.h.

#define GLYPHSUB_AllowCompatForms   0x00000004

Compatibility (equivalent) forms.

Definition at line 1236 of file ucstring.h.

#define GLYPHSUB_AllowFontForms   0x00000400

Definition at line 1244 of file ucstring.h.

#define GLYPHSUB_AllowFractionForms   0x00000010

"1/2" -> single glyph

Definition at line 1238 of file ucstring.h.

#define GLYPHSUB_AllowNarrowForms   0x00000002

Definition at line 1235 of file ucstring.h.

#define GLYPHSUB_AllowNoBreakForms   0x00000800

Definition at line 1245 of file ucstring.h.

#define GLYPHSUB_AllowPositionalForms   0x00000008

Arabic/Hebrew.

Definition at line 1237 of file ucstring.h.

#define GLYPHSUB_AllowSmallForms   0x00000080

Definition at line 1241 of file ucstring.h.

#define GLYPHSUB_AllowSquareForms   0x00000100

Definition at line 1242 of file ucstring.h.

#define GLYPHSUB_AllowSubscriptForms   0x00000020

Definition at line 1239 of file ucstring.h.

#define GLYPHSUB_AllowSuperscriptForms   0x00000040

Definition at line 1240 of file ucstring.h.

#define GLYPHSUB_AllowVerticalForms   0x00001000

Definition at line 1246 of file ucstring.h.

#define GLYPHSUB_AllowWideForms   0x00000001

Definition at line 1234 of file ucstring.h.

#define MUC_THAI_OF   1

Definition at line 1480 of file ucstring.h.

#define MUC_THAI_TTF   2

Definition at line 1481 of file ucstring.h.

#define MUCEVENT_ComposeOff   0x02

Definition at line 1583 of file ucstring.h.

#define MUCEVENT_ComposeOn   0x01

Definition at line 1582 of file ucstring.h.

#define MUCEVENT_ComposeToggle   (MUCEVENT_ComposeOn|MUCEVENT_ComposeOff)

Definition at line 1584 of file ucstring.h.

Function Documentation

LIBEXPORT int MucCharsetToUnicode ( int  val,
int  charset 
)

Convert a single character from a given character set to MIUNICODE.

LIBEXPORT int MucCharsetToUnicodeBuf ( MIUNICODE *  buf,
int  charset 
)

Convert a string characters from a given character set to MIUNICODE.

Operates in-place.

LIBEXPORT int MucConvertFromISO2022 ( void *  vcd,
const void *  vinbuf,
char **  outbuf 
)

Convert string from ISO-2022 to anything.

LIBEXPORT int MucConvertFromUnicode ( void *  vcd,
const MIUNICODE *  ucbuf,
void **  outbufp 
)

Convert string from MIUNICODE to anything.

LIBEXPORT int MucConvertISO2022aToUnicode ( const void *  ,
MIUNICODE **   
)

Convert an ISO-2022a string to MIUNICODE.

ISO-2022a is a MicroImages invention -- a slightly modified version of ISO-2022 in which all backslashes are doubled. This is done because X resource files try to intrepret back slashes as something special even it the backslash is the 2nd byte of a 2-byte character.

The caller should free the buffer returned

LIBEXPORT int MucConvertISO2022ToUnicode ( const void *  ,
MIUNICODE **   
)

Convert an ISO-2022 string to MIUNICODE.

The caller should free the buffer returned

LIBEXPORT int MucConvertToISO2022 ( void *  vcd,
const void *  vinbuf,
char **  outbuf 
)

Convert string from anything to ISO-2022.

The "vcd" must have been initialized by calling MucInitConversion(). Assumes vinbuf is whatever vcd was initialized to. Caller must free outbuf when done

LIBEXPORT int MucConvertToUnicode ( void *  vcd,
const void *  vinbuf,
MIUNICODE **  outbuf 
)

Convert string from anything to MIUNICODE.

The "vcd" must have been initialized by calling MucInitConversion(). Assumes vinbuf is whatever vcd was initialized to. Caller must free outbuf when done

LIBEXPORT int MucConvertUnicodeGen ( const MIUNICODE *  inbuf,
int(*)(int NewCharset, int OldCharset, void *UserData)  NewCharsetFunc,
int(*)(UINT8 *chars, int len, void *UserData)  AddCharsFunc,
void *  UserData,
UINT32  flags 
)

Convert string from MIUNICODE by calling callbacks.

This function can be used to convert a string from MIUNICODE to just about anything. It assumes ISO-8859-1 as an initial character set.

NewCharsetFunc() will be called when the function detects a character not available in the current character set. It tells you what character set it was in and what character set it wants to switch to. At this point, you can do whatever you need to do to switch fonts to one that supports the requested character set. You should return 0 or an error code < 0.

AddCharsFunc() is called when an internal buffer fills up or just before calling NewCharsetFunc() to let add the characters to your output buffer or display them or whatever it is you're doing. The "characters" passed to you may be multi-byte. If this is the case, "len" is in bytes.

LIBEXPORT int MucConvertUnicodeToISO2022 ( const MIUNICODE *  inbuf,
char **  outbuf 
)

Convert a MIUNICODE string to ISO-2022.

The caller should free the buffer returned

LIBEXPORT int MucConvertUnicodeToUTF8 ( const MIUNICODE *  instr,
UINT8 **  outstr 
)

Convert MIUNICODE (UTF-16) to UTF8.

Warning! This function assumes that the pointer passed in for outstr is either NULL or can be realloc'd as needed. You must therefore initialize it to somthing.

LIBEXPORT int MucConvertUTF8ToUnicode ( const UINT8 *  instr,
MIUNICODE **  outstr 
)

Convert UTF8 to MIUNICODE (UTF-16).

Warning! This function assumes that the pointer passed in for outstr is either NULL or can be realloc'd as needed. You must therefore initialize it to somthing.

LIBEXPORT MIUNICODE* MucDecompose ( const MIUNICODE *  string  ) 

Decompose a Unicode string into Canonical form.

In a cononical Unicode string, all decomposable characters are decomposed. For example, 0x00E9 (LATIN SMALL LETTER E WITH ACUTE) is represented as 0x0065 (LATIN SMALL LETTER E) + 0x0301 (COMBINING ACUTE ACCENT)

The caller should free the returned string

LIBEXPORT MIUNICODE* MucDoGlyphSubstitutions ( const MIUNICODE *  instr,
bool(*)(const UCDATA *sub, void *cbdata)  CB_AllowSub,
void *  cbdata,
UINT32  flags = 0 
)

Perform glyph substitutions on a MIUNICODE string. c++.

This function returns a copy of the given string after performing glyph substitutions based on the decomposition data in UnicodeData.txt (which we've cooked into a compact form, ucdata.ref)

Note: This function assumes the input string is in logical order and does not flip it in any way.

Parameters:
instr String to convert
CB_AllowSub Aallows you to intercept and deny substitutions. A good use for this feature would be to verify that the selected font has a given glyph available before allowing the substitution. The callback should return true to allow the substitution, false to prevent it. If no callback is provided, all substitutions are allowed.
cbdata Callback data. Will be passed to CB_AllowSub as the 2nd parameter
flags 
  • GLYPHSUB_AllowWideForms Wide (or zenkaku) compatibility characters
  • GLYPHSUB_AllowNarrowForms Narrow (or hankaku) compatibility characters
  • GLYPHSUB_AllowCompatForms Compatibility (equivalent) forms
  • GLYPHSUB_AllowPositionalForms Arabic/Hebrew positional forms
  • GLYPHSUB_AllowFractionForms Converts the three characters "1/2" to a single fraction glyph
  • GLYPHSUB_AllowSubscriptForms
  • GLYPHSUB_AllowSuperscriptForms
  • GLYPHSUB_AllowSmallForms Small variant forms (CNS compatibility)
  • GLYPHSUB_AllowSquareForms CJK squared font variant
  • GLYPHSUB_AllowCircleForms Encircled forms
  • GLYPHSUB_AllowFontForms Font variants (e.g. a blackletter form)
  • GLYPHSUB_AllowNoBreakForms Non-breaking spaces and hyphens
  • GLYPHSUB_AllowVerticalForms Vertical presentation forms

LIBEXPORT MIUNICODE* MucFlipVisualAndLogicalOrder ( const MIUNICODE *   ) 

Flip Right-To-Left text to "visual" order.

Returns a copy of the input string which caller must free. This function is symetric. That is, flipping the same string twice gives the original string.

LIBEXPORT int MucGetDefaultCharsets ( int *  charset1,
int *  charset2,
int *  charset3 
)

Returns the default charset for keyboard input.

Returns 3 charset codes which can be used as hints when trying to convert MIUNICODE to ISO-2022. This is used by the input of the XeText widget.

Parameters:
charset1 Charset to use for single-byte things < 128
charset2 Charset to use for single-byte things > 128
charset3 Charset to use for multi-byte things.

LIBEXPORT CHAR_ENCODING MucGetEncodingFromName ( const char *  name  ) 

Given an encoding name, return the CHAR_ENCODING value.

LIBEXPORT CHAR_ENCODING MucGetEncodingFromNum ( int  num,
ENCODELIST_FLAGS  flags 
)

Given an encoding number, return the CHAR_ENCODING value.

This will return the Nth encoding which matches the criteria set forth by the flags parameter. Encoding numbers (as passed to this function) are not fixed and can change at any time. The only thing this function should be used for is retrieving a list of encodings to present the user with a choice.

Parameters:
num The encoding number.
flags 
  • ENCODELIST_FLAG_Any Allow any encoding
  • ENCODELIST_FLAG_Importable Allow importable encodings
  • ENCODELIST_FLAG_Exportable Allow exportable encodings
  • ENCODELIST_FLAG_Both Allow importanble or exportable encodings
  • ENCODELIST_FLAG_NoUnicode Don't include MIUNICODE

LIBEXPORT int MucGetEncodingNum ( CHAR_ENCODING  encoding,
ENCODELIST_FLAGS  flags 
)

Return the index into array of encodings for a given encoding.

If you use MucGetNumEncodings() and MucNumToName() to iterate through all the encodings of a given type for the purposes of generating a list for the user to select from, then this function is useful for determining which item in that list a given encoding will be so that you can make it the default.

Parameters:
encoding The encoding to find
flags 
  • ENCODELIST_FLAG_Any Allow any encoding
  • ENCODELIST_FLAG_Importable Allow importable encodings
  • ENCODELIST_FLAG_Exportable Allow exportable encodings
  • ENCODELIST_FLAG_Both Allow importanble or exportable encodings
  • ENCODELIST_FLAG_NoUnicode Don't include MIUNICODE
Returns:
Index into array or -1 if encoding not found.

LIBEXPORT int MucGetGlyphDirection ( const MIUNICODE *  uc,
int  curdir,
UINT8 *  glyphflags 
)

Determine the direction of a glyph.

Given a MIUNICODE string and a current direction, determine the direction of the next character in the string.

The glyphflags array is filled in by this function.

Directions (both curdir and the return value)

glyphflags

LIBEXPORT const char* MucGetName ( CHAR_ENCODING  encoding  ) 

Return an encoding name.

Once an encoding is named, the name is set in stone and can be written to files without fear of the name changing. The actual name presented to the user is looked up in messages.txt by calling MucNameToDescUC()

Do NOT free the return value from this function

LIBEXPORT int MucGetNumEncodings ( ENCODELIST_FLAGS  flags  ) 

Get the number of supported encodings of a given type.

Parameters:
flags 
  • ENCODELIST_FLAG_Any Allow any encoding
  • ENCODELIST_FLAG_Importable Allow importable encodings
  • ENCODELIST_FLAG_Exportable Allow exportable encodings
  • ENCODELIST_FLAG_Both Allow importanble or exportable encodings
  • ENCODELIST_FLAG_NoUnicode Don't include MIUNICODE

LIBEXPORT int MucGuessJapaneseEncoding ( const UINT8 *  in,
char *  encoding 
)

Given a string which may be in either JIS, Shift-JIS, or EUC encoding, try to determine which it is.

The "encoding" string passed in must be big enough to hold the resulting encoding name "Shift-JIS" is the longest string it can return.

LIBEXPORT int MucHasRightToLeftTextISO2022 ( const char *  in  ) 

Determine if an ISO-2022 string has right-to-left text in it.

LIBEXPORT int MucHasRightToLeftTextUC ( const MIUNICODE *  in  ) 

Determine if a MIUNICODE string has right-to-left text in it.

LIBEXPORT ERRVALUE MucIndicGlyphSubstitutions ( const MIUNICODE *  instr,
MIUNICODE **  outstr,
SCRIPTTAG  script = SCRIPTTAG_Default,
INT32  len = -1,
bool  bApplyRephHack = false 
)

Does Indic glyph substitution based on various rules.

script should be one of the following: SCRIPTTAG_Default (See below) SCRIPTTAG_beng (Bengali) SCRIPTTAG_deva (Devanagari) SCRIPTTAG_gujr (Gujarati) SCRIPTTAG_knda (Kannada) SCRIPTTAG_mlym (Malayalam) SCRIPTTAG_orya (Oriya) SCRIPTTAG_punj (punjabi) SCRIPTTAG_taml (Tamil) SCRIPTTAG_telu (Telugu)

If script is SCRIPTTAG_Default, currently it will fall back on Devanagari, but eventually it will try to find the current system script and use that.

The len parameter is used to avoid an extra ucstrlen() call. If the caller already knows the length of instr, pass it. If not, just omit the parameter.

The caller is responsible for freeing outstr

The flag bApplyRephHack is just that, a hack. In order to correctly process the GSUB tables, we need to only apply the 'rphf' table if we have reordered a reph+halant+consonant combination to consonant+reph+halant. In order to do that, we need to somehow distinguish between text where we moved the reph and text where it was already there. To do this, if this flag is set, we change the reph to a fake Unicode character, one that we chose by subtracting 0x30 from the reph glyph. In all the Indic encodings, this falls on an unused code point (for example, 0x0930 becomes 0x0900). The caller knows to look for this and converts it back to the real reph glyph, but sets a flag telling us to process the 'rphf' table on it.

Parameters:
len  Length of instr if known (just to avoid extra ucstrlen())

LIBEXPORT int MucInitConversion ( void **  handle,
const char *  encoding,
UINT32  flags 
)

Initialize a MIUNICODE conversion handle.

LIBEXPORT bool MucIsThaiLowerVowel ( MIUNICODE  ch  ) 

Returns true if ch is a Thai vowel character that sits below the consonant.

LIBEXPORT bool MucIsThaiTone ( MIUNICODE  ch  ) 

Returns true if ch is a Thai tone character.

LIBEXPORT bool MucIsThaiUpperVowel ( MIUNICODE  ch  ) 

Returns true if ch is a Thai vowel character that sits above the consonant.

LIBEXPORT bool MucIsThaiVowel ( MIUNICODE  ch  ) 

Returns true if ch is a Thai vowel character.

LIBEXPORT int MucNameToCharset ( const char *  name,
ENCODELIST_FLAGS  flags 
)

Determine the primary character set for a given encoding.

LIBEXPORT char* MucNameToDesc ( const char *  name  ) 

Return the description of an encoding given the name (char*).

This looks up the incoding description from messages.txt. You should free the return value when you're done with it. Don't call this. Calle MucNameToDescUC() instead

See also:
MucNameToDescUC()

LIBEXPORT MIUNICODE* MucNameToDescUC ( const char *  name  ) 

Return the description of an encoding given the name (MIUNICODE*).

This looks up the incoding description from messages.txt. You should free the return value when you're done with it.

LIBEXPORT int MucNameToNum ( const char *  name,
ENCODELIST_FLAGS  flags 
)

The opposite of MucNumToName().

LIBEXPORT char* MucNumToDesc ( int  num,
ENCODELIST_FLAGS  flags 
)

Return the description of an encoding given the number (char*).

This looks up the incoding description from messages.txt. You should free the return value when you're done with it. Don't call this. Calle MucNumToDescUC() instead

See also:
MucNumToDescUC()

LIBEXPORT MIUNICODE* MucNumToDescUC ( int  num,
ENCODELIST_FLAGS  flags 
)

Return the description of an encoding given the number (MIUNICODE*).

This looks up the incoding description from messages.txt. You should free the return value when you're done with it.

LIBEXPORT const char* MucNumToName ( int  num,
ENCODELIST_FLAGS  flags 
)

Convert an encoding number to its name.

Combines the following two functions

See also:
MucGetEncodingFromNum()

MucGetName()

Do not free the output from this function

LIBEXPORT int MucQuickConvToISO2022 ( int  encodetype,
const void *  in,
char **  outp 
)

Don't use this function.

LIBEXPORT int MucQuickConvToUnicode ( int  encodetype,
const void *  in,
MIUNICODE **  ucp 
)

Don't use this function.

LIBEXPORT MIUNICODE* MucRecompose ( const MIUNICODE *  string  ) 

Recompose a Canonical form Unicode string into the combined forms.

In a cononical Unicode string, all decomposable characters are decomposed. For example, 0x00E9 (LATIN SMALL LETTER E WITH ACUTE) is represented as 0x0065 (LATIN SMALL LETTER E) + 0x0301 (COMBINING ACUTE ACCENT). This function puts them back together.

The caller should free the returned string

LIBEXPORT void MucReset ( void *  handle  ) 

Reset an Muc handle.

LIBEXPORT void MucStopConversion ( void *  handle  ) 

Stop a MIUNICODE conversion handle.

LIBEXPORT int MucStrLenISO2022 ( const void *  vinbuf  ) 

Determine the number of characters in an ISO-2022 string.

Since ISO-2022 can consist of single-byte and two-byte characters and escape codes, a simple strlen() won't give you an accurate length. This function gives you the same result you'd get if you converted the string to MIUNICODE and called ucstrlen() on the result, but without going to the actual work.

LIBEXPORT MIUNICODE* MucThaiShiftTonesAndVowels ( const MIUNICODE *  str,
UINT32  fontencoding 
)

Parameters:
fontencoding  MUC_THAI_OF or MUC_THAI_TTF

LIBEXPORT int MucUnicodeToCharset ( int  val,
int  charset 
)

Convert a single MIUNICODE character to a given character set.

Returns 0 if the character is not available in the given charset

LIBEXPORT MIUNICODE* strntouc ( MIUNICODE *  dest,
const char *  source,
int  len 
)

Convert an ASCII string to Unicode (with length limit).

Note, this function doesn't do any character set mapping. It simply casts all the source characters to (MIUNICODE)

LIBEXPORT MIUNICODE* strtouc ( MIUNICODE *  dest,
const char *  source 
)

Convert an ASCII string to Unicode.

Note, this function doesn't do any character set mapping. It simply casts all the source characters to (MIUNICODE)

LIBEXPORT MIUNICODE* strtouccat ( MIUNICODE *  dest,
const char *  source 
)

Convert an ASCII string to Unicode and append to existing string.

Note, this function doesn't do any character set mapping. It simply casts all the source characters to (MIUNICODE)

LIBEXPORT MIUNICODE* strtoucdup ( const char *   ) 

MIUNICODE version of strdup().

Note, this function doesn't do any character set mapping. It simply casts all the source characters to (MIUNICODE). The resulting string should be MmFree()'d.

bool ucisdigit ( MIUNICODE  digit  )  [inline]

MIUNICODE version of isdigit().

It only detects the ASCII numerals 0-9. Note, that some implementations of isdigit() will crash if given Unicode values > 255.

Definition at line 809 of file ucstring.h.

LIBEXPORT DEPRECATED char* ucntostr ( char *  dest,
const MIUNICODE *  source,
int  len 
)

Convert MIUNICODE string to ASCII (with length-limit).

Deprecated:
, Use appropriate MISTRING or FILEPATH method instead. Note, this just strips the high byte, so any characters > 255 will produce garbage in the output

LIBEXPORT MIUNICODE* ucstrcat ( MIUNICODE *  dest,
const MIUNICODE *  source 
)

MIUNICODE version of strcat().

LIBEXPORT MIUNICODE* ucstrchr ( const MIUNICODE *  p,
MIUNICODE  value 
)

MIUNICODE version of strchr().

Find the first occurance of a given character in a Unicode string. Returns a pointer to that character or NULL if not found.

LIBEXPORT int ucstrcmp ( const MIUNICODE *  p1,
const MIUNICODE *  p2 
)

Compare two MIUNICODE strings.

Returns -1 if (p1 < p2), 1 if (p1 > p2) 0 if (p1 == p2)

LIBEXPORT MIUNICODE* ucstrcpy ( MIUNICODE *  dest,
const MIUNICODE *  source 
)

Unicode version of strcpy().

LIBEXPORT MIUNICODE* ucstrdup ( const MIUNICODE *  s  ) 

Unicode version of strdup().

LIBEXPORT int ucstricmp ( const MIUNICODE *  p1,
const MIUNICODE *  p2 
)

Compare two MIUNICODE strings (case insensitive).

Returns -1 if (p1 < p2), 1 if (p1 > p2) 0 if (p1 == p2)

LIBEXPORT size_t ucstrlen ( const MIUNICODE *  p  ) 

Unicode version of strlen().

LIBEXPORT MIUNICODE* ucstrlwr ( MIUNICODE *  p  ) 

Convert MIUNICODE string to lowercase (in-place).

Modifies the input string

LIBEXPORT MIUNICODE* ucstrncat ( MIUNICODE *  p1,
const MIUNICODE *  p2,
int  len 
)

MIUNICODE version of strncat().

LIBEXPORT int ucstrncmp ( const MIUNICODE *  p1,
const MIUNICODE *  p2,
int  len 
)

Compare two MIUNICODE strings (length limited).

Returns -1 if (p1 < p2), 1 if (p1 > p2) 0 if (p1 == p2)

LIBEXPORT MIUNICODE* ucstrncpy ( MIUNICODE *  dest,
const MIUNICODE *  source,
int  len 
)

MIUNICODE version of strncpy().

LIBEXPORT int ucstrnicmp ( const MIUNICODE *  p1,
const