## com.google.gwt.json.client
Class JSONArray

    java.lang.Object
      com.google.gwt.json.client.JSONValue
          com.google.gwt.json.client.JSONArray

public class JSONArray
extends JSONValue

Represents an array of `JSONValue` objects.

Constructor Summary
`JSONArray()` Creates an empty JSONArray.
`JSONArray(JavaScriptObject arr)` Creates a new JSONArray from the supplied JavaScriptObject representing a JavaScript array.

Method Summary
`JSONValue` `get(int index)` Returns the value at the specified index position.
`JSONArray` `isArray()` Returns `this`, as this is a JSONArray.
`JSONValue` `set(int index, JSONValue jsonValue)` Sets the specified index to the given value.
`int` `size()` Returns the number of elements in this array.
`java.lang.String` `toString()` Create the JSON encoded string representation of this JSONArray instance.

Methods inherited from class com.google.gwt.json.client.JSONValue
`isBoolean, isNull, isNumber, isObject, isString`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### JSONArray

    public JSONArray()

  Creates an empty JSONArray.

### JSONArray

    public JSONArray(JavaScriptObject arr)

  Creates a new JSONArray from the supplied JavaScriptObject representing a JavaScript array.

Parameters:
  `arr` - a JavaScript array

Method Detail

### get

    public JSONValue get(int index)
                  throws JSONException

  Returns the value at the specified index position.

  Parameters:
    `index` - the index of the array item to retrieve
  Returns:
    the value at this index, or `null` if this index is empty
  Throws:
    `JSONException`

### isArray

    public JSONArray isArray()

  Returns `this`, as this is a JSONArray.

  Overrides:
    `isArray` in class `JSONValue`
  Returns:
    a reference to a JSONArray if this JSONValue is a JSONArray or `null` otherwise.

### set

    public JSONValue set(int index,
                         JSONValue jsonValue)

  Sets the specified index to the given value.

  Parameters:
    `index` - the index to set
    `jsonValue` - the value to set
  Returns:
    the previous value at this index, or `null` if this index was empty

### size

    public int size()

  Returns the number of elements in this array.

  Returns:
    size of this array

### toString

    public java.lang.String toString()
                              throws JSONException

  Create the JSON encoded string representation of this JSONArray instance. This method may take a long time to execute if the underlying array is large.

  Specified by:
    `toString` in class `JSONValue`
  Throws:
    `JSONException`