base-4.11.0.0: Basic libraries

GHC.IO.Encoding.Failure

Description

Types for specifying how text encoding/decoding fails

Synopsis

# Documentation

The CodingFailureMode is used to construct TextEncodings, and specifies how they handle illegal sequences.

Constructors

 ErrorOnCodingFailure Throw an error when an illegal sequence is encountered IgnoreCodingFailure Attempt to ignore and recover if an illegal sequence is encountered TransliterateCodingFailure Replace with the closest visual match upon an illegal sequence RoundtripFailure Use the private-use escape mechanism to attempt to allow illegal sequences to be roundtripped.
Instances
 Source # Instance detailsMethods

Some characters are actually "surrogate" codepoints defined for use in UTF-16. We need to signal an invalid character if we detect them when encoding a sequence of Chars into Word8s because they won't give valid Unicode.

We may also need to signal an invalid character if we detect them when encoding a sequence of Chars into Word8s because the RoundtripFailure mode creates these to round-trip bytes through our internal UTF-16 encoding.