Safe Haskell | None |
---|---|
Language | Haskell2010 |
- data SuperBuffer
- withBuffer :: Int64 -> (SuperBuffer -> IO ()) -> IO ByteString
- appendBuffer :: SuperBuffer -> ByteString -> IO ()
Documentation
data SuperBuffer Source #
The buffer. Internally only a pointer to a C struct. Don't worry, this module attempts to make usage of the SuperBuffer as safe as possible in terms of memory leaks (with exceptions).
withBuffer :: Int64 -> (SuperBuffer -> IO ()) -> IO ByteString Source #
Allocate a new buffer with a given initial size. The perfect starting point
depends on the expected total size and the average size for a single chunk
written with appendBuffer
. You can always start with 1024 and optimize from
there with benchmarks. Please note that the SuperBuffer will no longer be
valid after this function terminates, so do NOT pass it to some other
thread without waiting for it to finish in the action.
appendBuffer :: SuperBuffer -> ByteString -> IO () Source #
Write a bytestring to the buffer and grow the buffer if needed. Note that only
one thread at any given time may call this function, so if you are sharing the
SuperBuffer
between threads make sure you place some type of guarding/locking around
this function.