Esc

append

procedureextensionexperimental4 overloadssince 0.36.1Source
  • macOS: append works on macOS
  • Linux: append works on Linux
  • Windows: append works on Windows
  • Wasm: append is not available on Wasm

overload 1

append :: (out: *Out, s: string)

Appends bytes verbatim; use html or the escaping helpers for untrusted text.

Example
out: Out;
defer deinit(*out);
append(*out, "<br>");
assert(to_string(*out) == "<br>");

overload 2

append :: (out: *Out, data: *u8, count: int)

Appends a byte range verbatim.

Example
out: Out;
defer deinit(*out);
s := "ok";
append(*out, s.data, s.count);
assert(to_string(*out) == s);

overload 3

append :: (out: *Out, data: [] u8)

Appends a byte slice verbatim.

Example
out: Out;
defer deinit(*out);
data := u8.[65, 66];
append(*out, data);
assert(to_string(*out) == "AB");

overload 4

append :: (out: *Out, byte: u8)

Appends one byte verbatim.

Example
out: Out;
defer deinit(*out);
append(*out, #char "x");
assert(to_string(*out) == "x");

See also