Copyright | Will Thompson, Iñaki García Etxebarria and Jonas Platte |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria (garetxe@gmail.com) |
Safe Haskell | None |
Language | Haskell2010 |
A simple refcounted data type representing an immutable sequence of zero or more bytes from an unspecified origin.
The purpose of a #GBytes is to keep the memory region that it holds alive for as long as anyone holds a reference to the bytes. When the last reference count is dropped, the memory is released. Multiple unrelated callers can use byte data in the #GBytes without coordinating their activities, resting assured that the byte data will not change or move while they hold a reference.
A #GBytes can come from many different origins that may have different procedures for freeing the memory region. Examples are memory from g_malloc(), from memory slices, from a #GMappedFile or memory from other allocators.
GHashTable. Use g_bytes_equal() and g_bytes_hash() as parameters to g_hash_table_new() or g_hash_table_new_full(). GTree by passing the g_bytes_compare() function to g_tree_new().
The data pointed to by this bytes must not be modified. For a mutable array of bytes see #GByteArray. Use g_bytes_unref_to_array() to create a mutable array for a GBytes from a mutable #GByteArray, use the g_byte_array_free_to_bytes() function.
- newtype Bytes = Bytes (ForeignPtr Bytes)
- noBytes :: Maybe Bytes
- bytesCompare :: MonadIO m => Bytes -> Bytes -> m Int32
- bytesEqual :: MonadIO m => Bytes -> Bytes -> m Bool
- bytesGetData :: MonadIO m => Bytes -> m ByteString
- bytesGetSize :: MonadIO m => Bytes -> m Word64
- bytesHash :: MonadIO m => Bytes -> m Word32
- bytesNew :: MonadIO m => Maybe ByteString -> m Bytes
- bytesNewFromBytes :: MonadIO m => Bytes -> Word64 -> Word64 -> m Bytes
- bytesNewTake :: MonadIO m => Maybe ByteString -> m Bytes
- bytesRef :: MonadIO m => Bytes -> m Bytes
- bytesUnref :: MonadIO m => Bytes -> m ()
- bytesUnrefToArray :: MonadIO m => Bytes -> m ByteString
- bytesUnrefToData :: MonadIO m => Bytes -> Word64 -> m ()
Exported types
Methods
bytesCompare
bytesEqual
bytesGetData
bytesGetData :: MonadIO m => Bytes -> m ByteString Source
bytesGetSize
bytesGetSize :: MonadIO m => Bytes -> m Word64 Source
bytesHash
bytesNew
bytesNewFromBytes
bytesNewTake
bytesNewTake :: MonadIO m => Maybe ByteString -> m Bytes Source
bytesRef
bytesUnref
bytesUnref :: MonadIO m => Bytes -> m () Source
bytesUnrefToArray
bytesUnrefToArray :: MonadIO m => Bytes -> m ByteString Source
bytesUnrefToData
bytesUnrefToData :: MonadIO m => Bytes -> Word64 -> m () Source