Streamly.Internal.Unicode.Parser

To parse a text input, use the decode routines from Streamly.Unicode.Stream module to convert an input byte stream to a Unicode Char stream and then use these parsers on the Char stream.

Generic

char :: Monad m => Char -> Parser Char m Char

Match a specific character.

charIgnoreCase :: Monad m => Char -> Parser Char m Char

Match a specific character ignoring case.

Sequences

string :: Monad m => String -> Parser Char m String

Match the input with the supplied string and return it if successful.

stringIgnoreCase :: Monad m => String -> Parser Char m String

Match the input with the supplied string and return it if successful.

dropSpace :: Monad m => Parser Char m ()

Drop zero or more white space characters.

dropSpace1 :: Monad m => Parser Char m ()

Drop one or more white space characters.

Classes

alpha :: Monad m => Parser Char m Char

Match any character that satisfies isAlpha

alphaNum :: Monad m => Parser Char m Char

Match any character that satisfies isAlphaNum

letter :: Monad m => Parser Char m Char

Match any character that satisfies isLetter

ascii :: Monad m => Parser Char m Char

Match any character that satisfies isAscii

asciiLower :: Monad m => Parser Char m Char

Match any character that satisfies isAsciiLower

asciiUpper :: Monad m => Parser Char m Char

Match any character that satisfies isAsciiUpper

latin1 :: Monad m => Parser Char m Char

Match any character that satisfies isLatin1

lower :: Monad m => Parser Char m Char

Match any character that satisfies isLower

upper :: Monad m => Parser Char m Char

Match any character that satisfies isUpper

mark :: Monad m => Parser Char m Char

Match any character that satisfies isMark

printable :: Monad m => Parser Char m Char

Match any character that satisfies isPrint

punctuation :: Monad m => Parser Char m Char

Match any character that satisfies isPunctuation

separator :: Monad m => Parser Char m Char

Match any character that satisfies isSeparator

space :: Monad m => Parser Char m Char

Match any character that satisfies isSpace

symbol :: Monad m => Parser Char m Char

Match any character that satisfies isSymbol

digit :: Monad m => Parser Char m Char

Match any character that satisfies isDigit

octDigit :: Monad m => Parser Char m Char

Match any character that satisfies isOctDigit

hexDigit :: Monad m => Parser Char m Char

Match any character that satisfies isHexDigit

numeric :: Monad m => Parser Char m Char

Match any character that satisfies isNumber

Numeric

signed :: (Num a, Monad m) => Parser Char m a -> Parser Char m a

Allow an optional leading '+' or '-' sign character before any parser.

double :: Parser Char m Double

Parse a Double.

This parser accepts an optional leading sign character, followed by at most one decimal digit. The syntax is similar to that accepted by the read function, with the exception that a trailing '.' is consumed.

Examples

Examples with behaviour identical to read, if you feed an empty continuation to the first result:

IS.parse double (IS.fromList "3")     == 3.0
IS.parse double (IS.fromList "3.1")   == 3.1
IS.parse double (IS.fromList "3e4")   == 30000.0
IS.parse double (IS.fromList "3.1e4") == 31000.0
IS.parse double (IS.fromList "3e")    == 30

Examples with behaviour identical to read:

IS.parse (IS.fromList ".3")    == error "Parse failed"
IS.parse (IS.fromList "e3")    == error "Parse failed"

Example of difference from read:

IS.parse double (IS.fromList "3.foo") == 3.0

This function does not accept string representations of "NaN" or "Infinity".

Unimplemented

decimal :: (Monad m, Integral a) => Parser Char m a

Parse and decode an unsigned integral decimal number.

hexadecimal :: (Monad m, Integral a, Bits a) => Parser Char m a

Parse and decode an unsigned integral hexadecimal number. The hex digits 'a' through 'f' may be upper or lower case.

Note: This parser does not accept a leading "0x" string.