Copyright | (c) The University of Glasgow 2008-2011 |
---|---|
License | see libraries/base/LICENSE |
Maintainer | libraries@haskell.org |
Stability | internal |
Portability | non-portable |
Safe Haskell | Trustworthy |
Language | Haskell2010 |
Types for specifying how text encoding/decoding fails
Synopsis
- data CodingFailureMode
- codingFailureModeSuffix :: CodingFailureMode -> String
- isSurrogate :: Char -> Bool
- recoverDecode :: CodingFailureMode -> Buffer Word8 -> Buffer Char -> IO (Buffer Word8, Buffer Char)
- recoverEncode :: CodingFailureMode -> Buffer Char -> Buffer Word8 -> IO (Buffer Char, Buffer Word8)
- recoverDecode# :: CodingFailureMode -> Buffer Word8 -> Buffer Char -> State# RealWorld -> (# State# RealWorld, Buffer Word8, Buffer Char #)
- recoverEncode# :: CodingFailureMode -> Buffer Char -> Buffer Word8 -> State# RealWorld -> (# State# RealWorld, Buffer Char, Buffer Word8 #)
Documentation
data CodingFailureMode Source #
The CodingFailureMode
is used to construct TextEncoding
s,
and specifies how they handle illegal sequences.
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
Show CodingFailureMode Source # | @since base-4.4.0.0 |
Defined in GHC.Internal.IO.Encoding.Failure |
isSurrogate :: Char -> Bool Source #
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 Char
s into Word8
s 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 Char
s into Word8
s because the
RoundtripFailure
mode creates these to round-trip bytes through
our internal UTF-16 encoding.
recoverDecode :: CodingFailureMode -> Buffer Word8 -> Buffer Char -> IO (Buffer Word8, Buffer Char) Source #
recoverEncode :: CodingFailureMode -> Buffer Char -> Buffer Word8 -> IO (Buffer Char, Buffer Word8) Source #