(PureBasic) Convert a File from utf-8 to ANSI (such as Windows-1252)

This example is to satisfy a particular user's support question:

I have a file that contains this text:

	Original file text	Converted using notepad
Text	CAFÉ	CAFÉ
Hex	43 41 46 c3 89	43 41 46 c9

The utf-8 representation of the character É is the two bytes 0xC3 0x89. When Notepad is displaying the utf-8 file, it is intepreting the bytes as if they are ANSI (1 byte per char), and thus it is showing the ANSI char for 0xC3 (Ã) and the ANSI char for 0x89 (‰). After converting to ANSI, the É is represented by the single byte 0xC9.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkCharset.pb"

Procedure ChilkatExample()

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    charset.i = CkCharset::ckCreate()
    If charset.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkCharset::setCkFromCharset(charset, "utf-8")
    CkCharset::setCkToCharset(charset, "ANSI")

    ; We could alternatively be more specific and say "Windows-1252".
    ; The term "ANSI" means -- whatever character encoding is defined as the ANSI
    ; encoding for the computer.  In Poland, for example, it would be the single-byte-per-char
    ; used to represnt Eastern European language chars, which is Windows-1250.
    CkCharset::setCkToCharset(charset, "Windows-1252")

    success.i = CkCharset::ckConvertFile(charset,"qa_data/txt/cafeUtf8.txt","qa_output/cafeAnsi.txt")
    If success <> 1
        Debug CkCharset::ckLastErrorText(charset)
        CkCharset::ckDispose(charset)
        ProcedureReturn
    EndIf

    Debug "Success."


    CkCharset::ckDispose(charset)


    ProcedureReturn
EndProcedure