AnsiToUnicode (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

String management functions

UTF-8 and ANSI conversion

See also

AnsiToUnicode (Function)

In french: AnsiVersUnicode

Converts:

an ANSI string (Windows) to a UNICODE string.
a buffer containing an ANSI string (Windows) to a buffer containing a UNICODE string.

Reminder:

ANSI is the character set used in Windows.
UNICODE is a character encoding standard. UNICODE is used to manage different languages and character sets.

Versions 16 and later

This function is now available for Java applications.

New in version 16

This function is now available for Java applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

MyUnicodeBuffer is Buffer
// Convert MyAnsiBuffer
// that contains an ANSI string
// to a buffer containing a UNICODE string
MyUnicodeBuffer = AnsiToUnicode(MyAnsiBuffer)

// Code to use in a non-Unicode project
MyUnicodeString is UNICODE string
MyUnicodeString = AnsiToUnicode("Developing is fantastic", charsetGreek)

Syntax

Converting an ANSI character string Hide the details

<Result> = AnsiToUnicode(<String to convert> [, <Charset>])

<Result>: UNICODE character string

String in UNICODE format.
EOT if a conversion problem occurred.

<String to convert>: Character string

ANSI string to convert.

<Charset>: Optional Integer constant

Character set that will be used for the conversion.
charsetAnsi Roman characters in ANSI standard.
charsetArabic Arabic characters.
charsetBaltic Baltic characters.
charsetChinese Chinese characters (People's Republic of China).
charsetTraditionalChinese Traditional Chinese characters (Republic of Taiwan).
charsetKorean Korean characters
charsetCurrent
(Default value) Uses the current character set specified with ChangeCharset (charsetOccidental by default).
charsetDefault Uses the computer's default character set. No character set is forced.
charsetEastEurope Eastern Europe characters (Polish, etc.)
charsetGreek Greek characters.
charsetHebrew Hebrew characters.
charsetJapanese Japanese characters.
Versions 20 and later
charsetMac
New in version 20
charsetMac
charsetMac Mac Roman character set (used in previous versions of Macintosh).
charsetRussian Russian characters.
charsetThai Thai characters.
charsetTurkish Turkish characters.
charsetUTF8 Used to manage UTF-8 (used in XML, for example).
charsetVietnamese Vietnamese characters.

Converting a buffer containing an ANSI string Hide the details

<Result> = AnsiToUnicode(<Buffer> [, <Charset>])

<Result>: Buffer

Buffer containing a UNICODE string.
EOT if a conversion problem occurred.

<Buffer>: Buffer

Buffer containing an ANSI string to convert. If <Buffer> contains a UNICODE string, <Result> will contain an invalid string.

<Charset>: Optional Integer constant

Character set that will be used for the conversion.
charsetAnsi Roman characters in ANSI standard.
charsetArabic Arabic characters.
charsetBaltic Baltic characters.
charsetChinese Chinese characters (People's Republic of China).
charsetTraditionalChinese Traditional Chinese characters (Republic of Taiwan).
charsetKorean Korean characters.
charsetCurrent
(Default value) Current character set specified with ChangeCharset (charsetOccidental by default).
charsetDefault
Uses the computer's default character set. No character set is forced.
charsetEastEurope Eastern Europe characters (Polish, etc.).
charsetGreek Greek characters.
charsetHebrew Hebrew characters.
charsetJapanese Japanese characters.
Versions 20 and later
charsetMac
New in version 20
charsetMac
charsetMac Mac Roman character set (used in previous versions of Macintosh).
charsetOccidental
charsetRussian Russian characters.
charsetThai Thai characters.
charsetTurkish Turkish characters.
charsetUTF8 Used to manage UTF-8 (used in XML, for example).
charsetVietnamese Vietnamese characters.

Remarks

Conversion result

The result of the conversion is a UNICODE string or buffer. This string (or buffer) can only be handled by variables and functions that support UNICODE.

In case of confusion between a UNICODE and an ANSI string, the conversion will be implicitly performed.

For more details on Unicode, see Managing UNICODE.

UTF-8 and ANSI conversion

To convert an ANSI string to UTF-8, use StringToUTF8.

To convert a UFT-8 string to ANSI, use:

UTF8ToString.
Versions 18 and later
UTF8ToAnsi.
New in version 18
UTF8ToAnsi.
UTF8ToAnsi.

Component: wd260vm.dll