SList.insertBack

Inserts the elements of an input range, or a variable number of items, at the end of the list.

If no allocator was provided when the list was created, the GCAllocator.std.experimental.allocator. will be used.

  1. size_t insertBack(Stuff stuff)
  2. size_t insertBack(Stuff[] stuff)
    struct SList(T)
    size_t
    insertBack
    (
    Stuff
    )
    (
    Stuff[] stuff...
    )
    if (
    isImplicitlyConvertible!(Stuff, T)
    )

Parameters

stuff Stuff[]

an input range of elements that are implitictly convertible to T; a variable number of items either in the form of a list or as a built-in array

Return Value

Type: size_t

the number of elements inserted

Complexity: O(pos + m), where m is the number of elements in the range.

Examples

import std.algorithm.comparison : equal;

auto s = SList!int(4, 5);
SList!int sl;
assert(sl.empty);

sl.insertBack(1);
sl.insertBack([2, 3]);
assert(equal(sl, [1, 2, 3]));

// insert from an input range
sl.insertBack(s);
assert(equal(sl, [1, 2, 3, 4, 5]));
s.front = 0;
assert(equal(sl, [1, 2, 3, 4, 5]));

Meta