locale-file-encoding

Function

Summary

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

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.