tiny.preserves.toText

1/// Returns `value` as text, allocated with `alloc`. The JSON encoder calls it for a text spelling2/// of each dictionary key other than a string or symbol, and code that logs or prints any value3/// calls it for a readable form. The caller owns the bytes and frees them with `alloc`, and on4/// error the call frees what it wrote.5///6/// Atoms other than byte strings are spelled as the text writer spells them. A byte string is7/// written as `#"…"`, with `\x` escapes for bytes outside printable ASCII and for `"` and `\`. The8/// discard pattern is written `<_>`, a capture or bind as its wire form, and a rest pattern as9/// `[prefix … . rest]`. An embedded value from `parse` is written `#:` and its value, and any other10/// embedded value `#:` and its pointer in decimal. Sets and dictionaries are written in the order11/// they are stored, with dictionary entries separated by a space.12///13/// The call returns `error.DuplicateSetElement` or `error.DuplicateDictionaryKey` for a set with14/// two equal elements or a dictionary with two equal keys, and `error.OutOfMemory`. Writing a15/// capture or bind frees parts of `value` when its pattern holds a set, a record label, a16/// dictionary key or a big integer. Running out of memory while it writes a capture or bind leaks17/// the wire record built so far.18pub fn toText(alloc: Allocator, value: Value) ![]const u8 {19    var buf: ArrayList = .empty;20    errdefer buf.deinit(alloc);21    try writeValue(alloc, &buf, value);22    return buf.toOwnedSlice(alloc);23}

1pub const toText = text.toText;