Added in API level 1

JSONArray

open class JSONArray

kotlin.Any
↳	org.json.JSONArray

A dense indexed sequence of values. Values may be any mix of JSONObjects, other JSONArrays, Strings, Booleans, Integers, Longs, Doubles, null or JSONObject.NULL. Values may not be NaNs, infinities, or of any type not listed here.

JSONArray has the same type coercion behavior and optional/mandatory accessors as JSONObject. See that class' documentation for details.

Warning: this class represents null in two incompatible ways: the standard Java null reference, and the sentinel value org.json.JSONObject#NULL. In particular, get fails if the requested index holds the null reference, but succeeds if it holds JSONObject.NULL.

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 overridable methods is not specified. See Effective Java Item 17, "Design and Document or inheritance or else prohibit it" for further information.

Summary

Public constructors
`JSONArray()` Creates a `JSONArray` with no values.
`JSONArray(array: Any!)` Creates a new `JSONArray` with values from the given primitive array.
`JSONArray(json: String!)` Creates a new `JSONArray` with values from the JSON string.
`JSONArray(copyFrom: MutableCollection<Any?>!)` Creates a new `JSONArray` by copying all values from the given collection.
`JSONArray(readFrom: JSONTokener!)` Creates a new `JSONArray` with values from the next array in the tokener.

Public methods
open Boolean	`equals(other: Any?)`
open Any!	`get(index: Int)` Returns the value at `index`.
open Boolean	`getBoolean(index: Int)` Returns the value at `index` if it exists and is a boolean or can be coerced to a boolean.
open Double	`getDouble(index: Int)` Returns the value at `index` if it exists and is a double or can be coerced to a double.
open Int	`getInt(index: Int)` Returns the value at `index` if it exists and is an int or can be coerced to an int.
open JSONArray!	`getJSONArray(index: Int)` Returns the value at `index` if it exists and is a `JSONArray`.
open JSONObject!	`getJSONObject(index: Int)` Returns the value at `index` if it exists and is a `JSONObject`.
open Long	`getLong(index: Int)` Returns the value at `index` if it exists and is a long or can be coerced to a long.
open String!	`getString(index: Int)` Returns the value at `index` if it exists, coercing it if necessary.
open Int	`hashCode()`
open Boolean	`isNull(index: Int)` Returns true if this array has no value at `index`, or if its value is the `null` reference or `JSONObject.NULL`.
open String!	`join(separator: String!)` Returns a new string by alternating this array's values with `separator`.
open Int	`length()` Returns the number of values in this array.
open Any!	`opt(index: Int)` Returns the value at `index`, or null if the array has no value at `index`.
open Boolean	`optBoolean(index: Int)` Returns the value at `index` if it exists and is a boolean or can be coerced to a boolean.
open Boolean	`optBoolean(index: Int, fallback: Boolean)` Returns the value at `index` if it exists and is a boolean or can be coerced to a boolean.
open Double	`optDouble(index: Int)` Returns the value at `index` if it exists and is a double or can be coerced to a double.
open Double	`optDouble(index: Int, fallback: Double)` Returns the value at `index` if it exists and is a double or can be coerced to a double.
open Int	`optInt(index: Int)` Returns the value at `index` if it exists and is an int or can be coerced to an int.
open Int	`optInt(index: Int, fallback: Int)` Returns the value at `index` if it exists and is an int or can be coerced to an int.
open JSONArray!	`optJSONArray(index: Int)` Returns the value at `index` if it exists and is a `JSONArray`.
open JSONObject!	`optJSONObject(index: Int)` Returns the value at `index` if it exists and is a `JSONObject`.
open Long	`optLong(index: Int)` Returns the value at `index` if it exists and is a long or can be coerced to a long.
open Long	`optLong(index: Int, fallback: Long)` Returns the value at `index` if it exists and is a long or can be coerced to a long.
open String!	`optString(index: Int)` Returns the value at `index` if it exists, coercing it if necessary.
open String!	`optString(index: Int, fallback: String!)` Returns the value at `index` if it exists, coercing it if necessary.
open JSONArray!	`put(value: Boolean)` Appends `value` to the end of this array.
open JSONArray!	`put(value: Double)` Appends `value` to the end of this array.
open JSONArray!	`put(value: Int)` Appends `value` to the end of this array.
open JSONArray!	`put(index: Int, value: Boolean)` Sets the value at `index` to `value`, null padding this array to the required length if necessary.
open JSONArray!	`put(index: Int, value: Double)` Sets the value at `index` to `value`, null padding this array to the required length if necessary.
open JSONArray!	`put(index: Int, value: Int)` Sets the value at `index` to `value`, null padding this array to the required length if necessary.
open JSONArray!	`put(index: Int, value: Any!)` Sets the value at `index` to `value`, null padding this array to the required length if necessary.
open JSONArray!	`put(index: Int, value: Long)` Sets the value at `index` to `value`, null padding this array to the required length if necessary.
open JSONArray!	`put(value: Any!)` Appends `value` to the end of this array.
open JSONArray!	`put(value: Long)` Appends `value` to the end of this array.
open Any!	`remove(index: Int)` Removes and returns the value at `index`, or null if the array has no value at `index`.
open JSONObject!	`toJSONObject(names: JSONArray!)` Returns a new object whose values are the values in this array, and whose names are the values in `names`.
open String	`toString()` Encodes this array as a compact JSON string, such as: [94043,90210]
open String!	`toString(indentSpaces: Int)` Encodes this array as a human readable JSON string for debugging, such as: [ 94043, 90210 ]

Public constructors

JSONArray

Added in API level 1

JSONArray()

Creates a JSONArray with no values.

JSONArray

Added in API level 19

JSONArray(array: Any!)

Creates a new JSONArray with values from the given primitive array.

JSONArray

Added in API level 1

JSONArray(json: String!)

Creates a new JSONArray with values from the JSON string.

Parameters
`json`	String!: a JSON-encoded string containing an array.

Exceptions
`org.json.JSONException`	if the parse fails or doesn't yield a `JSONArray`.

JSONArray

Added in API level 1

JSONArray(copyFrom: MutableCollection<Any?>!)

Creates a new JSONArray by copying all values from the given collection.

Parameters
`copyFrom`	MutableCollection<Any?>!: a collection whose values are of supported types. Unsupported values are not permitted and will yield an array in an inconsistent state.

JSONArray

Added in API level 1

JSONArray(readFrom: JSONTokener!)

Creates a new JSONArray with values from the next array in the tokener.

Parameters
`readFrom`	JSONTokener!: a tokener whose nextValue() method will yield a `JSONArray`.

Exceptions
`org.json.JSONException`	if the parse fails or doesn't yield a `JSONArray`.

Public methods

equals

Added in API level 1

open fun equals(other: Any?): Boolean

Parameters
`obj`	the reference object with which to compare.

Return
`Boolean`	`true` if this object is the same as the obj argument; `false` otherwise.

get

Added in API level 1

open fun get(index: Int): Any!

Returns the value at index.

Exceptions
`org.json.JSONException`	if this array has no value at `index`, or if that value is the `null` reference. This method returns normally if the value is `JSONObject#NULL`.

getBoolean

Added in API level 1

open fun getBoolean(index: Int): Boolean

Returns the value at index if it exists and is a boolean or can be coerced to a boolean.

Exceptions
`org.json.JSONException`	if the value at `index` doesn't exist or cannot be coerced to a boolean.

getDouble

Added in API level 1

open fun getDouble(index: Int): Double

Returns the value at index if it exists and is a double or can be coerced to a double.

Exceptions
`org.json.JSONException`	if the value at `index` doesn't exist or cannot be coerced to a double.

getInt

Added in API level 1

open fun getInt(index: Int): Int

Returns the value at index if it exists and is an int or can be coerced to an int.

Exceptions
`org.json.JSONException`	if the value at `index` doesn't exist or cannot be coerced to a int.

getJSONArray

Added in API level 1

open fun getJSONArray(index: Int): JSONArray!

Returns the value at index if it exists and is a JSONArray.

Exceptions
`org.json.JSONException`	if the value doesn't exist or is not a `JSONArray`.

getJSONObject

Added in API level 1

open fun getJSONObject(index: Int): JSONObject!

Returns the value at index if it exists and is a JSONObject.

Exceptions
`org.json.JSONException`	if the value doesn't exist or is not a `JSONObject`.

getLong

Added in API level 1

open fun getLong(index: Int): Long

Returns the value at index if it exists and is a long or can be coerced to a long.

Exceptions
`org.json.JSONException`	if the value at `index` doesn't exist or cannot be coerced to a long.

getString

Added in API level 1

open fun getString(index: Int): String!

Returns the value at index if it exists, coercing it if necessary.

Exceptions
`org.json.JSONException`	if no such value exists.

hashCode

Added in API level 1

open fun hashCode(): Int

Return
`Int`	a hash code value for this object.

isNull

Added in API level 1

open fun isNull(index: Int): Boolean

Returns true if this array has no value at index, or if its value is the null reference or JSONObject.NULL.

join

Added in API level 1

open fun join(separator: String!): String!

Returns a new string by alternating this array's values with separator. This array's string values are quoted and have their special characters escaped. For example, the array containing the strings '12" pizza', 'taco' and 'soda' joined on '+' returns this:

"12\" pizza"+"taco"+"soda"

length

Added in API level 1

open fun length(): Int

Returns the number of values in this array.

opt

Added in API level 1

open fun opt(index: Int): Any!

Returns the value at index, or null if the array has no value at index.

optBoolean

Added in API level 1

open fun optBoolean(index: Int): Boolean

Returns the value at index if it exists and is a boolean or can be coerced to a boolean. Returns false otherwise.

optBoolean

Added in API level 1

open fun optBoolean(
    index: Int, 
    fallback: Boolean
): Boolean

Returns the value at index if it exists and is a boolean or can be coerced to a boolean. Returns fallback otherwise.

optDouble

Added in API level 1

open fun optDouble(index: Int): Double

Returns the value at index if it exists and is a double or can be coerced to a double. Returns NaN otherwise.

optDouble

Added in API level 1

open fun optDouble(
    index: Int, 
    fallback: Double
): Double

Returns the value at index if it exists and is a double or can be coerced to a double. Returns fallback otherwise.

optInt

Added in API level 1

open fun optInt(index: Int): Int

Returns the value at index if it exists and is an int or can be coerced to an int. Returns 0 otherwise.

optInt

Added in API level 1

open fun optInt(
    index: Int, 
    fallback: Int
): Int

Returns the value at index if it exists and is an int or can be coerced to an int. Returns fallback otherwise.

optJSONArray

Added in API level 1

open fun optJSONArray(index: Int): JSONArray!

Returns the value at index if it exists and is a JSONArray. Returns null otherwise.

optJSONObject

Added in API level 1

open fun optJSONObject(index: Int): JSONObject!

Returns the value at index if it exists and is a JSONObject. Returns null otherwise.

optLong

Added in API level 1

open fun optLong(index: Int): Long

Returns the value at index if it exists and is a long or can be coerced to a long. Returns 0 otherwise.

optLong

Added in API level 1

open fun optLong(
    index: Int, 
    fallback: Long
): Long

Returns the value at index if it exists and is a long or can be coerced to a long. Returns fallback otherwise.

optString

Added in API level 1

open fun optString(index: Int): String!

Returns the value at index if it exists, coercing it if necessary. Returns the empty string if no such value exists.

optString

Added in API level 1

open fun optString(
    index: Int, 
    fallback: String!
): String!

Returns the value at index if it exists, coercing it if necessary. Returns fallback if no such value exists.

put

Added in API level 1

open fun put(value: Boolean): JSONArray!

Appends value to the end of this array.

Return
`JSONArray!`	this array.

put

Added in API level 1

open fun put(value: Double): JSONArray!

Appends value to the end of this array.

Parameters
`value`	Double: a finite value. May not be `NaNs` or `infinities`.

Return
`JSONArray!`	this array.

put

Added in API level 1

open fun put(value: Int): JSONArray!

Appends value to the end of this array.

Return
`JSONArray!`	this array.