Selects Unicode character with a numeric value.

Note: a character may have a numeric value but return False with the predicate isNumber, because isNumber only tests GeneralCategory: some CJK characters are OtherLetter and do have a numeric value.

isNumeric c == isJust (numericValue c)

Since: 0.3.1

Selects Unicode numeric characters, including digits from various scripts, Roman numerals, et cetera.

This function returns True if its argument has one of the following GeneralCategorys, or False otherwise:

• DecimalNumber
• LetterNumber
• OtherNumber

Note: a character may have a numeric value (see numericValue) but return False, because isNumber only tests GeneralCategory: some CJK characters are OtherLetter and do have a numeric value. Use isNumeric to cover those cases as well.

isNumber c == Data.Char.isNumber c

Since: 0.3.0

Numeric value of a character, if relevant.

Note: a character may have a numeric value but return False with the predicate isNumber, because isNumber only tests GeneralCategory: some CJK characters are OtherLetter and do have a numeric value.

Since: 0.3.1

Integer value of a character, if relevant.

This is a special case of numericValue.

Warning: There is a risk of integer overflow depending of the chosen concrete return type. As of Unicode 15.0 the results range from 0 to 1e12.

>>> integerValue '\x5146' :: Maybe Int64 -- OK
Just 1000000000000
>>> integerValue '\x5146' :: Maybe Int32 -- Will overflow!
Just (-727379968)

Therefore it is advised to use: integerValue @Int64.

Note: A character may have a numeric value but return False with the predicate isNumber, because isNumber only tests GeneralCategory: some CJK characters are OtherLetter and do have a numeric value.

Since: 0.3.1

Selects ASCII digits, i.e. '0'..'9'.

Selects ASCII octal digits, i.e. '0'..'7'.

Selects ASCII hexadecimal digits, i.e. '0'..'9', 'a'..'f', 'A'..'F'.

Convert a single digit Char to the corresponding Int. This function fails unless its argument satisfies isHexDigit, but recognises both upper- and lower-case hexadecimal digits (that is, '0'..'9', 'a'..'f', 'A'..'F').

Examples

>>> map digitToInt ['0'..'9']
[0,1,2,3,4,5,6,7,8,9]

>>> map digitToInt ['a'..'f']
[10,11,12,13,14,15]
>>> map digitToInt ['A'..'F']
[10,11,12,13,14,15]

>>> digitToInt 'G'
*** Exception: Char.digitToInt: not a digit 'G'
>>> digitToInt '♥'
*** Exception: Char.digitToInt: not a digit '\9829'

Convert an Int in the range 0..15 to the corresponding single digit Char. This function fails on other inputs, and generates lower-case hexadecimal digits.