org.json

Interface JSONArray

All Superinterfaces:

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

All Known Implementing Classes:

ImmutableJSONArray, ListBasedJSONArray, UnmodifiableJSONArray, WritableJSONArray

public interface JSONArray
extends java.lang.Iterable<java.lang.Object>, JSONComponent

Method Summary

Modifier and Type	Method and Description
<A extends JSONArray,O extends JSONObject> A	clone(JSONBuilder<A,O> builder)
boolean	equalsList(java.util.List<java.lang.Object> list)
java.lang.Object	get(int index) Get the object value associated with an index.
boolean	getBoolean(int index) Get the boolean value associated with an index.
double	getDouble(int index) Get the double value associated with an index.
int	getInt(int index) Get the int value associated with an index.
JSONArray	getJSONArray(int index) Get the JSONArray associated with an index.
JSONObject	getJSONObject(int index) Get the JSONObject associated with an index.
long	getLong(int index) Get the long value associated with an index.
java.lang.String	getString(int index) Get the string associated with an index.
int	indexOf(java.lang.Object value)
boolean	isNull(int index) Determine if the value is null.
java.util.Iterator<java.lang.Object>	iterator()
int	length() Get the number of elements in the JSONArray, included nulls.
java.lang.Object	opt(int index) Get the optional object value associated with an index.
boolean	optBoolean(int index) Get the optional boolean value associated with an index.
boolean	optBoolean(int index, boolean defaultValue) Get the optional boolean value associated with an index.
double	optDouble(int index) Get the optional double value associated with an index.
double	optDouble(int index, double defaultValue) Get the optional double value associated with an index.
int	optInt(int index) Get the optional int value associated with an index.
int	optInt(int index, int defaultValue) Get the optional int value associated with an index.
JSONArray	optJSONArray(int index) Get the optional JSONArray associated with an index.
JSONObject	optJSONObject(int index) Get the optional JSONObject associated with an index.
long	optLong(int index) Get the optional long value associated with an index.
long	optLong(int index, long defaultValue) Get the optional long value associated with an index.
java.lang.String	optString(int index) Get the optional string value associated with an index.
java.lang.String	optString(int index, java.lang.String defaultValue) Get the optional string associated with an index.
JSONArray	put(boolean value) Append a boolean value.
JSONArray	put(double value) Append a double value.
JSONArray	put(int value) Append an int value.
JSONArray	put(int index, boolean value) Put or replace a boolean value in the JSONArray.
JSONArray	put(int index, double value) Put or replace a double value.
JSONArray	put(int index, int value) Put or replace an int value.
JSONArray	put(int index, long value) Put or replace a long value.
JSONArray	put(int index, java.lang.Object value) Put or replace an object value in the JSONArray.
JSONArray	put(long value) Append an long value.
JSONArray	put(java.lang.Object value) Append an object value.
java.lang.Object	remove(int index) Remove an index and close the hole.
boolean	remove(java.lang.Object obj) Remove the first instance of an Object from the array.

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface org.json.JSONComponent

toString, toString, toString, write

Method Detail

iterator

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

Specified by:

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

equalsList

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

clone

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

Throws:

JSONException

get

java.lang.Object get(int index)

Get the object value associated with an index.

Parameters:

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

Returns:

An object value.

getBoolean

boolean getBoolean(int index)
            throws JSONException

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

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

double getDouble(int index)
          throws JSONException

Get the double value associated with an index.

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

int getInt(int index)
    throws JSONException

Get the int value associated with an index.

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

JSONArray getJSONArray(int index)
                throws JSONException

Get the JSONArray associated with an index.

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

JSONObject getJSONObject(int index)
                  throws JSONException

Get the JSONObject associated with an index.

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

long getLong(int index)
      throws JSONException

Get the long value associated with an index.

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

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

Get the string associated with an index.

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

boolean isNull(int index)

Determine if the value is null.

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

int length()

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

Returns:

The length (or size).

opt

java.lang.Object opt(int index)

Get the optional object value associated with an index.

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

boolean optBoolean(int index)

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".

Parameters:

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

Returns:

The truth.

optBoolean

boolean optBoolean(int index,
                   boolean defaultValue)

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).

Parameters:

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

defaultValue - A boolean default.

Returns:

The truth.

optDouble

double optDouble(int index)

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.

Parameters:

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

Returns:

The value.

optDouble

double optDouble(int index,
                 double defaultValue)

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.

Parameters:

index - subscript

defaultValue - The default value.

Returns:

The value.

optInt

int optInt(int index)

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.

Parameters:

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

Returns:

The value.

optInt

int optInt(int index,
           int defaultValue)

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.

Parameters:

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

defaultValue - The default value.

Returns:

The value.

optJSONArray

JSONArray optJSONArray(int index)

Get the optional JSONArray associated with an index.

Parameters:

index - subscript

Returns:

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

optJSONObject

JSONObject optJSONObject(int index)

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.

Parameters:

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

Returns:

A JSONObject value.

optLong

long optLong(int index)

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.

Parameters:

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

Returns:

The value.

optLong

long optLong(int index,
             long defaultValue)

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.

Parameters:

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

defaultValue - The default value.

Returns:

The value.

optString

java.lang.String optString(int index)

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.

Parameters:

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

Returns:

A String value.

optString

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

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

Parameters:

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

defaultValue - The default value.

Returns:

A String value.

put

JSONArray put(boolean value)

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

Parameters:

value - A boolean value.

Returns:

this.

put

JSONArray put(double value)
       throws JSONException

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

Parameters:

value - A double value.

Returns:

this.

Throws:

JSONException - if the value is not finite.

put

JSONArray put(int value)

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

Parameters:

value - An int value.

Returns:

this.

put

JSONArray put(long value)

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

Parameters:

value - A long value.

Returns:

this.

put

JSONArray put(java.lang.Object value)

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

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

JSONArray put(int index,
              boolean value)
       throws JSONException

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.

Parameters:

index - The subscript.

value - A boolean value.

Returns:

this.

Throws:

JSONException - If the index is negative.

put

JSONArray put(int index,
              double value)
       throws JSONException

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.

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

JSONArray put(int index,
              int value)
       throws JSONException

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.

Parameters:

index - The subscript.

value - An int value.

Returns:

this.

Throws:

JSONException - If the index is negative.

put

JSONArray put(int index,
              long value)
       throws JSONException

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.

Parameters:

index - The subscript.

value - A long value.

Returns:

this.

Throws:

JSONException - If the index is negative.

put

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

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.

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

java.lang.Object remove(int index)

Remove an index and close the hole.

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

boolean remove(java.lang.Object obj)

Remove the first instance of an Object from the array.

Parameters:

obj - The object to be removed from the array.

Returns:

true if it is has been removed.

indexOf

int indexOf(java.lang.Object value)