All Manuals > LispWorks® User Guide and Reference Manual > 47 The SYSTEM Package

locale-file-encoding Function

Summary

Provides an encoding corresponding to the current code page on Microsoft Windows, and the locale on Unix-like systems.

Package

system

Signature

locale-file-encoding pathname ef-spec buffer length => new-ef-spec

Arguments
pathname
Pathname identifying location of buffer.
ef-spec
An external format spec.
buffer
A buffer whose contents are examined.
length
Length (an integer) up to which buffer should be examined.
Values
new-ef-spec
Default external format spec created by merging ef-spec with the encoding that was found.
Description

The function locale-file-encoding consults the ANSI code page on Microsoft Windows. If the code page identifier is in win32:*latin-1-code-pages*, locale-file-encoding merges ef-spec with :latin-1. This external format writes Latin-1 on output, giving an error for any non-Latin-1 characters that are written. If the code page identifier is not in win32:*latin-1-code-pages* then locale-file-encoding merges ef-spec with an encoding corresponding to the current code page that gives an error for characters that cannot be encoded.

locale-file-encoding merges ef-spec with :latin-1 on Unix-like systems.

pathname, buffer and length are ignored.

See also

*file-encoding-detection-algorithm*
*latin-1-code-pages*
*multibyte-code-page-ef*
safe-locale-file-encoding


LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:31:02