Data.Char.Decode

Simple utilities for converting between legacy byte encodings and Unicode.

Class

class ByteEncoding enc where

Represents encodings of bytes as characters. It's not expected that you will need to implement this class directly.

Methods

decodeByte :: enc -> Word8 -> Char

Mapping from bytes to chars.

encodeByte :: enc -> Char -> Either Char Word8

Mapping from chars to bytes. If the character c has no analog in the encoding, returns Left c.

Instances

ByteEncoding CodePage437

Defined in Data.Char.Decode.CodePage437

Methods

decodeByte :: CodePage437 -> Word8 -> Char

encodeByte :: CodePage437 -> Char -> Either Char Word8

ByteEncoding CodePage437Graphic

Defined in Data.Char.Decode.CodePage437.Graphic

Methods

decodeByte :: CodePage437Graphic -> Word8 -> Char

encodeByte :: CodePage437Graphic -> Char -> Either Char Word8

Decoding

decodeToText :: ByteEncoding enc => enc -> ByteString -> Text

Convert a legacy encoded ByteString to a UTF-8 encoded Text.

decodeToString :: ByteEncoding enc => enc -> ByteString -> String

Convert a legacy encoded ByteString to a UTF-8 encoded String.

Encoding

encodeWithDefault :: ByteEncoding enc => enc -> Word8 -> Char -> Word8

If the character has no analog in the encoding, returns the default byte.

encodeFromText :: ByteEncoding enc => enc -> Text -> Either Char ByteString

If any input characters are out of range, returns Left c where c is the first such character.

encodeFromTextWithDefault :: ByteEncoding enc => enc -> Word8 -> Text -> ByteString

If any input characters are out of range, replace them with the given default.

encodeFromString :: ByteEncoding enc => enc -> String -> Either Char ByteString

If any input characters are out of range, returns Left c where c is the first such character.

encodeFromStringWithDefault :: ByteEncoding enc => enc -> Word8 -> String -> ByteString

If any input characters are out of range, replace them with the given default.

Character Mappings

data CodePage437

Data from ftp://www.unicode.org/Public/MAPPINGS/VENDORS/MICSFT/PC/CP437.TXT

Constructors

CodePage437

Instances

Eq CodePage437

Defined in Data.Char.Decode.CodePage437

Methods

(==) :: CodePage437 -> CodePage437 -> Bool

(/=) :: CodePage437 -> CodePage437 -> Bool

Show CodePage437

Defined in Data.Char.Decode.CodePage437

Methods

showsPrec :: Int -> CodePage437 -> ShowS

show :: CodePage437 -> String

showList :: [CodePage437] -> ShowS

ByteEncoding CodePage437

Defined in Data.Char.Decode.CodePage437

Methods

decodeByte :: CodePage437 -> Word8 -> Char

encodeByte :: CodePage437 -> Char -> Either Char Word8

data CodePage437Graphic

Data from https://en.wikipedia.org/wiki/Code_page_437

Constructors

CodePage437Graphic

Instances

Eq CodePage437Graphic

Defined in Data.Char.Decode.CodePage437.Graphic

Methods

(==) :: CodePage437Graphic -> CodePage437Graphic -> Bool

(/=) :: CodePage437Graphic -> CodePage437Graphic -> Bool

Show CodePage437Graphic

Defined in Data.Char.Decode.CodePage437.Graphic

Methods

showsPrec :: Int -> CodePage437Graphic -> ShowS

show :: CodePage437Graphic -> String

showList :: [CodePage437Graphic] -> ShowS

ByteEncoding CodePage437Graphic

Defined in Data.Char.Decode.CodePage437.Graphic

Methods

decodeByte :: CodePage437Graphic -> Word8 -> Char

encodeByte :: CodePage437Graphic -> Char -> Either Char Word8

Utilities

byte0 :: Char -> Word8

Extract the least significant byte (byte 0) of a UTF-8 code point.

byte1 :: Char -> Word8

Extract the next-to-least significant byte (byte 1) of a UTF-8 code point.

byte2 :: Char -> Word8

Extract byte 2 of a UTF-8 code point.

byte3 :: Char -> Word8

Extract byte 3 of a UTF-8 code point.