Haskoin.Util

This module defines various utility functions used across the library.

ByteString Helpers

bsToInteger :: ByteString -> Integer

Decode a big endian Integer from a ByteString.

integerToBS :: Integer -> ByteString

Encode an Integer to a ByteString as big endian.

hexBuilder :: ByteString -> Builder

encodeHex :: ByteString -> Text

encodeHexLazy :: ByteString -> Text

Encode as string of human-readable hex characters.

decodeHex :: Text -> Maybe ByteString

decodeHexLazy :: Text -> Maybe ByteString

Decode string of human-readable hex characters.

getBits :: Int -> ByteString -> ByteString

Obtain Int bits from beginning of ByteString. Resulting ByteString will be smallest required to hold that many bits, padded with zeroes to the right.

Maybe & Either Helpers

eitherToMaybe :: Either a b -> Maybe b

Transform an Either value into a Maybe value. Right is mapped to Just and Left is mapped to Nothing. The value inside Left is lost.

maybeToEither :: b -> Maybe a -> Either b a

Transform a Maybe value into an Either value. Just is mapped to Right and Nothing is mapped to Left. Default Left required.

liftEither :: MonadError e m => Either e a -> m a

Lifts an Either e into any MonadError e.

do { val <- liftEither =<< action1; action2 }

where action1 returns an Either to represent errors.

Since: mtl-2.2.2

liftMaybe :: Monad m => b -> Maybe a -> ExceptT b m a

Lift a Maybe computation into the ExceptT monad.

Other Helpers

updateIndex

Arguments

:: Int

index of the element to change

-> [a]

list of elements

-> (a -> a)

function to apply

-> [a]

result with one element changed

Applies a function to only one element of a list defined by its index. If the index is out of the bounds of the list, the original list is returned.

matchTemplate

Arguments

:: [a]

input list

-> [b]

list to serve as a template

-> (a -> b -> Bool)

comparison function

-> [Maybe a]

Use the list [b] as a template and try to match the elements of [a] against it. For each element of [b] return the (first) matching element of [a], or Nothing. Output list has same size as [b] and contains results in same order. Elements of [a] can only appear once.

convertBits :: Bool -> Int -> Int -> [Word] -> ([Word], Bool)

Convert from one power-of-two base to another, as long as it fits in a Word.

Triples

fst3 :: (a, b, c) -> a

Returns the first value of a triple.

snd3 :: (a, b, c) -> b

Returns the second value of a triple.

lst3 :: (a, b, c) -> c

Returns the last value of a triple.

JSON Utilities

dropFieldLabel :: Int -> Options

Field label goes lowercase and first n characters get removed.

dropSumLabels :: Int -> Int -> String -> Options

Transformation from dropFieldLabel is applied with argument f, plus constructor tags are lowercased and first c characters removed. tag is used as the name of the object field name that will hold the transformed constructor tag as its value.

Serialization Helpers

putList :: MonadPut m => (a -> m ()) -> [a] -> m ()

getList :: MonadGet m => m a -> m [a]

putMaybe :: MonadPut m => (a -> m ()) -> Maybe a -> m ()

getMaybe :: MonadGet m => m a -> m (Maybe a)

putLengthBytes :: MonadPut m => ByteString -> m ()

getLengthBytes :: MonadGet m => m ByteString

putInteger :: MonadPut m => Integer -> m ()

getInteger :: MonadGet m => m Integer

putInt32be :: MonadPut m => Int32 -> m ()

getInt32be :: MonadGet m => m Int32

putInt64be :: MonadPut m => Int64 -> m ()

getInt64be :: MonadGet m => m Int64

getIntMap :: MonadGet m => m Int -> m a -> m (IntMap a)

Read as a list of pairs of int and element.

putIntMap :: MonadPut m => (Int -> m ()) -> (a -> m ()) -> IntMap a -> m ()

getTwo :: MonadGet m => m a -> m b -> m (a, b)

putTwo :: MonadPut m => (a -> m ()) -> (b -> m ()) -> (a, b) -> m ()