Cabal-3.2.1.0: A framework for packaging Haskell software
Copyright (c) Edward Kmett 2011
License BSD3
Maintainer ekmett@gmail.com
Stability experimental
Portability non-portable
Safe Haskell None
Language Haskell2010

Distribution.Compat.CharParsing

Description

Parsers for character streams

Originally in parsers package.

Synopsis

Combinators

oneOf :: CharParsing m => [ Char ] -> m Char Source #

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 :: CharParsing m => [ Char ] -> m Char Source #

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

 consonant = noneOf "aeiou"

spaces :: CharParsing m => m () Source #

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

space :: CharParsing m => m Char Source #

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

newline :: CharParsing m => m Char Source #

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

tab :: CharParsing m => m Char Source #

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

upper :: CharParsing m => m Char Source #

Parses an upper case letter. Returns the parsed character.

lower :: CharParsing m => m Char Source #

Parses a lower case character. Returns the parsed character.

alphaNum :: CharParsing m => m Char Source #

Parses a letter or digit. Returns the parsed character.

letter :: CharParsing m => m Char Source #

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

digit :: CharParsing m => m Char Source #

Parses a digit. Returns the parsed character.

hexDigit :: CharParsing m => m Char Source #

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

octDigit :: CharParsing m => m Char Source #

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

Class

class Parsing m => CharParsing m where Source #

Additional functionality needed to parse character streams.

Minimal complete definition

satisfy

Methods

satisfy :: ( Char -> Bool ) -> m Char Source #

Parse a single character of the input, with UTF-8 decoding

char :: Char -> m Char Source #

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

e.g.

semiColon = char ';'

notChar :: Char -> m Char Source #

notChar c parses any single character other than c . Returns the parsed character.

anyChar :: m Char Source #

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

string :: String -> m String Source #

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

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

text :: Text -> m Text Source #

text t parses a sequence of characters determined by the text t Returns the parsed text fragment (i.e. t ).

Using OverloadedStrings :

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

Instances

Instances details
CharParsing ParsecParser Source #
Instance details

Defined in Distribution.Parsec

( CharParsing m, MonadPlus m) => CharParsing ( IdentityT m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

( CharParsing m, MonadPlus m) => CharParsing ( ReaderT e m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

( CharParsing m, MonadPlus m) => CharParsing ( StateT s m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

( CharParsing m, MonadPlus m) => CharParsing ( StateT s m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

( CharParsing m, MonadPlus m, Monoid w) => CharParsing ( WriterT w m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

( CharParsing m, MonadPlus m, Monoid w) => CharParsing ( WriterT w m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

Stream s m Char => CharParsing ( ParsecT s u m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

( CharParsing m, MonadPlus m, Monoid w) => CharParsing ( RWST r w s m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

( CharParsing m, MonadPlus m, Monoid w) => CharParsing ( RWST r w s m) Source #
Instance details

Defined in Distribution.Compat.CharParsing

Cabal additions

munch1 :: CharParsing m => ( Char -> Bool ) -> m String Source #

Greedily munch characters while predicate holds. Require at least one character.

munch :: CharParsing m => ( Char -> Bool ) -> m String Source #

Greedely munch characters while predicate holds. Always succeeds.