org.json

Class UnmodifiableJSONArray

java.lang.Object

org.json.UnmodifiableJSONArray

All Implemented Interfaces:

java.lang.Iterable<java.lang.Object>, JSONArray, JSONComponent

Deprecated.

@Deprecated
public class UnmodifiableJSONArray
extends java.lang.Object
implements JSONArray

Method Summary

Modifier and Type	Method and Description
<A extends JSONArray,O extends JSONObject> A	clone(JSONBuilder<A,O> builder) Deprecated.
boolean	equals(java.lang.Object obj) Deprecated.
boolean	equalsList(java.util.List<java.lang.Object> list) Deprecated.
java.lang.Object	get(int index) Deprecated. Get the object value associated with an index.
boolean	getBoolean(int index) Deprecated. Get the boolean value associated with an index.
double	getDouble(int index) Deprecated. Get the double value associated with an index.
static UnmodifiableJSONArray	getInstance(JSONArray jArr) Deprecated.
int	getInt(int index) Deprecated. Get the int value associated with an index.
JSONArray	getJSONArray(int index) Deprecated. Get the JSONArray associated with an index.
JSONObject	getJSONObject(int index) Deprecated. Get the JSONObject associated with an index.
long	getLong(int index) Deprecated. Get the long value associated with an index.
java.lang.String	getString(int index) Deprecated. Get the string associated with an index.
int	hashCode() Deprecated.
int	indexOf(java.lang.Object value) Deprecated.
boolean	isNull(int index) Deprecated. Determine if the value is null.
java.util.Iterator<java.lang.Object>	iterator() Deprecated.
int	length() Deprecated. Get the number of elements in the JSONArray, included nulls.
java.lang.Object	opt(int index) Deprecated. Get the optional object value associated with an index.
boolean	optBoolean(int index) Deprecated. Get the optional boolean value associated with an index.
boolean	optBoolean(int index, boolean defaultValue) Deprecated. Get the optional boolean value associated with an index.
double	optDouble(int index) Deprecated. Get the optional double value associated with an index.
double	optDouble(int index, double defaultValue) Deprecated. Get the optional double value associated with an index.
int	optInt(int index) Deprecated. Get the optional int value associated with an index.
int	optInt(int index, int defaultValue) Deprecated. Get the optional int value associated with an index.
JSONArray	optJSONArray(int index) Deprecated. Get the optional JSONArray associated with an index.
JSONObject	optJSONObject(int index) Deprecated. Get the optional JSONObject associated with an index.
long	optLong(int index) Deprecated. Get the optional long value associated with an index.
long	optLong(int index, long defaultValue) Deprecated. Get the optional long value associated with an index.
java.lang.String	optString(int index) Deprecated. Get the optional string value associated with an index.
java.lang.String	optString(int index, java.lang.String defaultValue) Deprecated. Get the optional string associated with an index.
JSONArray	put(boolean value) Deprecated. Append a boolean value.
JSONArray	put(double value) Deprecated. Append a double value.
JSONArray	put(int value) Deprecated. Append an int value.
JSONArray	put(int index, boolean value) Deprecated. Put or replace a boolean value in the JSONArray.
JSONArray	put(int index, double value) Deprecated. Put or replace a double value.
JSONArray	put(int index, int value) Deprecated. Put or replace an int value.
JSONArray	put(int index, long value) Deprecated. Put or replace a long value.
JSONArray	put(int index, java.lang.Object value) Deprecated. Put or replace an object value in the JSONArray.
JSONArray	put(long value) Deprecated. Append an long value.
JSONArray	put(java.lang.Object value) Deprecated. Append an object value.
java.lang.Object	remove(int index) Deprecated. Remove an index and close the hole.
boolean	remove(java.lang.Object obj) Deprecated. Remove the first instance of an Object from the array.
java.lang.String	toString() Deprecated. Make a JSON text of this JSONObject.
java.lang.String	toString(int indentFactor) Deprecated. Make a prettyprinted JSON text of this JSONObject.
java.lang.String	toString(int indentFactor, int indent) Deprecated. Make a prettyprinted JSON text of this JSONObject.
java.lang.Appendable	write(java.lang.Appendable writer) Deprecated. Write the contents of the JSONComponent as JSON text to a writer.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

getInstance

public static UnmodifiableJSONArray getInstance(JSONArray jArr)

Deprecated.

get

public java.lang.Object get(int index)

Deprecated.

Description copied from interface: JSONArray

Get the object value associated with an index.

Specified by:

get in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

An object value.

getBoolean

public boolean getBoolean(int index)
                   throws JSONException

Deprecated.

Description copied from interface: JSONArray

Get the boolean value associated with an index. The string values "true" and "false" are converted to boolean.

Specified by:

getBoolean in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

The truth.

Throws:

JSONException - If there is no value for the index or if the value is not convertible to boolean.

getDouble

public double getDouble(int index)
                 throws JSONException

Deprecated.

Description copied from interface: JSONArray

Get the double value associated with an index.

Specified by:

getDouble in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

The value.

Throws:

JSONException - If the key is not found or if the value cannot be converted to a number.

getInt

public int getInt(int index)
           throws JSONException

Deprecated.

Description copied from interface: JSONArray

Get the int value associated with an index.

Specified by:

getInt in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

The value.

Throws:

JSONException - If the key is not found or if the value is not a number.

getJSONArray

public JSONArray getJSONArray(int index)
                       throws JSONException

Deprecated.

Description copied from interface: JSONArray

Get the JSONArray associated with an index.

Specified by:

getJSONArray in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

A JSONArray value.

Throws:

JSONException - If there is no value for the index. or if the value is not a JSONArray

getJSONObject

public JSONObject getJSONObject(int index)
                         throws JSONException

Deprecated.

Description copied from interface: JSONArray

Get the JSONObject associated with an index.

Specified by:

getJSONObject in interface JSONArray

Parameters:

index - subscript

Returns:

A JSONObject value.

Throws:

JSONException - If there is no value for the index or if the value is not a JSONObject

getLong

public long getLong(int index)
             throws JSONException

Deprecated.

Description copied from interface: JSONArray

Get the long value associated with an index.

Specified by:

getLong in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

The value.

Throws:

JSONException - If the key is not found or if the value cannot be converted to a number.

getString

public java.lang.String getString(int index)
                           throws JSONException

Deprecated.

Description copied from interface: JSONArray

Get the string associated with an index.

Specified by:

getString in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

A string value.

Throws:

JSONException - If there is no value for the index.

isNull

public boolean isNull(int index)

Deprecated.

Description copied from interface: JSONArray

Determine if the value is null.

Specified by:

isNull in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

true if the value at the index is null, or if there is no value.

length

public int length()

Deprecated.

Description copied from interface: JSONArray

Get the number of elements in the JSONArray, included nulls.

Specified by:

length in interface JSONArray

Returns:

The length (or size).

opt

public java.lang.Object opt(int index)

Deprecated.

Description copied from interface: JSONArray

Get the optional object value associated with an index.

Specified by:

opt in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

An object value, or null if there is no object at that index.

optBoolean

public boolean optBoolean(int index)

Deprecated.

Description copied from interface: JSONArray

Get the optional boolean value associated with an index. It returns false if there is no value at that index, or if the value is not Boolean.TRUE or the String "true".

Specified by:

optBoolean in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

The truth.

optBoolean

public boolean optBoolean(int index,
                          boolean defaultValue)

Deprecated.

Description copied from interface: JSONArray

Get the optional boolean value associated with an index. It returns the defaultValue if there is no value at that index or if it is not a Boolean or the String "true" or "false" (case insensitive).

Specified by:

optBoolean in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

defaultValue - A boolean default.

Returns:

The truth.

optDouble

public double optDouble(int index)

Deprecated.

Description copied from interface: JSONArray

Get the optional double value associated with an index. NaN is returned if there is no value for the index, or if the value is not a number and cannot be converted to a number.

Specified by:

optDouble in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

The value.

optDouble

public double optDouble(int index,
                        double defaultValue)

Deprecated.

Description copied from interface: JSONArray

Get the optional double value associated with an index. The defaultValue is returned if there is no value for the index, or if the value is not a number and cannot be converted to a number.

Specified by:

optDouble in interface JSONArray

Parameters:

index - subscript

defaultValue - The default value.

Returns:

The value.

optInt

public int optInt(int index)

Deprecated.

Description copied from interface: JSONArray

Get the optional int value associated with an index. Zero is returned if there is no value for the index, or if the value is not a number and cannot be converted to a number.

Specified by:

optInt in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

The value.

optInt

public int optInt(int index,
                  int defaultValue)

Deprecated.

Description copied from interface: JSONArray

Get the optional int value associated with an index. The defaultValue is returned if there is no value for the index, or if the value is not a number and cannot be converted to a number.

Specified by:

optInt in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

defaultValue - The default value.

Returns:

The value.

optJSONArray

public JSONArray optJSONArray(int index)

Deprecated.

Description copied from interface: JSONArray

Get the optional JSONArray associated with an index.

Specified by:

optJSONArray in interface JSONArray

Parameters:

index - subscript

Returns:

A JSONArray value, or null if the index has no value, or if the value is not a JSONArray.

optJSONObject

public JSONObject optJSONObject(int index)

Deprecated.

Description copied from interface: JSONArray

Get the optional JSONObject associated with an index. Null is returned if the key is not found, or null if the index has no value, or if the value is not a JSONObject.

Specified by:

optJSONObject in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

A JSONObject value.

optLong

public long optLong(int index)

Deprecated.

Description copied from interface: JSONArray

Get the optional long value associated with an index. Zero is returned if there is no value for the index, or if the value is not a number and cannot be converted to a number.

Specified by:

optLong in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

The value.

optLong

public long optLong(int index,
                    long defaultValue)

Deprecated.

Description copied from interface: JSONArray

Get the optional long value associated with an index. The defaultValue is returned if there is no value for the index, or if the value is not a number and cannot be converted to a number.

Specified by:

optLong in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

defaultValue - The default value.

Returns:

The value.

optString

public java.lang.String optString(int index)

Deprecated.

Description copied from interface: JSONArray

Get the optional string value associated with an index. It returns an empty string if there is no value at that index. If the value is not a string and is not null, then it is coverted to a string.

Specified by:

optString in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

Returns:

A String value.

optString

public java.lang.String optString(int index,
                                  java.lang.String defaultValue)

Deprecated.

Description copied from interface: JSONArray

Get the optional string associated with an index. The defaultValue is returned if the key is not found.

Specified by:

optString in interface JSONArray

Parameters:

index - The index must be between 0 and length() - 1.

defaultValue - The default value.

Returns:

A String value.

put

public JSONArray put(boolean value)

Deprecated.

Description copied from interface: JSONArray

Append a boolean value. This increases the array's length by one.

Specified by:

put in interface JSONArray

Parameters:

value - A boolean value.

Returns:

this.

put

public JSONArray put(double value)
              throws JSONException

Deprecated.

Description copied from interface: JSONArray

Append a double value. This increases the array's length by one.

Specified by:

put in interface JSONArray

Parameters:

value - A double value.

Returns:

this.

Throws:

JSONException - if the value is not finite.

put

public JSONArray put(int value)

Deprecated.

Description copied from interface: JSONArray

Append an int value. This increases the array's length by one.

Specified by:

put in interface JSONArray

Parameters:

value - An int value.

Returns:

this.

put

public JSONArray put(long value)

Deprecated.

Description copied from interface: JSONArray

Append an long value. This increases the array's length by one.

Specified by:

put in interface JSONArray

Parameters:

value - A long value.

Returns:

this.

put

public JSONArray put(java.lang.Object value)

Deprecated.

Description copied from interface: JSONArray

Append an object value. This increases the array's length by one.

Specified by:

put in interface JSONArray

Parameters:

value - An object value. The value should be a Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONObject.NULL object.

Returns:

this.

put

public JSONArray put(int index,
                     boolean value)
              throws JSONException

Deprecated.

Description copied from interface: JSONArray

Put or replace a boolean value in the JSONArray. If the index is greater than the length of the JSONArray, then null elements will be added as necessary to pad it out.

Specified by:

put in interface JSONArray

Parameters:

index - The subscript.

value - A boolean value.

Returns:

this.

Throws:

JSONException - If the index is negative.

put

public JSONArray put(int index,
                     double value)
              throws JSONException

Deprecated.

Description copied from interface: JSONArray

Put or replace a double value. If the index is greater than the length of the JSONArray, then null elements will be added as necessary to pad it out.

Specified by:

put in interface JSONArray

Parameters:

index - The subscript.

value - A double value.

Returns:

this.

Throws:

JSONException - If the index is negative or if the value is not finite.

put

public JSONArray put(int index,
                     int value)
              throws JSONException

Deprecated.

Description copied from interface: JSONArray

Put or replace an int value. If the index is greater than the length of the JSONArray, then null elements will be added as necessary to pad it out.

Specified by:

put in interface JSONArray

Parameters:

index - The subscript.

value - An int value.

Returns:

this.

Throws:

JSONException - If the index is negative.

put

public JSONArray put(int index,
                     long value)
              throws JSONException

Deprecated.

Description copied from interface: JSONArray

Put or replace a long value. If the index is greater than the length of the JSONArray, then null elements will be added as necessary to pad it out.

Specified by:

put in interface JSONArray

Parameters:

index - The subscript.

value - A long value.

Returns:

this.

Throws:

JSONException - If the index is negative.

put

public JSONArray put(int index,
                     java.lang.Object value)
              throws JSONException

Deprecated.

Description copied from interface: JSONArray

Put or replace an object value in the JSONArray. If the index is greater than the length of the JSONArray, then null elements will be added as necessary to pad it out.

Specified by:

put in interface JSONArray

Parameters:

index - The subscript.

value - The value to put into the array. The value should be a Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONObject.NULL object.

Returns:

this.

Throws:

JSONException - If the index is negative or if the the value is an invalid number.

remove

public java.lang.Object remove(int index)

Deprecated.

Description copied from interface: JSONArray

Remove an index and close the hole.

Specified by:

remove in interface JSONArray

Parameters:

index - The index of the element to be removed.

Returns:

The value that was associated with the index, or null if there was no value.

remove

public boolean remove(java.lang.Object obj)
               throws java.lang.UnsupportedOperationException

Deprecated.

Description copied from interface: JSONArray

Remove the first instance of an Object from the array.

Specified by:

remove in interface JSONArray

Parameters:

obj - The object to be removed from the array.

Returns:

true if it is has been removed.

Throws:

java.lang.UnsupportedOperationException

toString

public java.lang.String toString(int indentFactor)

Deprecated.

Description copied from interface: JSONComponent

Make a prettyprinted JSON text of this JSONObject.

Warning: This method assumes that the data structure is acyclical.

Specified by:

toString in interface JSONComponent

Parameters:

indentFactor - The number of spaces to add to each level of indentation.

Returns:

a printable, displayable, portable, transmittable representation of the object, beginning with { (left brace) and ending with } (right brace).

toString

public java.lang.String toString()

Deprecated.

Description copied from interface: JSONComponent

Make a JSON text of this JSONObject. For compactness, no whitespace is added. If this would not result in a syntactically correct JSON text, then null will be returned instead.

Warning: This method assumes that the data structure is acyclical.

Specified by:

toString in interface JSONComponent

Overrides:

toString in class java.lang.Object

Returns:

a printable, displayable, portable, transmittable representation of the object, beginning with { (left brace) and ending with } (right brace).

write

public java.lang.Appendable write(java.lang.Appendable writer)
                           throws java.io.IOException

Deprecated.

Description copied from interface: JSONComponent

Write the contents of the JSONComponent as JSON text to a writer. For compactness, no whitespace is added.

Warning: This method assumes that the data structure is acyclical.

Specified by:

write in interface JSONComponent

Returns:

The writer.

Throws:

java.io.IOException

equals

public boolean equals(java.lang.Object obj)

Deprecated.

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Deprecated.

Overrides:

hashCode in class java.lang.Object

equalsList

public boolean equalsList(java.util.List<java.lang.Object> list)

Deprecated.

Specified by:

equalsList in interface JSONArray

iterator

public java.util.Iterator<java.lang.Object> iterator()

Deprecated.

Specified by:

iterator in interface java.lang.Iterable<java.lang.Object>

Specified by:

iterator in interface JSONArray

indexOf

public int indexOf(java.lang.Object value)

Deprecated.

Specified by:

indexOf in interface JSONArray

toString

public java.lang.String toString(int indentFactor,
                                 int indent)

Deprecated.

Description copied from interface: JSONComponent

Make a prettyprinted JSON text of this JSONObject.

Warning: This method assumes that the data structure is acyclical.

Specified by:

toString in interface JSONComponent

Parameters:

indentFactor - The number of spaces to add to each level of indentation.

indent - The indentation of the top level.

Returns:

a printable, displayable, transmittable representation of the object, beginning with { (left brace) and ending with } (right brace).

clone

public <A extends JSONArray,O extends JSONObject> A clone(JSONBuilder<A,O> builder)
                                                   throws JSONException

Deprecated.

Specified by:

clone in interface JSONArray

Throws:

JSONException