propane 3.4.0-java → 3.7.0.pre-java

data/src/main/java/processing/data/JSONArray.java

@@ -33,6 +33,7 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
  */
+
 import java.io.File;
 import java.io.IOException;
 import java.io.PrintWriter;
@@ -98,109 +99,116 @@ import processing.core.PApplet;
  */
 public class JSONArray {
 
-    /**
-     * The arrayList where the JSONArray's properties are kept.
-     */
-    private final ArrayList<Object> myArrayList;
-
-    /**
-     * Construct an empty JSONArray.
-     */
-    public JSONArray() {
-        this.myArrayList = new ArrayList<>();
-    }
-
-    /**
-     * @nowebref
-     */
-    public JSONArray(Reader reader) {
-        this(new JSONTokener(reader));
+  /**
+   * The arrayList where the JSONArray's properties are kept.
+   */
+  private final ArrayList<Object> myArrayList;
+
+
+  /**
+   * Construct an empty JSONArray.
+   */
+  public JSONArray() {
+    this.myArrayList = new ArrayList<>();
+  }
+
+
+  /**
+   * @nowebref
+   */
+  public JSONArray(Reader reader) {
+    this(new JSONTokener(reader));
+  }
+
+
+  /**
+   * Construct a JSONArray from a JSONTokener.
+   *
+   * @param x A JSONTokener
+   * @throws RuntimeException If there is a syntax error.
+   * @nowebref
+   */
+  protected JSONArray(JSONTokener x) {
+    this();
+    if (x.nextClean() != '[') {
+      throw new RuntimeException("A JSONArray text must start with '['");
     }
-
-    /**
-     * Construct a JSONArray from a JSONTokener.
-     *
-     * @param x A JSONTokener
-     * @throws RuntimeException If there is a syntax error.
-     * @nowebref
-     */
-    protected JSONArray(JSONTokener x) {
-        this();
-        if (x.nextClean() != '[') {
-            throw new RuntimeException("A JSONArray text must start with '['");
+    if (x.nextClean() != ']') {
+      x.back();
+      for (;;) {
+        if (x.nextClean() == ',') {
+          x.back();
+          myArrayList.add(JSONObject.NULL);
+        } else {
+          x.back();
+          myArrayList.add(x.nextValue());
         }
-        if (x.nextClean() != ']') {
-            x.back();
-            for (;;) {
-                if (x.nextClean() == ',') {
-                    x.back();
-                    myArrayList.add(JSONObject.NULL);
-                } else {
-                    x.back();
-                    myArrayList.add(x.nextValue());
-                }
-                switch (x.nextClean()) {
-                    case ';':
-                    case ',':
-                        if (x.nextClean() == ']') {
-                            return;
-                        }
-                        x.back();
-                        break;
-                    case ']':
-                        return;
-                    default:
-                        throw new RuntimeException("Expected a ',' or ']'");
-                }
-            }
+        switch (x.nextClean()) {
+        case ';':
+        case ',':
+          if (x.nextClean() == ']') {
+            return;
+          }
+          x.back();
+          break;
+        case ']':
+          return;
+        default:
+          throw new RuntimeException("Expected a ',' or ']'");
         }
+      }
     }
+  }
 
-    /**
-     * @nowebref
-     */
-    public JSONArray(IntList list) {
-        myArrayList = new ArrayList<>();
-        for (int item : list.values()) {
-            myArrayList.add(Integer.valueOf(item));
-        }
-    }
 
-    /**
-     * @nowebref
-     */
-    public JSONArray(FloatList list) {
-        myArrayList = new ArrayList<>();
-        for (float item : list.values()) {
-            myArrayList.add(Float.valueOf(item));
-        }
+  /**
+   * @nowebref
+   */
+  public JSONArray(IntList list) {
+    myArrayList = new ArrayList<>();
+    for (int item : list.values()) {
+      myArrayList.add(Integer.valueOf(item));
     }
+  }
 
-    /**
-     * @nowebref
-     */
-    public JSONArray(StringList list) {
-        myArrayList = new ArrayList<>();
-        for (String item : list.values()) {
-            myArrayList.add(item);
-        }
+
+  /**
+   * @nowebref
+   */
+  public JSONArray(FloatList list) {
+    myArrayList = new ArrayList<>();
+    for (float item : list.values()) {
+      myArrayList.add(Float.valueOf(item));
     }
+  }
 
-    /**
-     * Construct a JSONArray from a source JSON text.
-     *
-     * @param source A string that begins with <code>[</code>&nbsp;<small>(left
-     * bracket)</small>
-     * and ends with <code>]</code>&nbsp;<small>(right bracket)</small>.
-     * @return {@code null} if there is a syntax error.
-     */
-    static public JSONArray parse(String source) {
-        try {
-            return new JSONArray(new JSONTokener(source));
-        } catch (Exception e) {
-            return null;
-        }
+
+  /**
+   * @nowebref
+   */
+  public JSONArray(StringList list) {
+    myArrayList = new ArrayList<>();
+    for (String item : list.values()) {
+      myArrayList.add(item);
+    }
+  }
+
+
+  /**
+   * Construct a JSONArray from a source JSON text.
+   * @param source     A string that begins with
+   * <code>[</code>&nbsp;<small>(left bracket)</small>
+   *  and ends with <code>]</code>&nbsp;<small>(right bracket)</small>.
+   *  @return {@code null} if there is a syntax error.
+   */
+  static public JSONArray parse(String source) {
+    try {
+      return new JSONArray(new JSONTokener(source));
+    } catch (Exception e) {
+      return null;
     }
+  }
+
 
 //  /**
 //   * Construct a JSONArray from a Collection.
@@ -215,397 +223,411 @@ public class JSONArray {
 //      }
 //    }
 //  }
-    // TODO not decided whether we keep this one, but used heavily by JSONObject
-    /**
-     * Construct a JSONArray from an array
-     *
-     * @throws RuntimeException If not an array.
-     */
-    protected JSONArray(Object array) {
-        this();
-        if (array.getClass().isArray()) {
-            int length = Array.getLength(array);
-            for (int i = 0; i < length; i += 1) {
-                this.append(JSONObject.wrap(Array.get(array, i)));
-            }
-        } else {
-            throw new RuntimeException("JSONArray initial value should be a string or collection or array.");
-        }
-    }
 
-    /**
-     * Get the optional object value associated with an index.
-     *
-     * @param index must be between 0 and length() - 1
-     * @return An object value, or null if there is no object at that index.
-     */
-    private Object opt(int index) {
-        if (index < 0 || index >= this.size()) {
-            return null;
-        }
-        return myArrayList.get(index);
-    }
 
-    /**
-     * Get the object value associated with an index.
-     *
-     * @param index must be between 0 and length() - 1
-     * @return An object value.
-     * @throws RuntimeException If there is no value for the index.
-     */
-    public Object get(int index) {
-        Object object = opt(index);
-        if (object == null) {
-            throw new RuntimeException("JSONArray[" + index + "] not found.");
-        }
-        return object;
+  // TODO not decided whether we keep this one, but used heavily by JSONObject
+  /**
+   * Construct a JSONArray from an array
+   * @throws RuntimeException If not an array.
+   */
+  protected JSONArray(Object array) {
+    this();
+    if (array.getClass().isArray()) {
+      int length = Array.getLength(array);
+      for (int i = 0; i < length; i += 1) {
+        this.append(JSONObject.wrap(Array.get(array, i)));
+      }
+    } else {
+      throw new RuntimeException("JSONArray initial value should be a string or collection or array.");
     }
-
-    /**
-     * Get the string associated with an index.
-     *
-     * @webref jsonarray:method
-     * @brief Gets the String value associated with an index
-     * @param index must be between 0 and length() - 1
-     * @return A string value.
-     * @throws RuntimeException If there is no string value for the index.
-     * @see JSONArray#getInt(int)
-     * @see JSONArray#getFloat(int)
-     * @see JSONArray#getBoolean(int)
-     */
-    public String getString(int index) {
-        Object object = this.get(index);
-        if (object instanceof String) {
-            return (String) object;
-        }
-        throw new RuntimeException("JSONArray[" + index + "] not a string.");
+  }
+
+
+  /**
+   * Get the optional object value associated with an index.
+   * @param index must be between 0 and length() - 1
+   * @return      An object value, or null if there is no
+   *              object at that index.
+   */
+  private Object opt(int index) {
+    if (index < 0 || index >= this.size()) {
+      return null;
     }
-
-    /**
-     * Get the optional string associated with an index. The defaultValue is
-     * returned if the key is not found.
-     *
-     * @param index The index must be between 0 and length() - 1.
-     * @param defaultValue The default value.
-     * @return A String value.
-     */
-    public String getString(int index, String defaultValue) {
-        Object object = this.opt(index);
-        return JSONObject.NULL.equals(object) ? defaultValue : object.toString();
+    return myArrayList.get(index);
+  }
+
+
+  /**
+   * Get the object value associated with an index.
+   * @param index must be between 0 and length() - 1
+   * @return An object value.
+   * @throws RuntimeException If there is no value for the index.
+   */
+  public Object get(int index) {
+    Object object = opt(index);
+    if (object == null) {
+      throw new RuntimeException("JSONArray[" + index + "] not found.");
     }
-
-    /**
-     * Get the int value associated with an index.
-     *
-     * @webref jsonarray:method
-     * @brief Gets the int value associated with an index
-     * @param index must be between 0 and length() - 1
-     * @return The value.
-     * @throws RuntimeException If the key is not found or if the value is not a
-     * number.
-     * @see JSONArray#getFloat(int)
-     * @see JSONArray#getString(int)
-     * @see JSONArray#getBoolean(int)
-     */
-    public int getInt(int index) {
-        Object object = this.get(index);
-        try {
-            return object instanceof Number
-                    ? ((Number) object).intValue()
-                    : Integer.parseInt((String) object);
-        } catch (Exception e) {
-            throw new RuntimeException("JSONArray[" + index + "] is not a number.");
-        }
+    return object;
+  }
+
+
+  /**
+   * Get the string associated with an index.
+   *
+   * @webref jsonarray:method
+   * @brief Gets the String value associated with an index
+   * @param index must be between 0 and length() - 1
+   * @return      A string value.
+   * @throws RuntimeException If there is no string value for the index.
+   * @see JSONArray#getInt(int)
+   * @see JSONArray#getFloat(int)
+   * @see JSONArray#getBoolean(int)
+   */
+  public String getString(int index) {
+    Object object = this.get(index);
+    if (object instanceof String) {
+      return (String)object;
     }
-
-    /**
-     * 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.
-     *
-     * @param index The index must be between 0 and length() - 1.
-     * @param defaultValue The default value.
-     * @return The value.
-     */
-    public int getInt(int index, int defaultValue) {
-        try {
-            return getInt(index);
-        } catch (Exception e) {
-            return defaultValue;
-        }
+    throw new RuntimeException("JSONArray[" + index + "] not a string.");
+  }
+
+
+  /**
+   * Get the optional string associated with an index.
+   * The defaultValue is returned if the key is not found.
+   *
+   * @param index The index must be between 0 and length() - 1.
+   * @param defaultValue     The default value.
+   * @return      A String value.
+   */
+  public String getString(int index, String defaultValue) {
+    Object object = this.opt(index);
+    return JSONObject.NULL.equals(object) ? defaultValue : object.toString();
+  }
+
+
+  /**
+   * Get the int value associated with an index.
+   *
+   * @webref jsonarray:method
+   * @brief Gets the int value associated with an index
+   * @param index must be between 0 and length() - 1
+   * @return The value.
+   * @throws RuntimeException If the key is not found or if the value is not a number.
+   * @see JSONArray#getFloat(int)
+   * @see JSONArray#getString(int)
+   * @see JSONArray#getBoolean(int)
+   */
+  public int getInt(int index) {
+    Object object = this.get(index);
+    try {
+      return object instanceof Number
+        ? ((Number)object).intValue()
+          : Integer.parseInt((String)object);
+    } catch (Exception e) {
+      throw new RuntimeException("JSONArray[" + index + "] is not a number.");
     }
-
-    /**
-     * Get the long value associated with an index.
-     *
-     * @param index The index must be between 0 and length() - 1
-     * @return The value.
-     * @throws RuntimeException If the key is not found or if the value cannot
-     * be converted to a number.
-     */
-    public long getLong(int index) {
-        Object object = this.get(index);
-        try {
-            return object instanceof Number
-                    ? ((Number) object).longValue()
-                    : Long.parseLong((String) object);
-        } catch (Exception e) {
-            throw new RuntimeException("JSONArray[" + index + "] is not a number.");
-        }
+  }
+
+
+  /**
+   * 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.
+   * @param index The index must be between 0 and length() - 1.
+   * @param defaultValue     The default value.
+   * @return      The value.
+   */
+  public int getInt(int index, int defaultValue) {
+    try {
+      return getInt(index);
+    } catch (Exception e) {
+      return 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.
-     *
-     * @param index The index must be between 0 and length() - 1.
-     * @param defaultValue The default value.
-     * @return The value.
-     */
-    public long getLong(int index, long defaultValue) {
-        try {
-            return this.getLong(index);
-        } catch (Exception e) {
-            return defaultValue;
-        }
+  }
+
+
+  /**
+   * Get the long value associated with an index.
+   *
+   * @param index The index must be between 0 and length() - 1
+   * @return      The value.
+   * @throws   RuntimeException If the key is not found or if the value cannot
+   *  be converted to a number.
+   */
+  public long getLong(int index) {
+    Object object = this.get(index);
+    try {
+      return object instanceof Number
+        ? ((Number)object).longValue()
+          : Long.parseLong((String)object);
+    } catch (Exception e) {
+      throw new RuntimeException("JSONArray[" + index + "] is not a number.");
     }
-
-    /**
-     * Get a value from an index as a float. JSON uses 'double' values
-     * internally, so this is simply getDouble() cast to a float.
-     *
-     * @webref jsonarray:method
-     * @brief Gets the float value associated with an index
-     * @param index must be between 0 and length() - 1
-     * @see JSONArray#getInt(int)
-     * @see JSONArray#getString(int)
-     * @see JSONArray#getBoolean(int)
-     */
-    public float getFloat(int index) {
-        return (float) getDouble(index);
+  }
+
+
+  /**
+   * 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.
+   * @param index The index must be between 0 and length() - 1.
+   * @param defaultValue     The default value.
+   * @return      The value.
+   */
+  public long getLong(int index, long defaultValue) {
+    try {
+      return this.getLong(index);
+    } catch (Exception e) {
+      return defaultValue;
     }
-
-    public float getFloat(int index, float defaultValue) {
-        try {
-            return getFloat(index);
-        } catch (Exception e) {
-            return defaultValue;
-        }
+  }
+
+
+  /**
+   * Get a value from an index as a float. JSON uses 'double' values
+   * internally, so this is simply getDouble() cast to a float.
+   *
+   * @webref jsonarray:method
+   * @brief Gets the float value associated with an index
+   * @param index must be between 0 and length() - 1
+   * @see JSONArray#getInt(int)
+   * @see JSONArray#getString(int)
+   * @see JSONArray#getBoolean(int)
+   */
+  public float getFloat(int index) {
+    return (float) getDouble(index);
+  }
+
+
+  public float getFloat(int index, float defaultValue) {
+    try {
+      return getFloat(index);
+    } catch (Exception e) {
+      return defaultValue;
     }
-
-    /**
-     * Get the double value associated with an index.
-     *
-     * @param index must be between 0 and length() - 1
-     * @return The value.
-     * @throws RuntimeException If the key is not found or if the value cannot
-     * be converted to a number.
-     */
-    public double getDouble(int index) {
-        Object object = this.get(index);
-        try {
-            return object instanceof Number
-                    ? ((Number) object).doubleValue()
-                    : Double.parseDouble((String) object);
-        } catch (Exception e) {
-            throw new RuntimeException("JSONArray[" + index + "] is not a number.");
-        }
+  }
+
+
+  /**
+   * Get the double value associated with an index.
+   *
+   * @param index must be between 0 and length() - 1
+   * @return      The value.
+   * @throws   RuntimeException If the key is not found or if the value cannot
+   *  be converted to a number.
+   */
+  public double getDouble(int index) {
+    Object object = this.get(index);
+    try {
+      return object instanceof Number
+        ? ((Number)object).doubleValue()
+          : Double.parseDouble((String)object);
+    } catch (Exception e) {
+      throw new RuntimeException("JSONArray[" + index + "] is not a number.");
     }
-
-    /**
-     * 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.
-     *
-     * @param index subscript
-     * @param defaultValue The default value.
-     * @return The value.
-     */
-    public double getDouble(int index, double defaultValue) {
-        try {
-            return this.getDouble(index);
-        } catch (Exception e) {
-            return 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.
+   *
+   * @param index subscript
+   * @param defaultValue     The default value.
+   * @return      The value.
+   */
+  public double getDouble(int index, double defaultValue) {
+    try {
+      return this.getDouble(index);
+    } catch (Exception e) {
+      return defaultValue;
     }
-
-    /**
-     * Get the boolean value associated with an index. The string values "true"
-     * and "false" are converted to boolean.
-     *
-     * @webref jsonarray:method
-     * @brief Gets the boolean value associated with an index
-     * @param index must be between 0 and length() - 1
-     * @return The truth.
-     * @throws RuntimeException If there is no value for the index or if the
-     * value is not convertible to boolean.
-     * @see JSONArray#getInt(int)
-     * @see JSONArray#getFloat(int)
-     * @see JSONArray#getString(int)
-     */
-    public boolean getBoolean(int index) {
-        Object object = this.get(index);
-        if (object.equals(Boolean.FALSE)
-                || (object instanceof String
-                && ((String) object).equalsIgnoreCase("false"))) {
-            return false;
-        } else if (object.equals(Boolean.TRUE)
-                || (object instanceof String
-                && ((String) object).equalsIgnoreCase("true"))) {
-            return true;
-        }
-        throw new RuntimeException("JSONArray[" + index + "] is not a boolean.");
+  }
+
+
+  /**
+   * Get the boolean value associated with an index.
+   * The string values "true" and "false" are converted to boolean.
+   *
+   * @webref jsonarray:method
+   * @brief Gets the boolean value associated with an index
+   * @param index must be between 0 and length() - 1
+   * @return      The truth.
+   * @throws RuntimeException If there is no value for the index or if the
+   *  value is not convertible to boolean.
+   * @see JSONArray#getInt(int)
+   * @see JSONArray#getFloat(int)
+   * @see JSONArray#getString(int)
+   */
+  public boolean getBoolean(int index) {
+    Object object = this.get(index);
+    if (object.equals(Boolean.FALSE) ||
+      (object instanceof String &&
+        ((String)object).equalsIgnoreCase("false"))) {
+      return false;
+    } else if (object.equals(Boolean.TRUE) ||
+      (object instanceof String &&
+        ((String)object).equalsIgnoreCase("true"))) {
+      return true;
     }
-
-    /**
-     * 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).
-     *
-     * @param index The index must be between 0 and length() - 1.
-     * @param defaultValue A boolean default.
-     * @return The truth.
-     */
-    public boolean getBoolean(int index, boolean defaultValue) {
-        try {
-            return getBoolean(index);
-        } catch (Exception e) {
-            return defaultValue;
-        }
+    throw new RuntimeException("JSONArray[" + index + "] is not a boolean.");
+  }
+
+
+  /**
+   * 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).
+   *
+   * @param index The index must be between 0 and length() - 1.
+   * @param defaultValue     A boolean default.
+   * @return      The truth.
+   */
+  public boolean getBoolean(int index, boolean defaultValue)  {
+    try {
+      return getBoolean(index);
+    } catch (Exception e) {
+      return defaultValue;
     }
-
-    /**
-     * Get the JSONArray associated with an index.
-     *
-     * @webref jsonobject:method
-     * @brief Gets the JSONArray associated with an index value
-     * @param index must be between 0 and length() - 1
-     * @return A JSONArray value.
-     * @throws RuntimeException If there is no value for the index. or if the
-     * value is not a JSONArray
-     * @see JSONArray#getJSONObject(int)
-     * @see JSONArray#setJSONObject(int, JSONObject)
-     * @see JSONArray#setJSONArray(int, JSONArray)
-     */
-    public JSONArray getJSONArray(int index) {
-        Object object = this.get(index);
-        if (object instanceof JSONArray) {
-            return (JSONArray) object;
-        }
-        throw new RuntimeException("JSONArray[" + index + "] is not a JSONArray.");
+  }
+
+
+  /**
+   * Get the JSONArray associated with an index.
+   *
+   * @webref jsonobject:method
+   * @brief Gets the JSONArray associated with an index value
+   * @param index must be between 0 and length() - 1
+   * @return A JSONArray value.
+   * @throws RuntimeException If there is no value for the index. or if the
+   * value is not a JSONArray
+   * @see JSONArray#getJSONObject(int)
+   * @see JSONArray#setJSONObject(int, JSONObject)
+   * @see JSONArray#setJSONArray(int, JSONArray)
+   */
+  public JSONArray getJSONArray(int index) {
+    Object object = this.get(index);
+    if (object instanceof JSONArray) {
+      return (JSONArray)object;
     }
+    throw new RuntimeException("JSONArray[" + index + "] is not a JSONArray.");
+  }
 
-    public JSONArray getJSONArray(int index, JSONArray defaultValue) {
-        try {
-            return getJSONArray(index);
-        } catch (Exception e) {
-            return defaultValue;
-        }
-    }
 
-    /**
-     * Get the JSONObject associated with an index.
-     *
-     * @webref jsonobject:method
-     * @brief Gets the JSONObject associated with an index value
-     * @param index the index value of the object to get
-     * @return A JSONObject value.
-     * @throws RuntimeException If there is no value for the index or if the
-     * value is not a JSONObject
-     * @see JSONArray#getJSONArray(int)
-     * @see JSONArray#setJSONObject(int, JSONObject)
-     * @see JSONArray#setJSONArray(int, JSONArray)
-     */
-    public JSONObject getJSONObject(int index) {
-        Object object = this.get(index);
-        if (object instanceof JSONObject) {
-            return (JSONObject) object;
-        }
-        throw new RuntimeException("JSONArray[" + index + "] is not a JSONObject.");
+  public JSONArray getJSONArray(int index, JSONArray defaultValue) {
+    try {
+      return getJSONArray(index);
+    } catch (Exception e) {
+      return defaultValue;
     }
-
-    public JSONObject getJSONObject(int index, JSONObject defaultValue) {
-        try {
-            return getJSONObject(index);
-        } catch (Exception e) {
-            return defaultValue;
-        }
+  }
+
+
+  /**
+   * Get the JSONObject associated with an index.
+   *
+   * @webref jsonobject:method
+   * @brief Gets the JSONObject associated with an index value
+   * @param index the index value of the object to get
+   * @return A JSONObject value.
+   * @throws RuntimeException If there is no value for the index or if the
+   * value is not a JSONObject
+   * @see JSONArray#getJSONArray(int)
+   * @see JSONArray#setJSONObject(int, JSONObject)
+   * @see JSONArray#setJSONArray(int, JSONArray)
+   */
+  public JSONObject getJSONObject(int index) {
+    Object object = this.get(index);
+    if (object instanceof JSONObject) {
+      return (JSONObject)object;
     }
+    throw new RuntimeException("JSONArray[" + index + "] is not a JSONObject.");
+  }
 
-    /**
-     * Get this entire array as a String array.
-     *
-     * @webref jsonarray:method
-     * @brief Gets the entire array as an array of Strings
-     * @see JSONArray#getIntArray()
-     */
-    public String[] getStringArray() {
-        String[] outgoing = new String[size()];
-        for (int i = 0; i < size(); i++) {
-            outgoing[i] = getString(i);
-        }
-        return outgoing;
-    }
 
-    /**
-     * Get this entire array as an int array. Everything must be an int.
-     *
-     * @webref jsonarray:method
-     * @brief Gets the entire array as array of ints
-     * @see JSONArray#getStringArray()
-     */
-    public int[] getIntArray() {
-        int[] outgoing = new int[size()];
-        for (int i = 0; i < size(); i++) {
-            outgoing[i] = getInt(i);
-        }
-        return outgoing;
+  public JSONObject getJSONObject(int index, JSONObject defaultValue) {
+    try {
+      return getJSONObject(index);
+    } catch (Exception e) {
+      return defaultValue;
     }
+  }
+
+
+  /**
+   * Get this entire array as a String array.
+   *
+   * @webref jsonarray:method
+   * @brief Gets the entire array as an array of Strings
+   * @see JSONArray#getIntArray()
+   */
+  public String[] getStringArray() {
+    String[] outgoing = new String[size()];
+    for (int i = 0; i < size(); i++) {
+      outgoing[i] = getString(i);
+    }
+    return outgoing;
+  }
+
+
+  /**
+   * Get this entire array as an int array. Everything must be an int.
+   *
+   * @webref jsonarray:method
+   * @brief Gets the entire array as array of ints
+   * @see JSONArray#getStringArray()
+   */
+  public int[] getIntArray() {
+    int[] outgoing = new int[size()];
+    for (int i = 0; i < size(); i++) {
+      outgoing[i] = getInt(i);
+    }
+    return outgoing;
+  }
 
-    /**
-     * Get this entire array as a long array. Everything must be an long.
-     */
-    public long[] getLongArray() {
-        long[] outgoing = new long[size()];
-        for (int i = 0; i < size(); i++) {
-            outgoing[i] = getLong(i);
-        }
-        return outgoing;
+
+  /** Get this entire array as a long array. Everything must be an long. */
+  public long[] getLongArray() {
+    long[] outgoing = new long[size()];
+    for (int i = 0; i < size(); i++) {
+      outgoing[i] = getLong(i);
     }
+    return outgoing;
+  }
 
-    /**
-     * Get this entire array as a float array. Everything must be an float.
-     */
-    public float[] getFloatArray() {
-        float[] outgoing = new float[size()];
-        for (int i = 0; i < size(); i++) {
-            outgoing[i] = getFloat(i);
-        }
-        return outgoing;
+
+  /** Get this entire array as a float array. Everything must be an float. */
+  public float[] getFloatArray() {
+    float[] outgoing = new float[size()];
+    for (int i = 0; i < size(); i++) {
+      outgoing[i] = getFloat(i);
     }
+    return outgoing;
+  }
 
-    /**
-     * Get this entire array as a double array. Everything must be an double.
-     */
-    public double[] getDoubleArray() {
-        double[] outgoing = new double[size()];
-        for (int i = 0; i < size(); i++) {
-            outgoing[i] = getDouble(i);
-        }
-        return outgoing;
+
+  /** Get this entire array as a double array. Everything must be an double. */
+  public double[] getDoubleArray() {
+    double[] outgoing = new double[size()];
+    for (int i = 0; i < size(); i++) {
+      outgoing[i] = getDouble(i);
     }
+    return outgoing;
+  }
 
-    /**
-     * Get this entire array as a boolean array. Everything must be a boolean.
-     */
-    public boolean[] getBooleanArray() {
-        boolean[] outgoing = new boolean[size()];
-        for (int i = 0; i < size(); i++) {
-            outgoing[i] = getBoolean(i);
-        }
-        return outgoing;
+
+  /** Get this entire array as a boolean array. Everything must be a boolean. */
+  public boolean[] getBooleanArray() {
+    boolean[] outgoing = new boolean[size()];
+    for (int i = 0; i < size(); i++) {
+      outgoing[i] = getBoolean(i);
     }
+    return outgoing;
+  }
+
 
 //  /**
 //   * Get the optional boolean value associated with an index.
@@ -670,81 +692,89 @@ public class JSONArray {
 //  public String optString(int index) {
 //    return this.optString(index, "");
 //  }
-    /**
-     * Append an String value. This increases the array's length by one.
-     *
-     * @webref jsonarray:method
-     * @brief Appends a value, increasing the array's length by one
-     * @param value a String value
-     * @return this.
-     * @see JSONArray#size()
-     * @see JSONArray#remove(int)
-     */
-    public JSONArray append(String value) {
-        this.append((Object) value);
-        return this;
-    }
 
-    /**
-     * Append an int value. This increases the array's length by one.
-     *
-     * @param value an int value
-     * @return this.
-     */
-    public JSONArray append(int value) {
-        this.append(Integer.valueOf(value));
-        return this;
-    }
 
-    /**
-     * Append an long value. This increases the array's length by one.
-     *
-     * @nowebref
-     * @param value A long value.
-     * @return this.
-     */
-    public JSONArray append(long value) {
-        this.append(Long.valueOf(value));
-        return this;
-    }
+  /**
+   * Append an String value. This increases the array's length by one.
+   *
+   * @webref jsonarray:method
+   * @brief Appends a value, increasing the array's length by one
+   * @param value a String value
+   * @return this.
+   * @see JSONArray#size()
+   * @see JSONArray#remove(int)
+   */
+  public JSONArray append(String value) {
+    this.append((Object)value);
+    return this;
+  }
+
+
+  /**
+   * Append an int value. This increases the array's length by one.
+   *
+   * @param value an int value
+   * @return this.
+   */
+  public JSONArray append(int value) {
+    this.append(Integer.valueOf(value));
+    return this;
+  }
+
+
+  /**
+   * Append an long value. This increases the array's length by one.
+   *
+   * @nowebref
+   * @param value A long value.
+   * @return this.
+   */
+  public JSONArray append(long value) {
+    this.append(Long.valueOf(value));
+    return this;
+  }
+
+
+  /**
+   * Append a float value. This increases the array's length by one.
+   * This will store the value as a double, since there are no floats in JSON.
+   *
+   * @param value a float value
+   * @throws RuntimeException if the value is not finite.
+   * @return this.
+   */
+  public JSONArray append(float value) {
+    return append((double) value);
+  }
+
+
+  /**
+   * Append a double value. This increases the array's length by one.
+   *
+   * @nowebref
+   * @param value A double value.
+   * @throws RuntimeException if the value is not finite.
+   * @return this.
+   */
+  public JSONArray append(double value) {
+    Double d = value;
+    JSONObject.testValidity(d);
+    this.append(d);
+    return this;
+  }
+
+
+  /**
+   * Append a boolean value. This increases the array's length by one.
+   *
+   * @param value a boolean value
+   * @return this.
+   */
+  public JSONArray append(boolean value) {
+    this.append(value ? Boolean.TRUE : Boolean.FALSE);
+    return this;
+  }
 
-    /**
-     * Append a float value. This increases the array's length by one. This will
-     * store the value as a double, since there are no floats in JSON.
-     *
-     * @param value a float value
-     * @throws RuntimeException if the value is not finite.
-     * @return this.
-     */
-    public JSONArray append(float value) {
-        return append((double) value);
-    }
-
-    /**
-     * Append a double value. This increases the array's length by one.
-     *
-     * @nowebref
-     * @param value A double value.
-     * @throws RuntimeException if the value is not finite.
-     * @return this.
-     */
-    public JSONArray append(double value) {
-        Double d = value;
-        JSONObject.testValidity(d);
-        this.append(d);
-        return this;
-    }
-
-    /**
-     * Append a boolean value. This increases the array's length by one.
-     *
-     * @param value a boolean value
-     * @return this.
-     */
-    public JSONArray append(boolean value) {
-        this.append(value ? Boolean.TRUE : Boolean.FALSE);
-        return this;
-    }
 
 //  /**
 //   * Put a value in the JSONArray, where the value will be a
@@ -756,6 +786,8 @@ public class JSONArray {
 //    this.append(new JSONArray(value));
 //    return this;
 //  }
+
+
 //  /**
 //   * Put a value in the JSONArray, where the value will be a
 //   * JSONObject which is produced from a Map.
@@ -766,34 +798,38 @@ public class JSONArray {
 //    this.append(new JSONObject(value));
 //    return this;
 //  }
-    /**
-     * @param value a JSONArray value
-     */
-    public JSONArray append(JSONArray value) {
-        myArrayList.add(value);
-        return this;
-    }
 
-    /**
-     * @param value a JSONObject value
-     */
-    public JSONArray append(JSONObject value) {
-        myArrayList.add(value);
-        return this;
-    }
 
-    /**
-     * Append an object value. This increases the array's length by one.
-     *
-     * @param value An object value. The value should be a Boolean, Double,
-     * Integer, JSONArray, JSONObject, Long, or String, or the JSONObject.NULL
-     * object.
-     * @return this.
-     */
-    protected JSONArray append(Object value) {
-        myArrayList.add(value);
-        return this;
-    }
+  /**
+   * @param value a JSONArray value
+   */
+  public JSONArray append(JSONArray value) {
+    myArrayList.add(value);
+    return this;
+  }
+
+
+  /**
+   * @param value a JSONObject value
+   */
+  public JSONArray append(JSONObject value) {
+    myArrayList.add(value);
+    return this;
+  }
+
+
+  /**
+   * Append an object value. This increases the array's length by one.
+   * @param value An object value.  The value should be a
+   *  Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the
+   *  JSONObject.NULL object.
+   * @return this.
+   */
+  protected JSONArray append(Object value) {
+    myArrayList.add(value);
+    return this;
+  }
+
 
 //  /**
 //   * Put a value in the JSONArray, where the value will be a
@@ -808,114 +844,120 @@ public class JSONArray {
 //    this.set(index, new JSONArray(value));
 //    return this;
 //  }
-    /**
-     * Put or replace a String value. If the index is greater than the length of
-     * the JSONArray, then null elements will be added as necessary to pad it
-     * out.
-     *
-     * @webref jsonarray:method
-     * @brief Put a String value in the JSONArray
-     * @param index an index value
-     * @param value the value to assign
-     * @return this.
-     * @throws RuntimeException If the index is negative.
-     * @see JSONArray#setInt(int, int)
-     * @see JSONArray#setFloat(int, float)
-     * @see JSONArray#setBoolean(int, boolean)
-     */
-    public JSONArray setString(int index, String value) {
-        this.set(index, value);
-        return this;
-    }
 
-    /**
-     * 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.
-     *
-     * @webref jsonarray:method
-     * @brief Put an int value in the JSONArray
-     * @param index an index value
-     * @param value the value to assign
-     * @return this.
-     * @throws RuntimeException If the index is negative.
-     * @see JSONArray#setFloat(int, float)
-     * @see JSONArray#setString(int, String)
-     * @see JSONArray#setBoolean(int, boolean)
-     */
-    public JSONArray setInt(int index, int value) {
-        this.set(index, Integer.valueOf(value));
-        return this;
-    }
-
-    /**
-     * 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.
-     *
-     * @param index The subscript.
-     * @param value A long value.
-     * @return this.
-     * @throws RuntimeException If the index is negative.
-     */
-    public JSONArray setLong(int index, long value) {
-        return set(index, Long.valueOf(value));
-    }
 
-    /**
-     * Put or replace a float value. If the index is greater than the length of
-     * the JSONArray, then null elements will be added as necessary to pad it
-     * out. There are no 'double' values in JSON, so this is passed to
-     * setDouble(value).
-     *
-     * @webref jsonarray:method
-     * @brief Put a float value in the JSONArray
-     * @param index an index value
-     * @param value the value to assign
-     * @return this.
-     * @throws RuntimeException If the index is negative or if the value is not
-     * finite.
-     * @see JSONArray#setInt(int, int)
-     * @see JSONArray#setString(int, String)
-     * @see JSONArray#setBoolean(int, boolean)
-     */
-    public JSONArray setFloat(int index, float value) {
-        return setDouble(index, value);
-    }
+  /**
+   * Put or replace a String value. If the index is greater than the length of
+   *  the JSONArray, then null elements will be added as necessary to pad
+   *  it out.
+   *
+   * @webref jsonarray:method
+   * @brief Put a String value in the JSONArray
+   * @param index an index value
+   * @param value the value to assign
+   * @return this.
+   * @throws RuntimeException If the index is negative.
+   * @see JSONArray#setInt(int, int)
+   * @see JSONArray#setFloat(int, float)
+   * @see JSONArray#setBoolean(int, boolean)
+   */
+  public JSONArray setString(int index, String value) {
+    this.set(index, value);
+    return this;
+  }
+
+
+  /**
+   * 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.
+   *
+   * @webref jsonarray:method
+   * @brief Put an int value in the JSONArray
+   * @param index an index value
+   * @param value the value to assign
+   * @return this.
+   * @throws RuntimeException If the index is negative.
+   * @see JSONArray#setFloat(int, float)
+   * @see JSONArray#setString(int, String)
+   * @see JSONArray#setBoolean(int, boolean)
+   */
+  public JSONArray setInt(int index, int value) {
+    this.set(index, Integer.valueOf(value));
+    return this;
+  }
+
+
+  /**
+   * 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.
+   * @param index The subscript.
+   * @param value A long value.
+   * @return this.
+   * @throws RuntimeException If the index is negative.
+   */
+  public JSONArray setLong(int index, long value) {
+    return set(index, Long.valueOf(value));
+  }
+
+
+  /**
+   * Put or replace a float value. If the index is greater than the length
+   * of the JSONArray, then null elements will be added as necessary to pad
+   * it out. There are no 'double' values in JSON, so this is passed to
+   * setDouble(value).
+   *
+   * @webref jsonarray:method
+   * @brief Put a float value in the JSONArray
+   * @param index an index value
+   * @param value the value to assign
+   * @return this.
+   * @throws RuntimeException If the index is negative or if the value is
+   * not finite.
+   * @see JSONArray#setInt(int, int)
+   * @see JSONArray#setString(int, String)
+   * @see JSONArray#setBoolean(int, boolean)
+   */
+  public JSONArray setFloat(int index, float value) {
+    return setDouble(index, value);
+  }
+
+
+  /**
+   * 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.
+   * @param index The subscript.
+   * @param value A double value.
+   * @return this.
+   * @throws RuntimeException If the index is negative or if the value is
+   * not finite.
+   */
+  public JSONArray setDouble(int index, double value) {
+    return set(index, Double.valueOf(value));
+  }
+
+
+  /**
+   * 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.
+   *
+   * @webref jsonarray:method
+   * @brief Put a boolean value in the JSONArray
+   * @param index an index value
+   * @param value the value to assign
+   * @return this.
+   * @throws RuntimeException If the index is negative.
+   * @see JSONArray#setInt(int, int)
+   * @see JSONArray#setFloat(int, float)
+   * @see JSONArray#setString(int, String)
+   */
+  public JSONArray setBoolean(int index, boolean value) {
+    return set(index, value ? Boolean.TRUE : Boolean.FALSE);
+  }
 
-    /**
-     * 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.
-     *
-     * @param index The subscript.
-     * @param value A double value.
-     * @return this.
-     * @throws RuntimeException If the index is negative or if the value is not
-     * finite.
-     */
-    public JSONArray setDouble(int index, double value) {
-        return set(index, Double.valueOf(value));
-    }
-
-    /**
-     * 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.
-     *
-     * @webref jsonarray:method
-     * @brief Put a boolean value in the JSONArray
-     * @param index an index value
-     * @param value the value to assign
-     * @return this.
-     * @throws RuntimeException If the index is negative.
-     * @see JSONArray#setInt(int, int)
-     * @see JSONArray#setFloat(int, float)
-     * @see JSONArray#setString(int, String)
-     */
-    public JSONArray setBoolean(int index, boolean value) {
-        return set(index, value ? Boolean.TRUE : Boolean.FALSE);
-    }
 
 //  /**
 //   * Put a value in the JSONArray, where the value will be a
@@ -930,103 +972,106 @@ public class JSONArray {
 //    this.set(index, new JSONObject(value));
 //    return this;
 //  }
-    /**
-     * @webref jsonarray:method
-     * @brief Sets the JSONArray value associated with an index value
-     * @param index the index value to target
-     * @param value the value to assign
-     * @see JSONArray#setJSONObject(int, JSONObject)
-     * @see JSONArray#getJSONObject(int)
-     * @see JSONArray#getJSONArray(int)
-     */
-    public JSONArray setJSONArray(int index, JSONArray value) {
-        set(index, value);
-        return this;
-    }
-
-    /**
-     * @webref jsonarray:method
-     * @brief Sets the JSONObject value associated with an index value
-     * @param index the index value to target
-     * @param value the value to assign
-     * @see JSONArray#setJSONArray(int, JSONArray)
-     * @see JSONArray#getJSONObject(int)
-     * @see JSONArray#getJSONArray(int)
-     */
-    public JSONArray setJSONObject(int index, JSONObject value) {
-        set(index, value);
-        return this;
-    }
 
-    /**
-     * 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.
-     *
-     * @param index The subscript.
-     * @param 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.
-     * @return this.
-     * @throws RuntimeException If the index is negative or if the the value is
-     * an invalid number.
-     */
-    private JSONArray set(int index, Object value) {
-        JSONObject.testValidity(value);
-        if (index < 0) {
-            throw new RuntimeException("JSONArray[" + index + "] not found.");
-        }
-        if (index < this.size()) {
-            this.myArrayList.set(index, value);
-        } else {
-            while (index != this.size()) {
-                this.append(JSONObject.NULL);
-            }
-            this.append(value);
-        }
-        return this;
+  /**
+   * @webref jsonarray:method
+   * @brief Sets the JSONArray value associated with an index value
+   * @param index the index value to target
+   * @param value the value to assign
+   * @see JSONArray#setJSONObject(int, JSONObject)
+   * @see JSONArray#getJSONObject(int)
+   * @see JSONArray#getJSONArray(int)
+   */
+  public JSONArray setJSONArray(int index, JSONArray value) {
+    set(index, value);
+    return this;
+  }
+
+  /**
+   * @webref jsonarray:method
+   * @brief Sets the JSONObject value associated with an index value
+   * @param index the index value to target
+   * @param value the value to assign
+   * @see JSONArray#setJSONArray(int, JSONArray)
+   * @see JSONArray#getJSONObject(int)
+   * @see JSONArray#getJSONArray(int)
+   */
+  public JSONArray setJSONObject(int index, JSONObject value) {
+    set(index, value);
+    return this;
+  }
+
+
+  /**
+   * 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.
+   * @param index The subscript.
+   * @param 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.
+   * @return this.
+   * @throws RuntimeException If the index is negative or if the the value is
+   *  an invalid number.
+   */
+  private JSONArray set(int index, Object value) {
+    JSONObject.testValidity(value);
+    if (index < 0) {
+      throw new RuntimeException("JSONArray[" + index + "] not found.");
     }
-
-    /**
-     * Get the number of elements in the JSONArray, included nulls.
-     *
-     * @webref jsonarray:method
-     * @brief Gets the number of elements in the JSONArray
-     * @return The length (or size).
-     * @see JSONArray#append(String)
-     * @see JSONArray#remove(int)
-     */
-    public int size() {
-        return myArrayList.size();
+    if (index < this.size()) {
+      this.myArrayList.set(index, value);
+    } else {
+      while (index != this.size()) {
+        this.append(JSONObject.NULL);
+      }
+      this.append(value);
     }
+    return this;
+  }
+
+
+  /**
+   * Get the number of elements in the JSONArray, included nulls.
+   *
+   * @webref jsonarray:method
+   * @brief Gets the number of elements in the JSONArray
+   * @return The length (or size).
+   * @see JSONArray#append(String)
+   * @see JSONArray#remove(int)
+   */
+  public int size() {
+    return myArrayList.size();
+  }
+
+
+  /**
+   * Determine if the value is null.
+   * @webref
+   * @param index must be between 0 and length() - 1
+   * @return true if the value at the index is null, or if there is no value.
+   */
+  public boolean isNull(int index) {
+    return JSONObject.NULL.equals(this.opt(index));
+  }
+
+
+  /**
+   * Remove an index and close the hole.
+   *
+   * @webref jsonarray:method
+   * @brief Removes an element
+   * @param index the index value of the element to be removed
+   * @return The value that was associated with the index, or null if there was no value.
+   * @see JSONArray#size()
+   * @see JSONArray#append(String)
+   */
+  public Object remove(int index) {
+    Object o = this.opt(index);
+    this.myArrayList.remove(index);
+    return o;
+  }
 
-    /**
-     * Determine if the value is null.
-     *
-     * @webref
-     * @param index must be between 0 and length() - 1
-     * @return true if the value at the index is null, or if there is no value.
-     */
-    public boolean isNull(int index) {
-        return JSONObject.NULL.equals(this.opt(index));
-    }
-
-    /**
-     * Remove an index and close the hole.
-     *
-     * @webref jsonarray:method
-     * @brief Removes an element
-     * @param index the index value of the element to be removed
-     * @return The value that was associated with the index, or null if there
-     * was no value.
-     * @see JSONArray#size()
-     * @see JSONArray#append(String)
-     */
-    public Object remove(int index) {
-        Object o = this.opt(index);
-        this.myArrayList.remove(index);
-        return o;
-    }
 
 //  /**
 //   * Produce a JSONObject by combining a JSONArray of names with the values
@@ -1047,72 +1092,81 @@ public class JSONArray {
 //    }
 //    return jo;
 //  }
+
+
 //  protected boolean save(OutputStream output) {
 //    return write(PApplet.createWriter(output), null);
 //  }
-    public boolean save(File file, String options) {
-        PrintWriter writer = PApplet.createWriter(file);
-        boolean success = write(writer, options);
-        writer.close();
-        return success;
-    }
 
-    public boolean write(PrintWriter output) {
-        return write(output, null);
-    }
 
-    public boolean write(PrintWriter output, String options) {
-        int indentFactor = 2;
-        if (options != null) {
-            String[] opts = PApplet.split(options, ',');
-            for (String opt : opts) {
-                if (opt.equals("compact")) {
-                    indentFactor = -1;
-                } else if (opt.startsWith("indent=")) {
-                    indentFactor = PApplet.parseInt(opt.substring(7), -2);
-                    if (indentFactor == -2) {
-                        throw new IllegalArgumentException("Could not read a number from " + opt);
-                    }
-                } else {
-                    System.err.println("Ignoring " + opt);
-                }
-            }
-        }
-        output.print(format(indentFactor));
-        output.flush();
-        return true;
-    }
+  public boolean save(File file, String options) {
+    PrintWriter writer = PApplet.createWriter(file);
+    boolean success = write(writer, options);
+    writer.close();
+    return success;
+  }
 
-    /**
-     * Return the JSON data formatted with two spaces for indents. Chosen to do
-     * this since it's the most common case (e.g. with println()). Same as
-     * format(2). Use the format() function for more options.
-     */
-    @Override
-    public String toString() {
-        try {
-            return format(2);
-        } catch (Exception e) {
-            return null;
-        }
-    }
 
-    /**
-     * Make a pretty-printed JSON text of this JSONArray. Warning: This method
-     * assumes that the data structure is acyclical.
-     *
-     * @param indentFactor The number of spaces to add to each level of
-     * indentation. Use -1 to specify no indentation and no newlines.
-     * @return a printable, displayable, transmittable representation of the
-     * object, beginning with <code>[</code>&nbsp;<small>(left bracket)</small>
-     * and ending with <code>]</code>&nbsp;<small>(right bracket)</small>.
-     */
-    public String format(int indentFactor) {
-        StringWriter sw = new StringWriter();
-        synchronized (sw.getBuffer()) {
-            return this.writeInternal(sw, indentFactor, 0).toString();
+  public boolean write(PrintWriter output) {
+    return write(output, null);
+  }
+
+
+  public boolean write(PrintWriter output, String options) {
+    int indentFactor = 2;
+    if (options != null) {
+      String[] opts = PApplet.split(options, ',');
+      for (String opt : opts) {
+        if (opt.equals("compact")) {
+          indentFactor = -1;
+        } else if (opt.startsWith("indent=")) {
+          indentFactor = PApplet.parseInt(opt.substring(7), -2);
+          if (indentFactor == -2) {
+            throw new IllegalArgumentException("Could not read a number from " + opt);
+          }
+        } else {
+          System.err.println("Ignoring " + opt);
         }
+      }
+    }
+    output.print(format(indentFactor));
+    output.flush();
+    return true;
+  }
+
+
+  /**
+   * Return the JSON data formatted with two spaces for indents.
+   * Chosen to do this since it's the most common case (e.g. with println()).
+   * Same as format(2). Use the format() function for more options.
+   */
+  @Override
+  public String toString() {
+    try {
+      return format(2);
+    } catch (Exception e) {
+      return null;
     }
+  }
+
+
+  /**
+   * Make a pretty-printed JSON text of this JSONArray.
+   * Warning: This method assumes that the data structure is acyclical.
+   * @param indentFactor The number of spaces to add to each level of
+   *  indentation. Use -1 to specify no indentation and no newlines.
+   * @return a printable, displayable, transmittable
+   *  representation of the object, beginning
+   *  with <code>[</code>&nbsp;<small>(left bracket)</small> and ending
+   *  with <code>]</code>&nbsp;<small>(right bracket)</small>.
+   */
+  public String format(int indentFactor) {
+    StringWriter sw = new StringWriter();
+    synchronized (sw.getBuffer()) {
+      return this.writeInternal(sw, indentFactor, 0).toString();
+    }
+  }
+
 
 //  /**
 //   * Write the contents of the JSONArray as JSON text to a writer. For
@@ -1125,78 +1179,82 @@ public class JSONArray {
 //  protected Writer write(Writer writer) {
 //    return this.write(writer, -1, 0);
 //  }
-    /**
-     * Write the contents of the JSONArray as JSON text to a writer.
-     * <p>
-     * Warning: This method assumes that the data structure is acyclic.
-     *
-     * @param indentFactor The number of spaces to add to each level of
-     * indentation. Use -1 to specify no indentation and no newlines.
-     * @param indent The indention of the top level.
-     * @return The writer.
-     * @throws RuntimeException
-     */
-    protected Writer writeInternal(Writer writer, int indentFactor, int indent) {
-        try {
-            boolean commanate = false;
-            int length = this.size();
-            writer.write('[');
-
-            // Use -1 to signify 'no indent'
-            int thisFactor = (indentFactor == -1) ? 0 : indentFactor;
-
-            if (length == 1) {
-                JSONObject.writeValue(writer, this.myArrayList.get(0),
-                        indentFactor, indent);
+
+
+  /**
+   * Write the contents of the JSONArray as JSON text to a writer.
+   * <p>
+   * Warning: This method assumes that the data structure is acyclic.
+   *
+   * @param indentFactor
+   *            The number of spaces to add to each level of indentation.
+   *            Use -1 to specify no indentation and no newlines.
+   * @param indent
+   *            The indention of the top level.
+   * @return The writer.
+   * @throws RuntimeException
+   */
+  protected Writer writeInternal(Writer writer, int indentFactor, int indent) {
+    try {
+      boolean commanate = false;
+      int length = this.size();
+      writer.write('[');
+
+      // Use -1 to signify 'no indent'
+      int thisFactor = (indentFactor == -1) ? 0 : indentFactor;
+
+      if (length == 1) {
+        JSONObject.writeValue(writer, this.myArrayList.get(0),
+                              indentFactor, indent);
 //                              thisFactor, indent);
-            } else if (length != 0) {
-                final int newIndent = indent + thisFactor;
-
-                for (int i = 0; i < length; i += 1) {
-                    if (commanate) {
-                        writer.write(',');
-                    }
-                    if (indentFactor != -1) {
-                        writer.write('\n');
-                    }
-                    JSONObject.indent(writer, newIndent);
+      } else if (length != 0) {
+        final int newIndent = indent + thisFactor;
+
+        for (int i = 0; i < length; i += 1) {
+          if (commanate) {
+            writer.write(',');
+          }
+          if (indentFactor != -1) {
+            writer.write('\n');
+          }
+          JSONObject.indent(writer, newIndent);
 //          JSONObject.writeValue(writer, this.myArrayList.get(i),
 //                                thisFactor, newIndent);
-                    JSONObject.writeValue(writer, this.myArrayList.get(i),
-                            indentFactor, newIndent);
-                    commanate = true;
-                }
-                if (indentFactor != -1) {
-                    writer.write('\n');
-                }
-                JSONObject.indent(writer, indent);
-            }
-            writer.write(']');
-            return writer;
-        } catch (IOException e) {
-            throw new RuntimeException(e);
+          JSONObject.writeValue(writer, this.myArrayList.get(i),
+                                indentFactor, newIndent);
+          commanate = true;
         }
-    }
-
-    /**
-     * Make a string from the contents of this JSONArray. The
-     * <code>separator</code> string is inserted between each element. Warning:
-     * This method assumes that the data structure is acyclic.
-     *
-     * @param separator A string that will be inserted between the elements.
-     * @return a string.
-     * @throws RuntimeException If the array contains an invalid number.
-     */
-    public String join(String separator) {
-        int len = this.size();
-        StringBuilder sb = new StringBuilder();
-
-        for (int i = 0; i < len; i += 1) {
-            if (i > 0) {
-                sb.append(separator);
-            }
-            sb.append(JSONObject.valueToString(this.myArrayList.get(i)));
+        if (indentFactor != -1) {
+          writer.write('\n');
         }
-        return sb.toString();
+        JSONObject.indent(writer, indent);
+      }
+      writer.write(']');
+      return writer;
+    } catch (IOException e) {
+      throw new RuntimeException(e);
+    }
+  }
+
+
+  /**
+   * Make a string from the contents of this JSONArray. The
+   * <code>separator</code> string is inserted between each element.
+   * Warning: This method assumes that the data structure is acyclic.
+   * @param separator A string that will be inserted between the elements.
+   * @return a string.
+   * @throws RuntimeException If the array contains an invalid number.
+   */
+  public String join(String separator) {
+    int len = this.size();
+    StringBuilder sb = new StringBuilder();
+
+    for (int i = 0; i < len; i += 1) {
+      if (i > 0) {
+        sb.append(separator);
+      }
+      sb.append(JSONObject.valueToString(this.myArrayList.get(i)));
     }
+    return sb.toString();
+  }
 }