tiny.preserves.ParseError

1/// The errors `parse` returns: one tag per kind of malformed text, plus running out of nesting2/// depth or memory. Code that calls `parse` switches on these tags, for a report of the input the3/// parser rejected. The set lists every error `parse` can return, so a switch over it is4/// exhaustive. On any error `parse` frees everything it allocated. `json.ParseError` names the same5/// set, and no JSON function returns it.6pub const ParseError = error{7    /// Input that ends before a value starts: empty or blank text, text that ends right after `#`8    /// or `#x`, or a record, dictionary or annotation cut off before its next value.9    UnexpectedEnd,10    /// A character such as `>`, `:` or `;` at the start of a value, or a dictionary key followed by11    /// something other than `:`. `#xd` followed by something other than `"`.12    UnexpectedChar,13    /// A string or quoted symbol that reaches the end of the input before its closing quote.14    UnterminatedString,15    /// A record that reaches the end of the input before its closing `>`.16    UnterminatedRecord,17    /// A sequence that reaches the end of the input before its closing `]`.18    UnterminatedSequence,19    /// A dictionary that reaches the end of the input before its closing `}`.20    UnterminatedDictionary,21    /// A set, written `#{`, that reaches the end of the input before its closing `}`.22    UnterminatedSet,23    /// Input that ends right after a backslash in a string, a quoted symbol or a `#"` byte string.24    UnterminatedEscape,25    /// A byte string written `#"`, `#x"` or `#[` that reaches the end of the input before its26    /// closing `"` or `]`.27    UnterminatedByteString,28    /// A double written `#xd"` that reaches the end of the input before its closing `"`.29    UnterminatedHexDouble,30    /// In a string or quoted symbol, a backslash followed by a character other than `"`, `\`, `/`,31    /// `'`, `n`, `r`, `t`, `b`, `f` or `u`. In a `#"` byte string, a backslash followed by a32    /// character other than `x`, `\`, `"`, `n`, `r` or `t`. The text writer writes `\'` inside33    /// quoted symbols, so `parse` accepts that output.34    UnknownEscape,35    /// A string, quoted symbol, or bare symbol has invalid UTF-8.36    InvalidUtf8,37    /// A `#` followed by a character other than `t`, `f`, `{`, `:`, `"`, `x`, `[`, space or tab.38    /// `#x` followed by a character other than `"` or `d`.39    UnknownHashForm,40    /// A double written `#xd"…"` whose digits, ignoring whitespace, are not exactly 16 hexadecimal41    /// digits.42    InvalidHexDouble,43    /// Anything other than whitespace, commas and comments after the first complete value.44    TrailingContent,45    /// In a `#"` byte string, `\x` not followed by two hexadecimal digits. A `#x"…"` byte string46    /// with an odd number of digits or a character other than a hexadecimal digit. Also a `#[…]`47    /// byte string with invalid base64.48    InvalidHexEscape,49    /// In a string or quoted symbol, `\u` not followed by four hexadecimal digits, or naming a lone50    /// surrogate, which UTF-8 leaves unencoded.51    InvalidUnicodeEscape,52    /// A set, written `#{…}`, that holds two equal elements.53    DuplicateSetElement,54    /// A dictionary that holds two equal keys.55    DuplicateDictionaryKey,56    /// Values nested more than 256 levels deep. Each record, sequence, dictionary, set, annotation57    /// and `#:` embedded value adds a level. `text.decode` returns the same tag at the same depth.58    NestingLimitExceeded,59    /// An allocation that fails while `parse` builds the value.60    OutOfMemory,61};

1pub const ParseError = parse_error.ParseError;