Represents valid ASCII characters, which are bytes from 0x00 to 0x7f.

Since: 1.0.0

Allows constructing ASCII characters from literals, whose correctness is checked by the compiler.

Currently, accepts literal syntax similar to the Haskell parser, with escape sequences preceded by '\'. In particular, this includes the single quote (see the example below).

>>> [char| '\'' |]
'0x27'

Since: 1.0.0

Try and turn a Char into the equivalent AsciiChar. Will return Nothing if given a Char that has no ASCII equivalent.

>>> fromChar '0'
Just '0x30'
>>> fromChar '😺'
Nothing

Since: 1.0.0

Try to give the AsciiChar corresponding to the given byte. Will return Nothing if given a byte that doesn't correspond to an ASCII character.

>>> fromByte 50
Just '0x32'
>>> fromByte 128
Nothing

Since: 1.0.0

Give the AsciiChar corresponding to the uppercase version of the argument. Will give Nothing if given an AsciiChar which has no uppercase version, or is uppercase already.

>>> upcase [char| 'a' |]
Just '0x41'
>>> upcase [char| '0' |]
Nothing

Since: 1.0.0

Give the AsciiChar corresponding to the lowercase version of the argument. Will give Nothing if given an AsciiChar which has no lowercase version, or is lowercase already.

>>> downcase [char| 'C' |]
Just '0x63'
>>> downcase [char| '\\' |]
Nothing

Since: 1.0.0

A categorization of ASCII characters based on whether they're meant to be displayed (Printable) or for control (Control).

Since: 1.0.0

Classify an AsciiChar according to whether it's a control character or a printable character.

>>> charType [char| '\0' |]
Control
>>> charType [char| 'w' |]
Printable

Since: 1.0.0

A categorization of ASCII characters based on their usage. Based (loosely) on Unicode categories.

Since: 1.0.0

Classify an AsciiChar based on its category.

>>> categorize [char| ',' |]
Punctuation
>>> categorize [char| '~' |]
Symbol
>>> categorize [char| 'w' |]
Letter
>>> categorize [char| '2' |]
Number
>>> categorize [char| '\0' |]
Other

Since: 1.0.0

Compatibility method for the GeneralCategory provided by Char.

>>> categorizeGeneral [char| ',' |]
OtherPunctuation
>>> categorizeGeneral [char| '~' |]
MathSymbol
>>> categorizeGeneral [char| 'w' |]
LowercaseLetter
>>> categorizeGeneral [char| '2' |]
DecimalNumber
>>> categorizeGeneral [char| '\0' |]
Control

Since: 1.0.0

The case of an ASCII character (if it has one).

Since: 1.0.0

Determine the case of an AsciiChar. Returns Nothing if the character doesn't have a case.

>>> caseOf [char| 'w' |]
Just Lower
>>> caseOf [char| 'W' |]
Just Upper
>>> caseOf [char| '~' |]
Nothing

Since: 1.0.0

A representation of the relationship between Char and AsciiChar.

>>> preview charWise 'w'
Just '0x77'
>>> preview charWise '😺'
Nothing
>>> review charWise [char| 'w' |]
'w'

Since: 1.0.0

A representation of the relationship between ASCII characters and bytes.

>>> preview byteWise 0x20
Just '0x20'
>>> preview byteWise 0x81
Nothing
>>> review byteWise [char| 'w' |]
119

Since: 1.0.0