zlib-bindings 0.1.1.2 → 0.1.1.3
raw patch · 2 files changed
+15/−13 lines, 2 files
Files
- Codec/Zlib.hs +14/−12
- zlib-bindings.cabal +1/−1
Codec/Zlib.hs view
@@ -156,10 +156,10 @@ c_set_avail_out zstr buff $ fromIntegral defaultChunkSize return $ Deflate (fzstr, fbuff) --- | Feed the given 'S.ByteString' to the inflater. This function takes a--- function argument which takes a \"popper\". A popper is an IO action that--- will return the next bit of inflated data, returning 'Nothing' when there is--- no more data to be popped.+-- | Feed the given 'S.ByteString' to the inflater. Return a 'Popper',+-- an IO action that returns the decompressed data a chunk at a time.+-- The 'Popper' must be called to exhaustion before using the 'Inflate'+-- object again. -- -- Note that this function automatically buffers the output to -- 'defaultChunkSize', and therefore you won't get any data from the popper@@ -186,6 +186,8 @@ inflateDictionary else return res +-- | An IO action that returns the next chunk of data, returning 'Nothing' when+-- there is no more data to be popped. type Popper = IO (Maybe S.ByteString) -- | Ensure that the given @ByteString@ is not deallocated.@@ -242,10 +244,10 @@ flushInflate :: Inflate -> IO S.ByteString flushInflate = finishInflate --- | Feed the given 'S.ByteString' to the deflater. This function takes a--- function argument which takes a \"popper\". A popper is an IO action that--- will return the next bit of deflated data, returning 'Nothing' when there is--- no more data to be popped.+-- | Feed the given 'S.ByteString' to the deflater. Return a 'Popper',+-- an IO action that returns the compressed data a chunk at a time.+-- The 'Popper' must be called to exhaustion before using the 'Deflate'+-- object again. -- -- Note that this function automatically buffers the output to -- 'defaultChunkSize', and therefore you won't get any data from the popper@@ -261,16 +263,16 @@ -- | As explained in 'feedDeflate', deflation buffers your compressed -- data. After you call 'feedDeflate' with your last chunk of uncompressed--- data, we need to flush the rest of the data waiting to be deflated. This--- function takes a function parameter which accepts a \"popper\", just like--- 'feedDeflate'.+-- data, use this to flush the rest of the data and signal end of input. finishDeflate :: Deflate -> Popper finishDeflate (Deflate (fzstr, fbuff)) = drain fbuff fzstr Nothing c_call_deflate_finish True -- | Flush the deflation buffer. Useful for interactive application.--- -- Internally this passes Z_SYNC_FLUSH to the zlib library.+--+-- Unlike 'finishDeflate', 'flushDeflate' does not signal end of input,+-- meaning you can feed more uncompressed data afterward. -- -- Since 0.0.3 flushDeflate :: Deflate -> Popper
zlib-bindings.cabal view
@@ -1,5 +1,5 @@ name: zlib-bindings-version: 0.1.1.2+version: 0.1.1.3 license: BSD3 license-file: LICENSE author: Michael Snoyman <michael@snoyman.com>