Class CollectionHelper

Provides helper methods for collections.

Inheritance

Object

CollectionHelper

Namespace: Unity.Collections

Syntax

public static class CollectionHelper : object

Fields

CacheLineSize

The size in bytes of the current platform's L1 cache lines.

Declaration

public const int CacheLineSize = null

Field Value

Type	Description
Int32	The size in bytes of the current platform's L1 cache lines.

Methods

Align(Int32, Int32)

Returns an allocation size in bytes that factors in alignment.

Declaration

public static int Align(int size, int alignmentPowerOfTwo)

Parameters

Type	Name	Description
Int32	size	The size to align.
Int32	alignmentPowerOfTwo	A non-zero, positive power of two.

Returns

Type	Description
Int32	The smallest integer that is greater than or equal to size and is a multiple of alignmentPowerOfTwo.

Examples

    // 55 aligned to 16 is 64.
    int size = CollectionHelper.Align(55, 16);

Align(UInt64, UInt64)

Returns an allocation size in bytes that factors in alignment.

Declaration

public static ulong Align(ulong size, ulong alignmentPowerOfTwo)

Parameters

Type	Name	Description
UInt64	size	The size to align.
UInt64	alignmentPowerOfTwo	A non-zero, positive power of two.

Returns

Type	Description
UInt64	The smallest integer that is greater than or equal to size and is a multiple of alignmentPowerOfTwo.

Examples

    // 55 aligned to 16 is 64.
    ulong size = CollectionHelper.Align(55, 16);

CreateNativeArray<T>(T[], AllocatorManager.AllocatorHandle)

Declaration

public static NativeArray<T> CreateNativeArray<T>(T[] array, AllocatorManager.AllocatorHandle allocator)
    where T : struct

Parameters

Type	Name	Description
T[]	array
AllocatorManager.AllocatorHandle	allocator

Returns

Type	Description
NativeArray<T>

Type Parameters

Name	Description
T

CreateNativeArray<T>(NativeArray<T>, AllocatorManager.AllocatorHandle)

Declaration

public static NativeArray<T> CreateNativeArray<T>(NativeArray<T> array, AllocatorManager.AllocatorHandle allocator)
    where T : struct

Parameters

Type	Name	Description
NativeArray<T>	array
AllocatorManager.AllocatorHandle	allocator

Returns

Type	Description
NativeArray<T>

Type Parameters

Name	Description
T

CreateNativeArray<T>(Int32, AllocatorManager.AllocatorHandle, NativeArrayOptions)

Declaration

public static NativeArray<T> CreateNativeArray<T>(int length, AllocatorManager.AllocatorHandle allocator, NativeArrayOptions options = null)
    where T : struct

Parameters

Type	Name	Description
Int32	length
AllocatorManager.AllocatorHandle	allocator
NativeArrayOptions	options

Returns

Type	Description
NativeArray<T>

Type Parameters

Name	Description
T

CreateNativeArray<T, U>(T[], ref U)

Declaration

public static NativeArray<T> CreateNativeArray<T, U>(T[] array, ref U allocator)
    where T : struct where U : struct, AllocatorManager.IAllocator

Parameters

Type	Name	Description
T[]	array
U	allocator

Returns

Type	Description
NativeArray<T>

Type Parameters

Name	Description
T
U

CreateNativeArray<T, U>(Int32, ref U, NativeArrayOptions)

Declaration

public static NativeArray<T> CreateNativeArray<T, U>(int length, ref U allocator, NativeArrayOptions options = null)
    where T : struct where U : struct, AllocatorManager.IAllocator

Parameters

Type	Name	Description
Int32	length
U	allocator
NativeArrayOptions	options

Returns

Type	Description
NativeArray<T>

Type Parameters

Name	Description
T
U

CreateNativeMultiHashMap<TKey, TValue, U>(Int32, ref U)

Declaration

public static NativeMultiHashMap<TKey, TValue> CreateNativeMultiHashMap<TKey, TValue, U>(int length, ref U allocator)
    where TKey : struct, IEquatable<TKey> where TValue : struct where U : struct, AllocatorManager.IAllocator

Parameters

Type	Name	Description
Int32	length
U	allocator

Returns

Type	Description
NativeMultiHashMap<TKey, TValue>

Type Parameters

Name	Description
TKey
TValue
U

Hash(Void*, Int32)

Returns a (non-cryptographic) hash of a memory block.

Declaration

public static uint Hash(void *ptr, int bytes)

Parameters

Type	Name	Description
Void*	ptr	A buffer.
Int32	bytes	The number of bytes to hash.

Returns

Type	Description
UInt32	A hash of the bytes.

Remarks

The hash function used is djb2.

IsAligned(UInt64, Int32)

Returns true if an offset has a given alignment.

Declaration

public static bool IsAligned(ulong offset, int alignmentPowerOfTwo)

Parameters

Type	Name	Description
UInt64	offset	An offset
Int32	alignmentPowerOfTwo	A non-zero, positive power of two.

Returns

Type	Description
Boolean	True if the offset is a multiple of alignmentPowerOfTwo.

IsAligned(Void*, Int32)

Returns true if the address represented by the pointer has a given alignment.

Declaration

public static bool IsAligned(void *p, int alignmentPowerOfTwo)

Parameters

Type	Name	Description
Void*	p	The pointer.
Int32	alignmentPowerOfTwo	A non-zero, positive power of two.

Returns

Type	Description
Boolean	True if the address is a multiple of alignmentPowerOfTwo.

IsPowerOfTwo(Int32)

Returns true if a positive value is a non-zero power of two.

Declaration

public static bool IsPowerOfTwo(int value)

Parameters

Type	Name	Description
Int32	value	A positive value.

Returns

Type	Description
Boolean	True if the value is a non-zero, positive power of two.

Remarks

Result is invalid if value < 0.

Log2Ceil(Int32)

Returns the binary logarithm of the value, but the result is rounded up to the nearest integer.

Declaration

public static int Log2Ceil(int value)

Parameters

Type	Name	Description
Int32	value	The value.

Returns

Type	Description
Int32	The binary logarithm of the value, but the result is rounded up to the nearest integer.

Log2Floor(Int32)

Returns the binary logarithm of the value, but the result is rounded down to the nearest integer.

Declaration

public static int Log2Floor(int value)

Parameters

Type	Name	Description
Int32	value	The value.

Returns

Type	Description
Int32	The binary logarithm of the value, but the result is rounded down to the nearest integer.