utf-8s-transcoding-error-char

Arguments: &optional char-or-code

This function queries or modifies the character used to replace invalid characters or character sequences when the :utf-8s external format encounters a transcoding error, i.e. on input a Unicode character or character sequence that does not have a corresponding UTF-8 encoding or on output an invalid sequence of octets is detected (every valid utf-8 code sequence has a Unicode equivalent).

If the argument is omitted or nil, return the current error character, i.e. the character that is inserted in the input or output stream instead of the invalid source.

If the argument is a character with a code in the single octet range, set the error character to the argument and return the same value.

If the argument is an integer that denotes a valid single-octet Unicode character, set the error character to that character and return it.

Otherwise signal a type error.

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.