Safe Haskell	Safe-Inferred
Language	GHC2021

Data.Binary.ULEB128

Contents

Put
Get
ByteString
- Lazy
- Short

Description

Unsigned LEB128 codec. This codec encodes an unsigned number as described here.

Any getXXX decoder can decode bytes generated using any of the putXXX encoders, provided the encoded number fits in the target type.

WARNING: This is not compatible with the Signed LEB128 codec at Data.Binary.SLEB128 nor with the ZigZag LEB128 codec at Data.Binary.ZLEB128.

Synopsis

newtype ULEB128 x = ULEB128 x
putNatural :: Natural -> Put
putWord64 :: Word64 -> Put
putWord32 :: Word32 -> Put
putWord16 :: Word16 -> Put
putWord8 :: Word8 -> Put
putWord :: Word -> Put
getNatural :: Int -> Get Natural
getWord64 :: Get Word64
getWord32 :: Get Word32
getWord16 :: Get Word16
getWord8 :: Get Word8
getWord :: Get Word
getInteger :: Int -> Get Integer
getInt64 :: Get Int64
getInt32 :: Get Int32
getInt16 :: Get Int16
getInt8 :: Get Int8
getInt :: Get Int
putByteString :: ByteString -> Put
getByteString :: Get ByteString
putLazyByteString :: ByteString -> Put
getLazyByteString :: Get ByteString
putShortByteString :: ShortByteString -> Put
getShortByteString :: Get ShortByteString

Documentation

newtype ULEB128 x Source #

Newtype wrapper for Binary encoding and decoding x using the Unsigned LEB128 codec. Useful in conjunction with DerivingVia.

Constructors

ULEB128 x

Instances

Instances details

(DecodeOnly "getInt16" :: Constraint) => Binary (ULEB128 Int16) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Int16 -> Put # get :: Get (ULEB128 Int16) # putList :: [ULEB128 Int16] -> Put #
(DecodeOnly "getInt32" :: Constraint) => Binary (ULEB128 Int32) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Int32 -> Put # get :: Get (ULEB128 Int32) # putList :: [ULEB128 Int32] -> Put #
(DecodeOnly "getInt64" :: Constraint) => Binary (ULEB128 Int64) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Int64 -> Put # get :: Get (ULEB128 Int64) # putList :: [ULEB128 Int64] -> Put #
(DecodeOnly "getInt8" :: Constraint) => Binary (ULEB128 Int8) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Int8 -> Put # get :: Get (ULEB128 Int8) # putList :: [ULEB128 Int8] -> Put #
Binary (ULEB128 Word16) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Word16 -> Put # get :: Get (ULEB128 Word16) # putList :: [ULEB128 Word16] -> Put #
Binary (ULEB128 Word32) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Word32 -> Put # get :: Get (ULEB128 Word32) # putList :: [ULEB128 Word32] -> Put #
Binary (ULEB128 Word64) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Word64 -> Put # get :: Get (ULEB128 Word64) # putList :: [ULEB128 Word64] -> Put #
Binary (ULEB128 Word8) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Word8 -> Put # get :: Get (ULEB128 Word8) # putList :: [ULEB128 Word8] -> Put #
(DecodeOnly "getInteger" :: Constraint) => Binary (ULEB128 Integer) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Integer -> Put # get :: Get (ULEB128 Integer) # putList :: [ULEB128 Integer] -> Put #
Binary (ULEB128 Natural) Source #	Note: Maximum allowed number of input bytes is restricted to 1024. Use `putNatural` if you want a greater limit.
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Natural -> Put # get :: Get (ULEB128 Natural) # putList :: [ULEB128 Natural] -> Put #
(DecodeOnly "getInt" :: Constraint) => Binary (ULEB128 Int) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Int -> Put # get :: Get (ULEB128 Int) # putList :: [ULEB128 Int] -> Put #
Binary (ULEB128 Word) Source #
Instance details Defined in Data.Binary.ULEB128 Methods put :: ULEB128 Word -> Put # get :: Get (ULEB128 Word) # putList :: [ULEB128 Word] -> Put #

Put

putNatural :: Natural -> Put Source #

putWord64 :: Word64 -> Put Source #

putWord32 :: Word32 -> Put Source #

putWord16 :: Word16 -> Put Source #

putWord8 :: Word8 -> Put Source #

putWord :: Word -> Put Source #

Get

getNatural Source #

Arguments

:: Int

Maximum number of bytes to consume. If the Natural number can be determined before consuming this number of bytes, it will be. If 0, parsing fails.

Each ULEB128 byte encodes at most 7 bits of data. That is, \(length(encoded) == \lceil\frac{length(data)}{7}\rceil\).

-> Get Natural

getWord64 :: Get Word64 Source #

getWord32 :: Get Word32 Source #

getWord16 :: Get Word16 Source #

getWord8 :: Get Word8 Source #

getWord :: Get Word Source #

getInteger Source #

Arguments

:: Int

Maximum number of bytes to consume. If the Integer number can be determined before consuming this number of bytes, it will be. If 0, parsing fails.

Each ULEB128 byte encodes at most 7 bits of data. That is, \(length(encoded) == \lceil\frac{length(data)}{7}\rceil\).

-> Get Integer

getInt64 :: Get Int64 Source #

getInt32 :: Get Int32 Source #

getInt16 :: Get Int16 Source #

getInt8 :: Get Int8 Source #

getInt :: Get Int Source #