com.oracle.truffle.api.strings

Interface TranscodingErrorHandler

@FunctionalInterface
public interface TranscodingErrorHandler

An error handler for transcoding operations such as TruffleString.SwitchEncodingNode.

Since:

23.1

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	TranscodingErrorHandler.ReplacementString Result type of TranscodingErrorHandler.apply(AbstractTruffleString, int, int, TruffleString.Encoding, TruffleString.Encoding).

Field Summary

Fields

Modifier and Type	Field and Description
static TranscodingErrorHandler	DEFAULT The default transcoding error handler.
static TranscodingErrorHandler	DEFAULT_KEEP_SURROGATES_IN_UTF8 Same as TranscodingErrorHandler.DEFAULT, but also keeps UTF-16 surrogate values in UTF-8.

Method Summary

Modifier and Type	Method and Description
TranscodingErrorHandler.ReplacementString	apply(AbstractTruffleString sourceString, int byteIndex, int estimatedByteLength, TruffleString.Encoding sourceEncoding, TruffleString.Encoding targetEncoding) Transcoding error handler implementation.

Field Detail

DEFAULT

static final TranscodingErrorHandler DEFAULT

The default transcoding error handler. In UTF encodings, it replaces invalid codepoints with 0xfffd, in all other encodings it uses '?' instead. Exceptions: in UTF-16 and UTF-32, it keeps UTF-16 surrogate values.

Since:

23.1

DEFAULT_KEEP_SURROGATES_IN_UTF8

static final TranscodingErrorHandler DEFAULT_KEEP_SURROGATES_IN_UTF8

Same as TranscodingErrorHandler.DEFAULT, but also keeps UTF-16 surrogate values in UTF-8.

Since:

23.1

Method Detail

apply

TranscodingErrorHandler.ReplacementString apply(AbstractTruffleString sourceString,
                                                int byteIndex,
                                                int estimatedByteLength,
                                                TruffleString.Encoding sourceEncoding,
                                                TruffleString.Encoding targetEncoding)

Transcoding error handler implementation. This method is called once for every byte region that could not be transcoded from sourceEncoding to targetEncoding.

Parameters:

sourceString - the string currently being transcoded.

byteIndex - starting index of region that could not be transcoded.

estimatedByteLength - estimated byte length of erroneous region.

sourceEncoding - the source string's encoding.

targetEncoding - the target encoding.

Returns:

a string to use instead of the invalid region.

Since:

23.1