SysToUnicode (Windows only)

>>-SysToUnicode--(--string, codepage, translateflags, outstem--)-><

Maps a character string to a UNICODE string.



A string containing the UNICODE characters to be mapped.


Specifies the code page used to perform the conversion. This parameter can be the value of any code page that is installed or available in the system. The default is the current original equipment manufacturer (OEM) code-page identifier for the system.

You can also specify one of the following values:


ANSI code page.


OEM code page.


Windows 2000: symbol code page.


Windows 2000: current thread's ANSI code page.


Windows NT 4.0 and Windows 2000: translate using UTF-7.


Windows NT 4.0 and Windows 2000: translate using UTF-8. When this is set, translateflags must be set.


Indicates whether to translate to precomposed or composite-wide characters (if a composite form exists), whether to use glyph characters in place of control characters, and how to deal with invalid characters.

You can specify a combination of the following flags:


Always use precomposed characters, that is, characters in which a base character and a nonspacing character have a single character value. This is the default translation option. Cannot be used with COMPOSITE.


Always use composite characters, that is, characters in which a base character and a nonspacing character have different character values. Cannot be used with PRECOMPOSED.


If the function encounters an invalid input character, it fails and returns "1113".


Use glyph characters instead of control characters.

A composite character consists of a base character and a nonspacing character, each having different character values. A precomposed character has a single character value for a base-nonspacing character combination. In the character è, the "e" is the base character and the "grave" accent mark is the nonspacing character. The function's default behavior is to translate to the precomposed form. If a precomposed form does not exist, the function attempts to translate to a composite form.

The flags PRECOMPOSED and COMPOSITE are mutually exclusive. The USEGLYPHCHARS flag and the ERR_INVALID_CHARS can be set regardless of the state of the other flags.


The name of the stem variable that will contain the converted result. If the conversion was successful the stem will be composed of the following value(s):


This variable will contain the converted string.

Return codes:


No errors.


An error occurred. A Windows System Error code is returned. This may be one of the following, but could be others.


Incorrect code page or codepage value.


Invalid translate flags.


No mapping for the Unicode character exists in the target code page.