Sign in Join
FPDoc Onlineexperiment

UTF8ToCP437 function

In unit LConvEncoding

Converts a string from UTF-8 encoding to Code Page 437.

Declaration

pascal
function UTF8ToCP437(const s: string; SetTargetCodePage: Boolean=False)
: RawByteString

Arguments

s

UTF-8-encoded string value converted in the routine.

SetTargetCodePageTrue if the target code page is set in the return value, False if a code page is not used.

Function result

String value after conversion to Code Page 437.

Description

UTF8ToCP437 is a RawByteString function used to convert a UTF-8-encoded string to the Code Page 437 (DOS Latin US) encoding.

For platforms where system code pages are enabled, SetCodePage is called to convert the value to the DOS Latin US code page (437). If SetTargetCodePage is False, SetCodePage is called again to apply the CP_ACP (ANSI) code page in the return value.

For other platforms, the UTF8ToSingleByte routine is called using UnicodeToCP437 to perform character conversions needed for the target encoding.

UTF8ToCP437 is used in the implementation of the ConvertEncodingFromUTF8 encoding conversion routine.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.