*utf-8s-transcoding-error-action*

The value of this variable determines how the :utf-8s external-format deals with transcoding errors. Unless an error is signaled, all improper (non-utf-8) character or octets are replaced with the value returned by utf-8s-transcoding-error-char (for characters) or its char-int (for octets). It is one of the following values:

• nil: Ignore transcoding errors silently.
• :warn: Signal a warning of class utf-8s-transcoding-warning.
• :count: Replace the value of this variable with a count of transcoding errors.
• an integer: Same as :count but continue counting from the given integer value.
• :collect: Replace the value of this variable with a list of error markers. For each error signalled while converting characters to octets, push the offending character onto the list.
  For each input error, push a list of the offending octets onto the list.
• a cons: Same as :collect but continue pushing onto the given list.
• :error (or any other value not above): Signal an error of class utf-8s-transcoding-error.

In all cases insert the utf-8s-transcoding-error-char character to replace the offending character or octets in the transcoded stream.

See Strict external formats which do not allow improper characters in iacl.htm for more information on the :utf-8s external format, international characters and external formats in general.

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page is new in the 10.1 release.
Created 2019.8.20.