mir.appender

struct ScopedBuffer(T, size_t bytes = 4096) if (bytes && (T.sizeof <= bytes));

@trusted auto scopedBuffer(T, size_t bytes = 4096)();

The buffer uses stack memory and C Runtime to allocate temporal memory.

Shouldn't store references to GC allocated data.

Examples:

auto buf = scopedBuffer!char;
buf.put('c');
buf.put("str");
assert(buf.data == "cstr");

buf.popBackN(2);
assert(buf.data == "cs");

Examples:

immutable

auto buf = scopedBuffer!(immutable char);
buf.put('c');
buf.put("str");
assert(buf.data == "cstr");

buf.popBackN(2);
assert(buf.data == "cs");

@safe void reserve(size_t n) scope;

Reserve n more elements.

@trusted T[] prepare(size_t n) scope;

Return a slice to n more elements.

void shrinkTo(size_t length);

const @property size_t length() scope;

void popBackN(size_t n);

@safe void put(T e) scope;

void put(ref R e) scope;

void put(scope R[] e) scope;

void put(Iterable)(Iterable range) scope
if (isIterable!Iterable && !__traits(isStaticArray, Iterable) && (!isArray!Iterable || hasElaborateAssign!T));

template opOpAssign(string op : "~")

nothrow @trusted void reset() scope;

nothrow @nogc @system void initialize() scope;

inout @property @trusted inout(T)[] data() scope return;

@system void moveDataAndEmplaceTo(T[] array);

Copies data into an array of the same length using memcpy C routine. Shrinks the length to 0.

struct UnsafeArrayBuffer(T);

Examples:

char[4] array;
auto buf = UnsafeArrayBuffer!char(array);
buf.put('c');
buf.put("str");
assert(buf.data == "cstr");

buf.popBackN(2);
assert(buf.data == "cs");

T[] buffer;

size_t length;

void put(T a);

void put(E[] a);

inout @property @safe inout(T)[] data() scope;

void popBackN(size_t n);