UnicodeToAnsi (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Standard functions

String management functions

Prefix syntax

UnicodeToAnsi

Presentation

Example

UTF-8 and ANSI conversion

Conversion in PHP

See also

UnicodeToAnsi (Function)

In french: UnicodeVersAnsi

Converts:

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

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.

Example

MyAnsiBuffer is Buffer
// Convert the MyUnicodeBuffer buffer
// that contains a UNICODE string
// to a buffer containing an ANSI string
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)
MyAnsiString = UnicodeToAnsi(MyUnicodeString, charsetGreek)

Syntax

Converting a Unicode string Hide the details

<Result> = UnicodeToAnsi(<String to convert> [, <Charset> [, <Unknown character>]])

<Result>: String or buffer

ANSI string.

<String to convert>: Unicode string

UNICODE string to be converted. This parameter can also be an ANSI string 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).
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 European characters (Polish, etc.).
charsetGreek Greek characters.
charsetHebrew Hebrew characters.
charsetJapanese Japanese characters.
charsetKorean Korean characters.
charsetMac Mac Roman character set (used in previous versions of Macintosh).
charsetOccidental Roman characters in ANSI standard.
charsetRussian Russian characters.
charsetThai Thai characters.
charsetTraditionalChinese Traditional Chinese characters (Republic of Taiwan).
charsetTurkish Turkish characters.
charsetUTF8 Used to manage UTF-8 (used in XML, for example).
charsetVietnamese Vietnamese characters.

<Unknown character>: Optional character or constant

Character to use if an unknown character is encountered during the conversion process. The NULL constant allows you to use the default system character.

Converting a buffer containing a Unicode string Hide the details

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

<Result>: Buffer

Buffer containing an ANSI string.

<Buffer>: Buffer

Buffer containing the UNICODE string to be converted. If <Buffer> contains an ANSI string, the result will be undefined.

<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).
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 European characters (Polish, etc.).
charsetGreek Greek characters.
charsetHebrew Hebrew characters.
charsetJapanese Japanese characters.
charsetKorean Korean characters.
charsetMac Mac Roman character set (used in previous versions of Macintosh).
charsetOccidental Roman characters in ANSI standard.
charsetRussian Russian characters.
charsetThai Thai characters.
charsetTraditionalChinese Traditional Chinese characters (Republic of Taiwan).
charsetTurkish Turkish characters.
charsetUTF8 Used to manage UTF-8 (used in XML, for example).
charsetVietnamese Vietnamese characters.

<Unknown character>: Optional character or constant

Character to use if an unknown character is encountered during the conversion process. The NULL constant allows you to use the default system character.

Remarks

UTF-8 and ANSI conversion

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

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

the UTF8ToString function.
the UTF8ToAnsi function.

Conversion in PHP

The conversion in PHP uses the following extensions:

the php_iconv.dll extension
the php_mbstring.dll extension

If none of these PHP extensions are used, only Latin characters will be converted (e.g., Chinese or Russian characters will not be converted).

The php_iconv.dll and php_mbstring.dll extensions are currently proposed on PHP servers. To find out if your hosting provider offers these extensions, simply enter the following information in a search engine: phpinfo <Hosting provider>.

To install these extensions on your own PHP server, simply uncomment the desired extension in the PHP.INI file.

Component: wd280vm.dll