(Delphi ActiveX) 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 for Delphi Downloads Chilkat ActiveX DLL for Delphi Chilkat non-ActiveX DLL for Delphi * The examples here use the ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB;

...

procedure TForm1.Button1Click(Sender: TObject);
var
charset: TChilkatCharset;
success: Integer;

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

charset := TChilkatCharset.Create(Self);

charset.FromCharset := 'utf-8';
charset.ToCharset := '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.
charset.ToCharset := 'Windows-1252';

success := charset.ConvertFile('qa_data/txt/cafeUtf8.txt','qa_output/cafeAnsi.txt');
if (success <> 1) then
  begin
    Memo1.Lines.Add(charset.LastErrorText);
    Exit;
  end;

Memo1.Lines.Add('Success.');
end;