| 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 |
GI.GLib.Structs.Queue
Contents
Description
Contains the public fields of a [Queue][glib-Double-ended-Queues].
- newtype Queue = Queue (ManagedPtr Queue)
- newZeroQueue :: MonadIO m => m Queue
- noQueue :: Maybe Queue
- data QueueClearMethodInfo
- queueClear :: (HasCallStack, MonadIO m) => Queue -> m ()
- data QueueFreeMethodInfo
- queueFree :: (HasCallStack, MonadIO m) => Queue -> m ()
- data QueueFreeFullMethodInfo
- queueFreeFull :: (HasCallStack, MonadIO m) => Queue -> DestroyNotify -> m ()
- data QueueGetLengthMethodInfo
- queueGetLength :: (HasCallStack, MonadIO m) => Queue -> m Word32
- data QueueIndexMethodInfo
- queueIndex :: (HasCallStack, MonadIO m) => Queue -> Ptr () -> m Int32
- data QueueInitMethodInfo
- queueInit :: (HasCallStack, MonadIO m) => Queue -> m ()
- data QueueIsEmptyMethodInfo
- queueIsEmpty :: (HasCallStack, MonadIO m) => Queue -> m Bool
- data QueuePeekHeadMethodInfo
- queuePeekHead :: (HasCallStack, MonadIO m) => Queue -> m (Ptr ())
- data QueuePeekNthMethodInfo
- queuePeekNth :: (HasCallStack, MonadIO m) => Queue -> Word32 -> m (Ptr ())
- data QueuePeekTailMethodInfo
- queuePeekTail :: (HasCallStack, MonadIO m) => Queue -> m (Ptr ())
- data QueuePopHeadMethodInfo
- queuePopHead :: (HasCallStack, MonadIO m) => Queue -> m (Ptr ())
- data QueuePopNthMethodInfo
- queuePopNth :: (HasCallStack, MonadIO m) => Queue -> Word32 -> m (Ptr ())
- data QueuePopTailMethodInfo
- queuePopTail :: (HasCallStack, MonadIO m) => Queue -> m (Ptr ())
- data QueuePushHeadMethodInfo
- queuePushHead :: (HasCallStack, MonadIO m) => Queue -> Ptr () -> m ()
- data QueuePushNthMethodInfo
- queuePushNth :: (HasCallStack, MonadIO m) => Queue -> Ptr () -> Int32 -> m ()
- data QueuePushTailMethodInfo
- queuePushTail :: (HasCallStack, MonadIO m) => Queue -> Ptr () -> m ()
- data QueueRemoveMethodInfo
- queueRemove :: (HasCallStack, MonadIO m) => Queue -> Ptr () -> m Bool
- data QueueRemoveAllMethodInfo
- queueRemoveAll :: (HasCallStack, MonadIO m) => Queue -> Ptr () -> m Word32
- data QueueReverseMethodInfo
- queueReverse :: (HasCallStack, MonadIO m) => Queue -> m ()
- clearQueueHead :: MonadIO m => Queue -> m ()
- getQueueHead :: MonadIO m => Queue -> m [Ptr ()]
- queue_head :: AttrLabelProxy "head"
- setQueueHead :: MonadIO m => Queue -> Ptr (GList (Ptr ())) -> m ()
- getQueueLength :: MonadIO m => Queue -> m Word32
- queue_length :: AttrLabelProxy "length"
- setQueueLength :: MonadIO m => Queue -> Word32 -> m ()
- clearQueueTail :: MonadIO m => Queue -> m ()
- getQueueTail :: MonadIO m => Queue -> m [Ptr ()]
- queue_tail :: AttrLabelProxy "tail"
- setQueueTail :: MonadIO m => Queue -> Ptr (GList (Ptr ())) -> m ()
Exported types
Constructors
| Queue (ManagedPtr Queue) |
Instances
Methods
clear
data QueueClearMethodInfo Source #
Instances
| ((~) * signature (m ()), MonadIO m) => MethodInfo * QueueClearMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m () |
Removes all the elements in queue. If queue elements contain
dynamically-allocated memory, they should be freed first.
Since: 2.14
free
data QueueFreeMethodInfo Source #
Instances
| ((~) * signature (m ()), MonadIO m) => MethodInfo * QueueFreeMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m () |
Frees the memory allocated for the Queue. Only call this function
if queue was created with g_queue_new(). If queue elements contain
dynamically-allocated memory, they should be freed first.
If queue elements contain dynamically-allocated memory, you should
either use queueFreeFull or free them manually first.
freeFull
data QueueFreeFullMethodInfo Source #
Instances
| ((~) * signature (DestroyNotify -> m ()), MonadIO m) => MethodInfo * QueueFreeFullMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> DestroyNotify |
|
| -> m () |
Convenience method, which frees all the memory used by a Queue,
and calls the specified destroy function on every element's data.
Since: 2.32
getLength
data QueueGetLengthMethodInfo Source #
Instances
| ((~) * signature (m Word32), MonadIO m) => MethodInfo * QueueGetLengthMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m Word32 | Returns: the number of items in |
Returns the number of items in queue.
Since: 2.4
index
data QueueIndexMethodInfo Source #
Instances
| ((~) * signature (Ptr () -> m Int32), MonadIO m) => MethodInfo * QueueIndexMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> Ptr () |
|
| -> m Int32 | Returns: the position of the first element in |
Returns the position of the first element in queue which contains data.
Since: 2.4
init
data QueueInitMethodInfo Source #
Instances
| ((~) * signature (m ()), MonadIO m) => MethodInfo * QueueInitMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m () |
A statically-allocated Queue must be initialized with this function
before it can be used. Alternatively you can initialize it with
G_QUEUE_INIT. It is not necessary to initialize queues created with
g_queue_new().
Since: 2.14
isEmpty
data QueueIsEmptyMethodInfo Source #
Instances
| ((~) * signature (m Bool), MonadIO m) => MethodInfo * QueueIsEmptyMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m Bool | Returns: |
Returns True if the queue is empty.
peekHead
data QueuePeekHeadMethodInfo Source #
Instances
| ((~) * signature (m (Ptr ())), MonadIO m) => MethodInfo * QueuePeekHeadMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m (Ptr ()) | Returns: the data of the first element in the queue, or |
Returns the first element of the queue.
peekNth
data QueuePeekNthMethodInfo Source #
Instances
| ((~) * signature (Word32 -> m (Ptr ())), MonadIO m) => MethodInfo * QueuePeekNthMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> Word32 |
|
| -> m (Ptr ()) | Returns: the data for the |
Returns the n'th element of queue.
Since: 2.4
peekTail
data QueuePeekTailMethodInfo Source #
Instances
| ((~) * signature (m (Ptr ())), MonadIO m) => MethodInfo * QueuePeekTailMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m (Ptr ()) | Returns: the data of the last element in the queue, or |
Returns the last element of the queue.
popHead
data QueuePopHeadMethodInfo Source #
Instances
| ((~) * signature (m (Ptr ())), MonadIO m) => MethodInfo * QueuePopHeadMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m (Ptr ()) | Returns: the data of the first element in the queue, or |
Removes the first element of the queue and returns its data.
popNth
data QueuePopNthMethodInfo Source #
Instances
| ((~) * signature (Word32 -> m (Ptr ())), MonadIO m) => MethodInfo * QueuePopNthMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> Word32 |
|
| -> m (Ptr ()) | Returns: the element's data, or |
Removes the n'th element of queue and returns its data.
Since: 2.4
popTail
data QueuePopTailMethodInfo Source #
Instances
| ((~) * signature (m (Ptr ())), MonadIO m) => MethodInfo * QueuePopTailMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m (Ptr ()) | Returns: the data of the last element in the queue, or |
Removes the last element of the queue and returns its data.
pushHead
data QueuePushHeadMethodInfo Source #
Instances
| ((~) * signature (Ptr () -> m ()), MonadIO m) => MethodInfo * QueuePushHeadMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> Ptr () |
|
| -> m () |
Adds a new element at the head of the queue.
pushNth
data QueuePushNthMethodInfo Source #
Instances
| ((~) * signature (Ptr () -> Int32 -> m ()), MonadIO m) => MethodInfo * QueuePushNthMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> Ptr () |
|
| -> Int32 |
|
| -> m () |
Inserts a new element into queue at the given position.
Since: 2.4
pushTail
data QueuePushTailMethodInfo Source #
Instances
| ((~) * signature (Ptr () -> m ()), MonadIO m) => MethodInfo * QueuePushTailMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> Ptr () |
|
| -> m () |
Adds a new element at the tail of the queue.
remove
data QueueRemoveMethodInfo Source #
Instances
| ((~) * signature (Ptr () -> m Bool), MonadIO m) => MethodInfo * QueueRemoveMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> Ptr () |
|
| -> m Bool | Returns: |
Removes the first element in queue that contains data.
Since: 2.4
removeAll
data QueueRemoveAllMethodInfo Source #
Instances
| ((~) * signature (Ptr () -> m Word32), MonadIO m) => MethodInfo * QueueRemoveAllMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> Ptr () |
|
| -> m Word32 | Returns: the number of elements removed from |
Remove all elements whose data equals data from queue.
Since: 2.4
reverse
data QueueReverseMethodInfo Source #
Instances
| ((~) * signature (m ()), MonadIO m) => MethodInfo * QueueReverseMethodInfo Queue signature Source # | |
Arguments
| :: (HasCallStack, MonadIO m) | |
| => Queue |
|
| -> m () |
Reverses the order of the items in queue.
Since: 2.4
Properties
head
clearQueueHead :: MonadIO m => Queue -> m () Source #
queue_head :: AttrLabelProxy "head" Source #
length
queue_length :: AttrLabelProxy "length" Source #
tail
clearQueueTail :: MonadIO m => Queue -> m () Source #
queue_tail :: AttrLabelProxy "tail" Source #