UTF8ToCP1252 function
Converts a string from UTF-8 encoding to Code Page 1252.
Declaration
function UTF8ToCP1252(const s: string; SetTargetCodePage: Boolean=False)
: RawByteStringArguments
s | UTF-8-encoded string value converted in the routine. |
SetTargetCodePage | True 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 1252.
Description
UTF8ToCP1252 is a
RawByteString function used to
convert a UTF-8-encoded string to the Code Page 1252 (Latin 1) encoding.
UTF8ToCP1252 calls the UTF8ToSingleByte routine using UnicodeToCP1252 to perform character conversions needed for the target encoding. System code pages are not used (when enabled) because of a failure when translating Unicode code points (#128) to the target code page. The character translation table in UnicodeToCP1252 is used instead. When SetTargetCodePage is True, SetCodePage is called (without character conversion) to set the code page to 1252 in the return value.
UTF8ToCP1252 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.