UnicodeToAnsi (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for managing strings

UnicodeToAnsi

Presentation

Example

UTF8 - ANSI conversion

Conversion to PHP

See also

UnicodeToAnsi (Function)

In french: UnicodeVersAnsi

Converts:

a character string in UNICODE format into a character string in ANSI format (Windows).
The character string is converted into a buffer containing a character string in ANSI format.
a buffer containing a character string in UNICODE format into a buffer containing a character string in ANSI format (Windows).

Reminder:

ANSI is the format of characters according to the Windows standard.
UNICODE is a mechanism for encoding characters. The UNICODE format is used to manage the different languages and the different character sets.

Versions 16 and later

This function is now available for Java applications.

This function is now available for Android applications.

New in version 16

This function is now available for Java applications.

This function is now available for Android applications.

This function is now available for Java applications.

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Apple Watch mode.

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

New in version 21

This function is now available in Apple Watch mode.

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

This function is now available in Apple Watch mode.

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

Example

MyAnsiBuffer is Buffer
// Convert the MyUnicodeBuffer buffer
// that contains a character string in UNICODE format
// into a buffer containing a character string
// in ANSI format
MyAnsiBuffer = UnicodeToAnsi(MyUnicodeBuffer)

MyUnicodeString is UNICODE string
MyAnsiString is string
FileNum is int = fOpen("c:\Temp\MyText.txt", foRead + foUnicode)
IF FileNum <> -1 THEN
MyUnicodeString = fReadLine(FileNum)
END
MyAnsiString = UnicodeToAnsi(MyUnicodeString, charsetGreek)

MyAnsiBuffer is Buffer
// Convert the character string
// MyString in UNICODE format
// into a buffer containing a character string
// in ANSI format
MyAnsiBuffer = UnicodeToAnsi(MyString)

Syntax

Converting a Unicode character string Hide the details

<Result> = UnicodeToAnsi(<Character String to Convert> [, <Charset> [, <Unknown Character>]])

<Result>: Character string or buffer

Character string in ANSI format.
Buffer containing a character string in ANSI format.

<Character String to Convert>: Unicode character string

Character string in UNICODE format to convert. This parameter can also be a character string in ANSI format that contains UNICODE characters.

<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 by ChangeCharset (charsetOccidental by default)
charsetDefault
Default value
Uses the default character set defined for the computer. No character set is forced.
charsetEastEurope Characters of Eastern Europe (Polish, ...)
charsetGreek Greek characters
charsetHebrew Hebrew characters
charsetJapanese Japanese characters
Versions 20 and later
charsetMac
New in version 20
charsetMac
charsetMac Characters to the Mac Roman standard (used on the old Macintosh versions).
charsetOccidental Roman characters in ANSI standard
charsetRussian Russian characters
charsetThai Thai characters
charsetTurkish Turkish characters
charsetUTF8 Used to manage the UTF8 format (used in XML for example)
charsetVietnamese Vietnamese characters

<Unknown Character>: Optional character or constant

Character to use if an unknown character is found by the conversion. The NULL constant allows you to use the default system character.

Converting a buffer containing a character string in Unicode format Hide the details

<Result> = UnicodeToAnsi(<Buffer> [, <Charset> [, <Unknown Character>]])

<Result>: Buffer

Buffer containing a character string in ANSI format.

<Buffer>: Buffer

Buffer containing a character string in UNICODE format to convert. The result will be undefined if <Buffer> contains a character string in ANSI format.

<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 in ChangeCharset (charsetOccidental by default)
charsetDefault
Default value
Uses the default character set defined for the computer. No character set is forced.
charsetEastEurope Characters of Eastern Europe (Polish, ...)
charsetGreek Greek characters
charsetHebrew Hebrew characters
charsetJapanese Japanese characters
Versions 20 and later
charsetMac
New in version 20
charsetMac
charsetMac Characters to the Mac Roman standard (used on the old Macintosh versions).
charsetOccidental Roman characters in ANSI standard
charsetRussian Russian characters
charsetThai Thai characters
charsetTurkish Turkish characters
charsetUTF8 Used to manage the UTF8 format (used in XML for example)
charsetVietnamese Vietnamese characters

<Unknown Character>: Optional character or constant

Character to use if an unknown character is found by the conversion. The NULL constant allows you to use the default system character.

Remarks

UTF8 - ANSI conversion

To convert an ANSI string into a string in UTF8 format, use StringToUTF8.

To convert a UFT8 string into a string in ANSI format, use:

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

Conversion to PHP

The conversion performed in PHP is using the following PHP extensions:

the php_iconv.dll extension
the php_mbstring.dll extension

If none of these PHP extensions is found, only the Latin characters will be converted (the Chinese or Russian characters will not be converted for example).

The php_iconv.dll and php_mbstring.dll extensions are currently proposed on the PHP servers. To find out whether these extensions are proposed by your hosting company, enter the following information in a search engine: phpinfo <Name of hosting company>.

To install these extensions on your own PHP server, all you have to do is uncomment the requested extension in the PHP.INI file.

Component : wd240vm.dll