JSONTokener

extends Object

java.lang.Object
↳	org.json.JSONTokener

Class Overview

Parses a JSON (RFC 4627) encoded string into the corresponding object. Most clients of this class will use only need the constructor and nextValue() method. Example usage:

 String json = "{"
         + "  \"query\": \"Pizza\", "
         + "  \"locations\": [ 94043, 90210 ] "
         + "}";
 JSONObject object = (JSONObject) new JSONTokener(json).nextValue();
 String query = object.getString("query");
 JSONArray locations = object.getJSONArray("locations");

For best interoperability and performance use JSON that complies with RFC 4627, such as that generated by JSONStringer. For legacy reasons this parser is lenient, so a successful parse does not indicate that the input string was valid JSON. All of the following syntax errors will be ignored:

End of line comments starting with // or # and ending with a newline character.
C-style comments starting with /* and ending with */. Such comments may not be nested.
Strings that are unquoted or 'single quoted'.
Hexadecimal integers prefixed with 0x or 0X.
Octal integers prefixed with 0.
Array elements separated by ;.
Unnecessary array separators. These are interpreted as if null was the omitted value.
Key-value pairs separated by = or =>.
Key-value pairs separated by ;.

Each tokener may be used to parse a single JSON string. Instances of this class are not thread safe. Although this class is nonfinal, it was not designed for inheritance and should not be subclassed. In particular, self-use by overrideable methods is not specified. See Effective Java Item 17, "Design and Document or inheritance or else prohibit it" for further information.

Summary

Public Constructors
	JSONTokener(String in)

Public Methods
void	back() Unreads the most recent character of input.
static int	dehexchar(char hex) Returns the integer [0..15] value for the given hex character, or -1 for non-hex input.
boolean	more() Returns true until the input has been exhausted.
String	next(int length) Returns the next `length` characters of the input.
char	next() Returns the next available character, or the null character '\0' if all input has been exhausted.
char	next(char c) Returns the next available character if it equals `c`.
char	nextClean() Returns the next character that is not whitespace and does not belong to a comment.
String	nextString(char quote) Returns the string up to but not including `quote`, unescaping any character escape sequences encountered along the way.
String	nextTo(char excluded) Equivalent to `nextTo(String.valueOf(excluded))`.
String	nextTo(String excluded) Returns the `trimmed` string holding the characters up to but not including the first of: any character in `excluded` a newline character '\n' a carriage return '\r' The returned string shares its backing character array with this tokener's input string.
Object	nextValue() Returns the next value from the input.
void	skipPast(String thru) Advances past all input up to and including the next occurrence of `thru`.
char	skipTo(char to) Advances past all input up to but not including the next occurrence of `to`.
JSONException	syntaxError(String message) Returns an exception containing the given message plus the current position and the entire input string.
String	toString() Returns the current position and the entire input string.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

NumberFormatException	if any unicode escape sequences are malformed.
JSONException

Classes

Exceptions

JSONTokener

Class Overview

Summary

Public Constructors

public JSONTokener (String in)

Parameters

Public Methods

public void back ()

public static int dehexchar (char hex)

Parameters

public boolean more ()

public String next (int length)

Throws

public char next ()

public char next (char c)

Throws

public char nextClean ()

Throws

public String nextString (char quote)

Parameters

Throws

public String nextTo (char excluded)

public String nextTo (String excluded)

Returns

public Object nextValue ()

Returns

Throws

public void skipPast (String thru)

public char skipTo (char to)

public JSONException syntaxError (String message)

public String toString ()

Returns