tiny.preserves.decodeText

1/// Returns the one value `text` holds, allocated with `allocator`. Code that reads a whole data2/// file calls it, so each file yields one owned value. The value's embedded values have the type3/// `D`. Whitespace and commas separate values. `decode` reads no comments, so `# ` fails as an4/// unknown `#` form. A bare token that is all digits, with an optional sign, becomes an integer of5/// any size, a token in decimal or exponent form becomes a double, and any other token becomes a6/// symbol.7///8/// The value owns all its memory, so `text` may be freed at once, and the caller frees the value9/// with `deinit`. On any error the call frees everything it allocated. Its repeated-item checks10/// compare each element or key with every earlier one, so their cost grows with the square of the11/// count.12pub fn decode(comptime D: type, allocator: Allocator, text: []const u8) DecodeError!value_mod.Value(D) {13    var index: usize = 0;14    var v = try readValueAt(D, allocator, text, &index, nesting.root);15    errdefer v.deinit(allocator);16    skipTrailing(text, &index);17    if (index != text.len) return error.UnexpectedTrailingBytes;18    return v;19}

1pub const decodeText = text.decode;