GI.GLib.Structs.ByteArray

Contains the public fields of a GByteArray.

Exported types

newtype ByteArray

Constructors

ByteArray (ManagedPtr ByteArray)

Instances

BoxedObject ByteArray

Methods

boxedType :: ByteArray -> IO GType

(~) AttrOpTag tag AttrSet => Constructible ByteArray tag

Methods

new :: MonadIO m => (ManagedPtr ByteArray -> ByteArray) -> [AttrOp ByteArray tag] -> m ByteArray

newZeroByteArray :: MonadIO m => m ByteArray

Construct a ByteArray struct initialized to zero.

noByteArray :: Maybe ByteArray

Methods

free

byteArrayFree

Arguments

:: (HasCallStack, MonadIO m)

=> ByteString

array: a ByteArray

-> Bool

freeSegment: if True the actual byte data is freed as well

-> m Word8

Returns: the element data if freeSegment is False, otherwise Nothing. The element data should be freed using free.

Frees the memory allocated by the ByteArray. If freeSegment is True it frees the actual byte data. If the reference count of array is greater than one, the ByteArray wrapper is preserved but the size of array will be set to zero.

freeToBytes

byteArrayFreeToBytes

Arguments

:: (HasCallStack, MonadIO m)

=> ByteString

array: a ByteArray

-> m Bytes

Returns: a new immutable Bytes representing same byte data that was in the array

Transfers the data from the ByteArray into a new immutable Bytes.

The ByteArray is freed unless the reference count of array is greater than one, the ByteArray wrapper is preserved but the size of array will be set to zero.

This is identical to using bytesNewTake and byteArrayFree together.

Since: 2.32

new

byteArrayNew

Arguments

:: (HasCallStack, MonadIO m)

=> m ByteString

Returns: the new ByteArray

Creates a new ByteArray with a reference count of 1.

newTake

byteArrayNewTake

Arguments

:: (HasCallStack, MonadIO m)

=> ByteString

data: byte data for the array

-> m ByteString

Returns: a new ByteArray

Create byte array containing the data. The data will be owned by the array and will be freed with free, i.e. it could be allocated using strdup.

Since: 2.32

unref

byteArrayUnref

Arguments

:: (HasCallStack, MonadIO m)

=> ByteString

array: A ByteArray

-> m ()

Atomically decrements the reference count of array by one. If the reference count drops to 0, all memory allocated by the array is released. This function is thread-safe and may be called from any thread.

Since: 2.22

Properties

data

getByteArrayData :: MonadIO m => ByteArray -> m Word8

setByteArrayData :: MonadIO m => ByteArray -> Word8 -> m ()

len

getByteArrayLen :: MonadIO m => ByteArray -> m Word32

setByteArrayLen :: MonadIO m => ByteArray -> Word32 -> m ()