Class Array

Source/Engine/Core/Collections/Array.h:17–1057

/// <typeparam name="AllocationType">The type of memory allocator.</typeparam>
template<typename T, typename AllocationType = HeapAllocation>
API_CLASS(InBuild) class Array
{
    friend Array;
public:
    using ItemType = T;
    using AllocationData = typename AllocationType::template Data<T>;
    using AllocationTag = typename AllocationType::Tag;

private:
    int32 _count;
    int32 _capacity;
    AllocationData _allocation;

public:
    /// <summary>
    /// Initializes an empty <see cref="Array"/> without reserving any space.
    /// </summary>
    FORCE_INLINE Array()
        : _count(0)
        , _capacity(0)
    {
    }

    /// <summary>
    /// Initializes an empty <see cref="Array"/> without reserving any space.
    /// </summary>
    /// <param name="tag">The custom allocation tag.</param>
    Array(AllocationTag tag)
        : _count(0)
        , _capacity(0)
        , _allocation(tag)
    {
    }

    /// <summary>
    /// Initializes <see cref="Array"/> by reserving space.
    /// </summary>
    /// <param name="capacity">The number of elements that can be added without a need to allocate more memory.</param>
    FORCE_INLINE explicit Array(const int32 capacity)
        : _count(0)
        , _capacity(capacity)
    {
        if (capacity > 0)
            _allocation.Allocate(capacity);
    }

    /// <summary>
    /// Initializes <see cref="Array"/> by copying elements.
    /// </summary>
    /// <param name="data">The initial data.</param>
    /// <param name="length">The amount of items.</param>
    Array(const T* data, const int32 length)
    {
        ASSERT(length >= 0);
        _count = _capacity = length;
        if (length > 0)
        {
            _allocation.Allocate(length);