Text.ParserCombinators.Parsec.Char

Commonly used character parsers.

Documentation

type CharParser st a = GenParser Char st a

spaces :: CharParser st ()

Skips zero or more white space characters. See also skipMany.

space :: CharParser st Char

Parses a white space character (any character which satisfies isSpace) Returns the parsed character.

newline :: CharParser st Char

Parses a newline character ('\n'). Returns a newline character.

tab :: CharParser st Char

Parses a tab character ('\t'). Returns a tab character.

upper :: CharParser st Char

Parses an upper case letter (a character between 'A' and 'Z'). Returns the parsed character.

lower :: CharParser st Char

Parses a lower case character (a character between 'a' and 'z'). Returns the parsed character.

alphaNum :: CharParser st Char

Parses a letter or digit (a character between '0' and '9'). Returns the parsed character.

letter :: CharParser st Char

Parses a letter (an upper case or lower case character). Returns the parsed character.

digit :: CharParser st Char

Parses a digit. Returns the parsed character.

hexDigit :: CharParser st Char

Parses a hexadecimal digit (a digit or a letter between 'a' and 'f' or 'A' and 'F'). Returns the parsed character.

octDigit :: CharParser st Char

Parses an octal digit (a character between '0' and '7'). Returns the parsed character.

char :: Char -> CharParser st Char

char c parses a single character c. Returns the parsed character (i.e. c).

 semiColon  = char ';'

string :: String -> CharParser st String

string s parses a sequence of characters given by s. Returns the parsed string (i.e. s).

 divOrMod    =   string "div"
             <|> string "mod"

anyChar :: CharParser st Char

This parser succeeds for any character. Returns the parsed character.

oneOf :: [Char] -> CharParser st Char

oneOf cs succeeds if the current character is in the supplied list of characters cs. Returns the parsed character. See also satisfy.

  vowel  = oneOf "aeiou"

noneOf :: [Char] -> CharParser st Char

As the dual of oneOf, noneOf cs succeeds if the current character not in the supplied list of characters cs. Returns the parsed character.

 consonant = noneOf "aeiou"

satisfy :: (Char -> Bool) -> CharParser st Char

The parser satisfy f succeeds for any character for which the supplied function f returns True. Returns the character that is actually parsed.

 digit     = satisfy isDigit
 oneOf cs  = satisfy (\c -> c `elem` cs)