GI.GLib.Structs.Bytes

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.

Exported types

newtype Bytes

Constructors

Bytes (ManagedPtr Bytes)

Instances

BoxedObject Bytes

Methods

boxedType :: Bytes -> IO GType

((~) * info (ResolveBytesMethod t Bytes), MethodInfo * info Bytes p) => IsLabel t (Bytes -> p)

Methods

fromLabel :: Proxy# Symbol t -> Bytes -> p

((~) * info (ResolveBytesMethod t Bytes), MethodInfo * info Bytes p) => IsLabelProxy t (Bytes -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> Bytes -> p

HasAttributeList * Bytes

((~) * signature (m ByteString), MonadIO m) => MethodInfo * BytesUnrefToDataMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesUnrefToDataMethodInfo Bytes -> signature -> s

((~) * signature (m ByteString), MonadIO m) => MethodInfo * BytesUnrefToArrayMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesUnrefToArrayMethodInfo Bytes -> signature -> s

((~) * signature (m ()), MonadIO m) => MethodInfo * BytesUnrefMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesUnrefMethodInfo Bytes -> signature -> s

((~) * signature (m Bytes), MonadIO m) => MethodInfo * BytesRefMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesRefMethodInfo Bytes -> signature -> s

((~) * signature (Word64 -> Word64 -> m Bytes), MonadIO m) => MethodInfo * BytesNewFromBytesMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesNewFromBytesMethodInfo Bytes -> signature -> s

((~) * signature (m Word32), MonadIO m) => MethodInfo * BytesHashMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesHashMethodInfo Bytes -> signature -> s

((~) * signature (m Word64), MonadIO m) => MethodInfo * BytesGetSizeMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesGetSizeMethodInfo Bytes -> signature -> s

((~) * signature (m (Maybe ByteString)), MonadIO m) => MethodInfo * BytesGetDataMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesGetDataMethodInfo Bytes -> signature -> s

((~) * signature (Bytes -> m Bool), MonadIO m) => MethodInfo * BytesEqualMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesEqualMethodInfo Bytes -> signature -> s

((~) * signature (Bytes -> m Int32), MonadIO m) => MethodInfo * BytesCompareMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesCompareMethodInfo Bytes -> signature -> s

type AttributeList Bytes

type AttributeList Bytes

noBytes :: Maybe Bytes

Methods

compare

data BytesCompareMethodInfo

Instances

((~) * signature (Bytes -> m Int32), MonadIO m) => MethodInfo * BytesCompareMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesCompareMethodInfo Bytes -> signature -> s

bytesCompare :: MonadIO m => Bytes -> Bytes -> m Int32

equal

data BytesEqualMethodInfo

Instances

((~) * signature (Bytes -> m Bool), MonadIO m) => MethodInfo * BytesEqualMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesEqualMethodInfo Bytes -> signature -> s

bytesEqual :: MonadIO m => Bytes -> Bytes -> m Bool

getData

data BytesGetDataMethodInfo

Instances

((~) * signature (m (Maybe ByteString)), MonadIO m) => MethodInfo * BytesGetDataMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesGetDataMethodInfo Bytes -> signature -> s

bytesGetData :: MonadIO m => Bytes -> m (Maybe ByteString)

getSize

data BytesGetSizeMethodInfo

Instances

((~) * signature (m Word64), MonadIO m) => MethodInfo * BytesGetSizeMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesGetSizeMethodInfo Bytes -> signature -> s

bytesGetSize :: MonadIO m => Bytes -> m Word64

hash

data BytesHashMethodInfo

Instances

((~) * signature (m Word32), MonadIO m) => MethodInfo * BytesHashMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesHashMethodInfo Bytes -> signature -> s

bytesHash :: MonadIO m => Bytes -> m Word32

new

bytesNew :: MonadIO m => Maybe ByteString -> m Bytes

newFromBytes

data BytesNewFromBytesMethodInfo

Instances

((~) * signature (Word64 -> Word64 -> m Bytes), MonadIO m) => MethodInfo * BytesNewFromBytesMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesNewFromBytesMethodInfo Bytes -> signature -> s

bytesNewFromBytes :: MonadIO m => Bytes -> Word64 -> Word64 -> m Bytes

newTake

bytesNewTake :: MonadIO m => Maybe ByteString -> m Bytes

ref

data BytesRefMethodInfo

Instances

((~) * signature (m Bytes), MonadIO m) => MethodInfo * BytesRefMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesRefMethodInfo Bytes -> signature -> s

bytesRef :: MonadIO m => Bytes -> m Bytes

unref

data BytesUnrefMethodInfo

Instances

((~) * signature (m ()), MonadIO m) => MethodInfo * BytesUnrefMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesUnrefMethodInfo Bytes -> signature -> s

bytesUnref :: MonadIO m => Bytes -> m ()

unrefToArray

data BytesUnrefToArrayMethodInfo

Instances

((~) * signature (m ByteString), MonadIO m) => MethodInfo * BytesUnrefToArrayMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesUnrefToArrayMethodInfo Bytes -> signature -> s

bytesUnrefToArray :: MonadIO m => Bytes -> m ByteString

unrefToData

data BytesUnrefToDataMethodInfo

Instances

((~) * signature (m ByteString), MonadIO m) => MethodInfo * BytesUnrefToDataMethodInfo Bytes signature

Methods

overloadedMethod :: MethodProxy BytesUnrefToDataMethodInfo Bytes -> signature -> s

bytesUnrefToData :: MonadIO m => Bytes -> m ByteString