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 #