Struct UnsafeQueue<T>
An unmanaged queue.
Implements
Namespace: Unity.Collections
Assembly: Unity.Collections.dll
Syntax
public struct UnsafeQueue<T> : INativeDisposable where T : unmanagedType Parameters
| Name | Description |
|---|---|
| T | The type of the elements. |
Constructors
UnsafeQueue(AllocatorHandle)
Initializes and returns an instance of UnsafeQueue.
Declaration
public UnsafeQueue(AllocatorManager.AllocatorHandle allocator)Parameters
| Type | Name | Description |
|---|---|---|
| AllocatorManager.AllocatorHandle | allocator | The allocator to use. |
Properties
Count
Returns the current number of elements in this queue.
Declaration
public readonly int Count { get; }Property Value
| Type | Description |
|---|---|
| int | The current number of elements in this queue. |
Remarks
Note that getting the count requires traversing the queue's internal linked list of blocks. Where possible, cache this value instead of reading the property repeatedly.
IsCreated
Whether this queue has been allocated (and not yet deallocated).
Declaration
public readonly bool IsCreated { get; }Property Value
| Type | Description |
|---|---|
| bool | True if this queue has been allocated (and not yet deallocated). |
Methods
AsParallelWriter()
Returns a parallel writer for this queue.
Declaration
public UnsafeQueue<T>.ParallelWriter AsParallelWriter()Returns
| Type | Description |
|---|---|
| UnsafeQueue<T>.ParallelWriter | A parallel writer for this queue. |
AsReadOnly()
Returns a readonly version of this UnsafeQueue instance.
Declaration
public UnsafeQueue<T>.ReadOnly AsReadOnly()Returns
| Type | Description |
|---|---|
| UnsafeQueue<T>.ReadOnly | ReadOnly instance for this. |
Remarks
ReadOnly containers point to the same underlying data as the UnsafeQueue it is made from.
Clear()
Removes all elements of this queue.
Declaration
public void Clear()Dequeue()
Removes and returns the element at the end of this queue.
Declaration
public T Dequeue()Returns
| Type | Description |
|---|---|
| T | The element at the end of this queue. |
Exceptions
| Type | Condition |
|---|---|
| InvalidOperationException | Thrown if this queue is empty. |
Dispose()
Releases all resources (memory and safety handles).
Declaration
public void Dispose()Dispose(JobHandle)
Creates and schedules a job that releases all resources (memory and safety handles) of this queue.
Declaration
public JobHandle Dispose(JobHandle inputDeps)Parameters
| Type | Name | Description |
|---|---|---|
| JobHandle | inputDeps | The dependency for the new job. |
Returns
| Type | Description |
|---|---|
| JobHandle | The handle of the new job. The job depends upon |
Enqueue(T)
Adds an element at the front of this queue.
Declaration
public void Enqueue(T value)Parameters
| Type | Name | Description |
|---|---|---|
| T | value | The value to be enqueued. |
IsEmpty()
Returns true if this queue is empty.
Declaration
public readonly bool IsEmpty()Returns
| Type | Description |
|---|---|
| bool | True if this queue has no items or if the queue has not been constructed. |
Peek()
Returns the element at the end of this queue without removing it.
Declaration
public T Peek()Returns
| Type | Description |
|---|---|
| T | The element at the end of this queue. |
ToArray(AllocatorHandle)
Returns an array containing a copy of this queue's content.
Declaration
public NativeArray<T> ToArray(AllocatorManager.AllocatorHandle allocator)Parameters
| Type | Name | Description |
|---|---|---|
| AllocatorManager.AllocatorHandle | allocator | The allocator to use. |
Returns
| Type | Description |
|---|---|
| NativeArray<T> | An array containing a copy of this queue's content. The elements are ordered in the same order they were enqueued, e.g. the earliest enqueued element is copied to index 0 of the array. |
TryDequeue(out T)
Removes and outputs the element at the end of this queue.
Declaration
public bool TryDequeue(out T item)Parameters
| Type | Name | Description |
|---|---|---|
| T | item | Outputs the removed element. |
Returns
| Type | Description |
|---|---|
| bool | True if this queue was not empty. |