Difference between revisions of "AEncoding"

From Lazarus wiki
Jump to navigationJump to search
m (Fixed syntax highlighting; fixed typos)
(→‎Download: why Category:Data types ?)
 
Line 29: Line 29:
 
GitHub: https://github.com/Alexey-T/AEncoding
 
GitHub: https://github.com/Alexey-T/AEncoding
  
[[Category:Data types]]
 
 
[[Category:Unicode]]
 
[[Category:Unicode]]

Latest revision as of 13:17, 22 December 2023

About

AEncoding is a small unit, which partly replaces LazUtils.LConvEncoding. It provides a few functions for converting strings from/to some encoding schemes:

function AEncodingConvertFromUTF8(const AInput: RawByteString; out AOutput: RawByteString;
  AEnc: TSystemCodePage): boolean; inline;

function AEncodingConvertToUTF8(const AInput: RawByteString; out AOutput: RawByteString;
  AEnc: TSystemCodePage): boolean; inline;

function AEncodingConvertFromTo(const AInput: RawByteString; out AOutput: RawByteString;
  AEncInput, AEncOutput: TSystemCodePage): boolean;

To use functions with "string" var, do this:

 AEncoding....(RawByteString(S), ....);

Why "partly replaces"?

  • It uses FPC 3.x SetCodePage, which requires OS support for many encodings, whereas LConvEncoding doesn't require OS support. For common encodings (CP1250...CP1258, CP437, CP866 etc) OS support should work, on Windows and Unix'es.
  • FPC SetCodePage doesn't raise exceptions, while LConvEncoding can do it (when global variable is set in LConvEncoding unit).

It also gives few integer constants aeid_NNNN for common encodings.

  • Author: Alexey Torgashin.
  • License: MPL 2.0 or LGPL.

Download

GitHub: https://github.com/Alexey-T/AEncoding