Valid parser states.

Return true iff 'i' is at or beyond the end of the input (EOF).

Read the byte/char at 'i' as a Char.

Note that this should not be used on potential multi-byte sequences.

Should be called when parsing is finished.

Generate a Char from the hex digits of "ሴ" (i.e. "1234").

NOTE: This is only capable of generating characters from the basic plane. This is why it can only return Char instead of Int.

Used to generate error messages with character info and offsets.

Used to generate messages for internal errors.

This should only be used in situations where a possible bug in the parser was detected. For errors in user-provided JSON, use die().

Parse and return the next JSON value and the position beyond it.

Parse the JSON document into a single JSON value.

The parser considers documents like '333', 'true', and '"foo"' to be valid, as well as more traditional documents like [1,2,3,4,5]. However, multiple top-level objects are not allowed.

Parse the JSON constant "false".

Note that this method assumes that the first character has already been checked.

Parse the JSON constant "null".

Note that this method assumes that the first character has already been checked.

Parse the given number, and add it to the given context.

We don't actually instantiate a number here, but rather pass the string of for future use. Facades can choose to be lazy and just store the string. This ends up being way faster and has the nice side-effect that we know exactly how the user represented the number.

Parse the given number, and add it to the given context.

This method is a bit slower than parseNum() because it has to be sure it doesn't run off the end of the input.

Normally (when operating in rparse in the context of an outer array or object) we don't need to worry about this and can just grab characters, because if we run out of characters that would indicate bad input. This is for cases where the number could possibly be followed by a valid EOF.

This method has all the same caveats as the previous method.

Parse the string according to JSON rules, and add to the given context.

This method expects the data to be in UTF-8 and accesses it as bytes.

See if the string has any escape sequences. If not, return the end of the string. If so, bail out and return -1.

This method expects the data to be in UTF-8 and accesses it as bytes. Thus we can just ignore any bytes with the highest bit set.

Parse the JSON constant "true".

Note that this method assumes that the first character has already been checked.

Tail-recursive parsing method to do the bulk of JSON parsing.

This single method manages parser states, data, etc. Except for parsing non-recursive values (like strings, numbers, and constants) all important work happens in this loop (or in methods it calls, like reset()).

Currently the code is optimized to make use of switch statements. Future work should consider whether this is better or worse than manually constructed if/else statements or something else. Also, it may be possible to reorder some cases for speed improvements.