Copyright	Bryan O'Sullivan 2007-2015 Winterland 2016
License	BSD3
Maintainer	drkoster@qq.com
Stability	experimental
Portability	unknown
Safe Haskell	Safe-Inferred
Language	Haskell2010

Data.Binary.Parser.Char8

Description

This module is intended for parsing text that is represented using an 8-bit character set, e.g. ASCII or ISO-8859-15. It does not make any attempt to deal with character encodings, multibyte characters, or wide characters. In particular, all attempts to use characters above code point U+00FF will give wrong answers.

Code points below U+0100 are simply translated to and from their numeric values, so e.g. the code point U+00A4 becomes the byte 0xA4 (which is the Euro symbol in ISO-8859-15, but the generic currency sign in ISO-8859-1). Haskell Char values above U+00FF are truncated, so e.g. U+1D6B7 is truncated to the byte 0xB7.

Synopsis

peekMaybe :: Get (Maybe Char)
peek :: Get Char
satisfy :: (Char -> Bool) -> Get Char
satisfyWith :: (Char -> a) -> (a -> Bool) -> Get a
char :: Char -> Get ()
anyChar :: Get Char
skipChar :: (Char -> Bool) -> Get ()
takeTill :: (Char -> Bool) -> Get ByteString
takeWhile :: (Char -> Bool) -> Get ByteString
takeWhile1 :: (Char -> Bool) -> Get ByteString
skipWhile :: (Char -> Bool) -> Get ()
stringCI :: ByteString -> Get ByteString
isSpace :: Char -> Bool
isDigit :: Char -> Bool
isHexDigit :: Char -> Bool
isHorizontalSpace :: Char -> Bool
isEndOfLine :: Char -> Bool

Documentation

peekMaybe :: Get (Maybe Char) Source #

Match any char, to perform lookahead. Returns Nothing if end of input has been reached. Does not consume any input.

peek :: Get Char Source #

Match any char, to perform lookahead. Does not consume any input, but will fail if end of input has been reached.

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

The parser satisfy p succeeds for any char for which the predicate p returns True. Returns the char that is actually parsed.

satisfyWith :: (Char -> a) -> (a -> Bool) -> Get a Source #

The parser satisfyWith f p transforms a char, and succeeds if the predicate p returns True on the transformed value. The parser returns the transformed char that was parsed.

char :: Char -> Get () Source #

Match a specific character.

anyChar :: Get Char Source #

Match any character.

skipChar :: (Char -> Bool) -> Get () Source #

The parser skipChar p succeeds for any char for which the predicate p returns True.

takeTill :: (Char -> Bool) -> Get ByteString Source #

Consume input as long as the predicate returns False or reach the end of input, and return the consumed input.

takeWhile :: (Char -> Bool) -> Get ByteString Source #

Consume input as long as the predicate returns True or reach the end of input, and return the consumed input.

takeWhile1 :: (Char -> Bool) -> Get ByteString Source #

skipWhile :: (Char -> Bool) -> Get () Source #

Skip past input for as long as the predicate returns True.

stringCI :: ByteString -> Get ByteString Source #

Satisfy a literal string but ignoring case.

isSpace :: Char -> Bool Source #

Fast predicate for matching ASCII space characters.

Note: This predicate only gives correct answers for the ASCII encoding. For instance, it does not recognise U+00A0 (non-breaking space) as a space character, even though it is a valid ISO-8859-15 byte. For a Unicode-aware and only slightly slower predicate, use isSpace

isDigit :: Char -> Bool Source #

Decimal digit predicate.

isHexDigit :: Char -> Bool Source #

Hex digit predicate.

isHorizontalSpace :: Char -> Bool Source #

A predicate that matches either a space ' ' or horizontal tab '\t' character.

isEndOfLine :: Char -> Bool Source #

A predicate that matches either a carriage return '\r' or newline '\n' character.