Data.ASN1.Parse

asn1-parse-0.9.4: Simple monadic parser for ASN1 stream types.

License | BSD-style
Maintainer | Vincent Hanquez <vincent@snarc.org>
Stability | experimental
Portability | unknown
Safe Haskell | None
Language | Haskell98

Data.ASN1.Parse

Contents

- run
- combinators

Description

A parser combinator for ASN1 Stream.

Synopsis

- data ParseASN1 a
- runParseASN1State :: ParseASN1 a -> [ASN1] -> Either String (a, [ASN1])
- runParseASN1 :: ParseASN1 a -> [ASN1] -> Either String a
- throwParseError :: String -> ParseASN1 a
- onNextContainer :: ASN1ConstructionType -> ParseASN1 a -> ParseASN1 a
- onNextContainerMaybe :: ASN1ConstructionType -> ParseASN1 a -> ParseASN1 (Maybe a)
- getNextContainer :: ASN1ConstructionType -> ParseASN1 [ASN1]
- getNextContainerMaybe :: ASN1ConstructionType -> ParseASN1 (Maybe [ASN1])
- getNext :: ParseASN1 ASN1
- getNextMaybe :: (ASN1 -> Maybe a) -> ParseASN1 (Maybe a)
- hasNext :: ParseASN1 Bool
- getObject :: ASN1Object a => ParseASN1 a
- getMany :: ParseASN1 a -> ParseASN1 [a]

# Documentation

data ParseASN1 a

Instances

Monad ParseASN1 |
Functor ParseASN1 |
Applicative ParseASN1 |

# run

runParseASN1State :: ParseASN1 a -> [ASN1] -> Either String (a, [ASN1])

run the parse monad over a stream and returns the result and the remaining ASN1 Stream.

runParseASN1 :: ParseASN1 a -> [ASN1] -> Either String a

run the parse monad over a stream and returns the result.

If there's still some asn1 object in the state after calling f, an error will be raised.

throwParseError :: String -> ParseASN1 a

throw a parse error

# combinators

onNextContainer :: ASN1ConstructionType -> ParseASN1 a -> ParseASN1 a

run a function of the next elements of a container of specified type

onNextContainerMaybe :: ASN1ConstructionType -> ParseASN1 a -> ParseASN1 (Maybe a)

just like onNextContainer, except it doesn't throw an error if the container doesn't exists.

getNextContainer :: ASN1ConstructionType -> ParseASN1 [ASN1]

get next container of specified type and return all its elements

getNextContainerMaybe :: ASN1ConstructionType -> ParseASN1 (Maybe [ASN1])

just like getNextContainer, except it doesn't throw an error if the container doesn't exists.

getNext :: ParseASN1 ASN1

get next element from the stream

getNextMaybe :: (ASN1 -> Maybe a) -> ParseASN1 (Maybe a)

get next element from the stream maybe

hasNext :: ParseASN1 Bool

returns if there's more elements in the stream.

getObject :: ASN1Object a => ParseASN1 a

get next object

getMany :: ParseASN1 a -> ParseASN1 [a]

get many elements until there's nothing left