JSONObject

A sentinel value used to explicitly define a name with no value. Unlike null, names with this value:

• show up in the names() array
• show up in the keys() iterator
• return true for has(String)
• do not throw on get(String)
• are included in the encoded JSON string.

This value violates the general contract of equals(Object) by returning true when compared to null. Its toString() method returns "null".

Creates a JSONObject with no name/value mappings.

Creates a new JSONObject by copying all name/value mappings from the given map.

Creates a new JSONObject with name/value mappings from the next object in the tokener.

Creates a new JSONObject with name/value mappings from the JSON string.

Creates a new JSONObject by copying mappings for the listed names from the given object. Names that aren't present in copyFrom will be skipped.

Appends value to the array already mapped to name. If this object has no mapping for name, this inserts a new mapping. If the mapping exists but its value is not an array, the existing and new values are inserted in order into a new array which is itself mapped to name. In aggregate, this allows values to be added to a mapping one at a time.

Note that append(String, Object) provides better semantics. In particular, the mapping for name will always be a JSONArray. Using accumulate will result in either a JSONArray or a mapping whose type is the type of value depending on the number of calls to it.

Returns the value mapped by name, or throws if no such mapping exists.

Returns the value mapped by name if it exists and is a boolean or can be coerced to a boolean, or throws otherwise.

Returns the value mapped by name if it exists and is a double or can be coerced to a double, or throws otherwise.

Returns the value mapped by name if it exists and is an int or can be coerced to an int, or throws otherwise.

Returns the value mapped by name if it exists and is a JSONArray, or throws otherwise.

Returns the value mapped by name if it exists and is a JSONObject, or throws otherwise.

Returns the value mapped by name if it exists and is a long or can be coerced to a long, or throws otherwise. Note that JSON represents numbers as doubles, so this is lossy; use strings to transfer numbers via JSON.

Returns the value mapped by name if it exists, coercing it if necessary, or throws if no such mapping exists.

Returns true if this object has a mapping for name. The mapping may be NULL.

Returns true if this object has no mapping for name or if it has a mapping whose value is NULL.

Returns an iterator of the String names in this object. The returned iterator supports remove, which will remove the corresponding mapping from this object. If this object is modified after the iterator is returned, the iterator's behavior is undefined. The order of the keys is undefined.

Returns the number of name/value mappings in this object.

Returns an array containing the string names in this object. This method returns null if this object contains no mappings.

Encodes the number as a JSON string.

Returns the value mapped by name, or null if no such mapping exists.

Returns the value mapped by name if it exists and is a boolean or can be coerced to a boolean, or false otherwise.

Returns the value mapped by name if it exists and is a boolean or can be coerced to a boolean, or fallback otherwise.

Returns the value mapped by name if it exists and is a double or can be coerced to a double, or fallback otherwise.

Returns the value mapped by name if it exists and is a double or can be coerced to a double, or NaN otherwise.

Returns the value mapped by name if it exists and is an int or can be coerced to an int, or fallback otherwise.

Returns the value mapped by name if it exists and is an int or can be coerced to an int, or 0 otherwise.

Returns the value mapped by name if it exists and is a JSONArray, or null otherwise.

Returns the value mapped by name if it exists and is a JSONObject, or null otherwise.

Returns the value mapped by name if it exists and is a long or can be coerced to a long, or 0 otherwise. Note that JSON represents numbers as doubles, so this is lossy; use strings to transfer numbers via JSON.

Returns the value mapped by name if it exists and is a long or can be coerced to a long, or fallback otherwise. Note that JSON represents numbers as doubles, so this is lossy; use strings to transfer numbers via JSON.

Returns the value mapped by name if it exists, coercing it if necessary, or the empty string if no such mapping exists.

Returns the value mapped by name if it exists, coercing it if necessary, or fallback if no such mapping exists.

Maps name to value, clobbering any existing name/value mapping with the same name.

Maps name to value, clobbering any existing name/value mapping with the same name.

Maps name to value, clobbering any existing name/value mapping with the same name. If the value is null, any existing mapping for name is removed.

Maps name to value, clobbering any existing name/value mapping with the same name.

Maps name to value, clobbering any existing name/value mapping with the same name.

Equivalent to put(name, value) when both parameters are non-null; does nothing otherwise.

Encodes data as a JSON string. This applies quotes and any necessary character escaping.

Removes the named mapping if it exists; does nothing otherwise.

Returns an array with the values corresponding to names. The array contains null for names that aren't mapped. This method returns null if names is either null or empty.

Encodes this object as a compact JSON string, such as:

{"query":"Pizza","locations":[94043,90210]}

Encodes this object as a human readable JSON string for debugging, such as:

 {
     "query": "Pizza",
     "locations": [
         94043,
         90210
     ]
 }

Wraps the given object if necessary.

If the object is null or , returns NULL. If the object is a JSONArray or JSONObject, no wrapping is necessary. If the object is NULL, no wrapping is necessary. If the object is an array or Collection, returns an equivalent JSONArray. If the object is a Map, returns an equivalent JSONObject. If the object is a primitive wrapper type or String, returns the object. Otherwise if the object is from a java package, returns the result of toString. If wrapping fails, returns null.