phobos ~master (2024-10-03T07:50:27Z)

makeArray

std experimental allocator

Create an array of T with length elements using alloc. The array is either default-initialized, filled with copies of init, or initialized with values fetched from range.

  1. T[] makeArray(Allocator alloc, size_t length)
  2. T[] makeArray(Allocator alloc, size_t length, T init)
  3. Unqual!(ElementEncodingType!R)[] makeArray(Allocator alloc, R range)
  4. T[] makeArray(Allocator alloc, R range)
    T[]
    makeArray
    (
    T
    Allocator
    R
    )
    (
    auto ref Allocator alloc
    ,
    R range
    )
    if (
    isInputRange!R &&
    !isInfinite!R
    )

Parameters

T

element type of the array being created

alloc Allocator

the allocator used for getting memory

range R

range used for initializing the array elements

Return Value

Type: T[]

The newly-created array, or null if either length was 0 or allocation failed.

Throws

The first two overloads throw only if alloc's primitives do. The overloads that involve copy initialization deallocate memory and propagate the exception if the copy operation throws.

Examples

import std.algorithm.comparison : equal;
static void test(T)()
{
    T[] a = theAllocator.makeArray!T(2);
    assert(a.equal([0, 0]));
    a = theAllocator.makeArray!T(3, 42);
    assert(a.equal([42, 42, 42]));
    import std.range : only;
    a = theAllocator.makeArray!T(only(42, 43, 44));
    assert(a.equal([42, 43, 44]));
}
test!int();
test!(shared int)();
test!(const int)();
test!(immutable int)();

Meta

Source

See Implementation

std experimental allocator modulesclassesfunctionsinterfacespropertiesstructs

Page generated by adrdox