propane 3.8.0-java → 4.0.0-java

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

@@ -33,7 +33,6 @@ 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;
@@ -42,6 +41,7 @@ import java.io.StringWriter;
 import java.io.Writer;
 import java.lang.reflect.Array;
 import java.util.ArrayList;
+import java.util.Arrays;
 
 import processing.core.PApplet;
 
@@ -99,116 +99,111 @@ 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));
-  }
-
-
-  /**
-   * 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 '['");
+    /**
+     * The arrayList where the JSONArray's properties are kept.
+     */
+    private final ArrayList<Object> myArrayList;
+
+    /**
+     * Construct an empty JSONArray.
+     */
+    public JSONArray() {
+        this.myArrayList = new ArrayList<>();
     }
-    if (x.nextClean() != ']') {
-      x.back();
-      for (;;) {
-        if (x.nextClean() == ',') {
-          x.back();
-          myArrayList.add(JSONObject.NULL);
-        } else {
-          x.back();
-          myArrayList.add(x.nextValue());
+
+    /**
+     * @param reader
+     * @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 '['");
         }
-        switch (x.nextClean()) {
-        case ';':
-        case ',':
-          if (x.nextClean() == ']') {
-            return;
-          }
-          x.back();
-          break;
-        case ']':
-          return;
-        default:
-          throw new RuntimeException("Expected a ',' or ']'");
+        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 ';', ',' -> {
+                        if (x.nextClean() == ']') {
+                            return;
+                        }
+                        x.back();
+                    }
+                    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));
+    /**
+     * @param list
+     * @nowebref
+     */
+    public JSONArray(IntList list) {
+        myArrayList = new ArrayList<>();
+        for (int item : list.values()) {
+            myArrayList.add(item);
+        }
     }
-  }
 
-
-  /**
-   * @nowebref
-   */
-  public JSONArray(FloatList list) {
-    myArrayList = new ArrayList<>();
-    for (float item : list.values()) {
-      myArrayList.add(Float.valueOf(item));
+    /**
+     * @param list
+     * @nowebref
+     */
+    public JSONArray(FloatList list) {
+        myArrayList = new ArrayList<>();
+        for (float item : list.values()) {
+            myArrayList.add(item);
+        }
     }
-  }
 
-
-  /**
-   * @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;
+    /**
+     * @param list
+     * @nowebref
+     */
+    public JSONArray(StringList list) {
+        myArrayList = new ArrayList<>();
+        myArrayList.addAll(Arrays.asList(list.values()));
     }
-  }
 
+    /**
+     * 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.
@@ -223,411 +218,409 @@ 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;
-  }
-
-
-  /**
-   * 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 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 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;
+    // TODO not decided whether we keep this one, but used heavily by JSONObject
+    /**
+     * Construct a JSONArray from an array
+     *
+     * @param 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 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 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 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 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;
     }
-  }
-
-
-  /**
-   * 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 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 string) {
+            return string;
+        }
+        throw new RuntimeException("JSONArray[" + index + "] not a string.");
     }
-  }
-
-
-  /**
-   * 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 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 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 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 (NumberFormatException e) {
+            throw new RuntimeException("JSONArray[" + index + "] is not a number.");
+        }
     }
-  }
-
-
-  /**
-   * 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 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 + "] 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 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 (NumberFormatException e) {
+            throw new RuntimeException("JSONArray[" + index + "] is not a number.");
+        }
     }
-  }
-
-
-  /**
-   * 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;
+
+    /**
+     * 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;
+        }
     }
-    throw new RuntimeException("JSONArray[" + index + "] is not a JSONArray.");
-  }
 
+    /**
+     * Get a value from an index as a float.JSON uses 'double' values
+     * internally, so this is simply getDouble() cast to a float.
+     *
+     * @return
+     * @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 JSONArray getJSONArray(int index, JSONArray defaultValue) {
-    try {
-      return getJSONArray(index);
-    } catch (Exception e) {
-      return defaultValue;
+    public float getFloat(int index, float defaultValue) {
+        try {
+            return getFloat(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;
+
+    /**
+     * 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 (NumberFormatException e) {
+            throw new RuntimeException("JSONArray[" + index + "] is not a number.");
+        }
     }
-    throw new RuntimeException("JSONArray[" + index + "] is not a JSONObject.");
-  }
 
+    /**
+     * 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;
+        }
+    }
 
-  public JSONObject getJSONObject(int index, JSONObject defaultValue) {
-    try {
-      return getJSONObject(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 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);
+
+    /**
+     * 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;
+        }
     }
-    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);
+
+    /**
+     * 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 jSONArray) {
+            return jSONArray;
+        }
+        throw new RuntimeException("JSONArray[" + index + "] is not a JSONArray.");
     }
-    return outgoing;
-  }
 
+    public JSONArray getJSONArray(int index, JSONArray defaultValue) {
+        try {
+            return getJSONArray(index);
+        } catch (Exception e) {
+            return defaultValue;
+        }
+    }
 
-  /** 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);
+    /**
+     * 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 jSONObject) {
+            return jSONObject;
+        }
+        throw new RuntimeException("JSONArray[" + index + "] is not a JSONObject.");
     }
-    return outgoing;
-  }
 
+    public JSONObject getJSONObject(int index, JSONObject defaultValue) {
+        try {
+            return getJSONObject(index);
+        } catch (Exception e) {
+            return defaultValue;
+        }
+    }
 
-  /** 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);
+    /**
+     * Get this entire array as a String array.
+     *
+     * @return
+     * @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;
     }
-    return outgoing;
-  }
 
+    /**
+     * Get this entire array as an int array.Everything must be an int.
+     *
+     * @return
+     * @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 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);
+    /**
+     * * Get this entire array as a long array.Everything must be an long.
+     *
+     * @return
+     */
+    public long[] getLongArray() {
+        long[] outgoing = new long[size()];
+        for (int i = 0; i < size(); i++) {
+            outgoing[i] = getLong(i);
+        }
+        return outgoing;
     }
-    return outgoing;
-  }
 
+    /**
+     * * Get this entire array as a float array.Everything must be an float.
+     *
+     * @return
+     */
+    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 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);
+    /**
+     * * Get this entire array as a double array.Everything must be an double.
+     *
+     * @return
+     */
+    public double[] getDoubleArray() {
+        double[] outgoing = new double[size()];
+        for (int i = 0; i < size(); i++) {
+            outgoing[i] = getDouble(i);
+        }
+        return outgoing;
     }
-    return outgoing;
-  }
 
+    /**
+     * * Get this entire array as a boolean array.Everything must be a boolean.
+     *
+     * @return
+     */
+    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.
@@ -692,89 +685,81 @@ 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 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 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;
+    }
 
 //  /**
 //   * Put a value in the JSONArray, where the value will be a
@@ -786,8 +771,6 @@ 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.
@@ -798,38 +781,36 @@ public class JSONArray {
 //    this.append(new JSONObject(value));
 //    return this;
 //  }
+    /**
+     * @param value a JSONArray value
+     * @return
+     */
+    public JSONArray append(JSONArray value) {
+        myArrayList.add(value);
+        return this;
+    }
 
+    /**
+     * @param value a JSONObject value
+     * @return
+     */
+    public JSONArray append(JSONObject 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;
-  }
-
+    /**
+     * 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
@@ -844,120 +825,114 @@ 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, 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 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 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, 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, 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
@@ -972,106 +947,103 @@ public class JSONArray {
 //    this.set(index, new JSONObject(value));
 //    return this;
 //  }
+    /**
+     * @return @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 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.");
+    /**
+     * @return @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;
     }
-    if (index < this.size()) {
-      this.myArrayList.set(index, value);
-    } else {
-      while (index != this.size()) {
-        this.append(JSONObject.NULL);
-      }
-      this.append(value);
+
+    /**
+     * 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;
     }
-    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;
-  }
 
+    /**
+     * 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;
+    }
 
 //  /**
 //   * Produce a JSONObject by combining a JSONArray of names with the values
@@ -1092,81 +1064,73 @@ public class JSONArray {
 //    }
 //    return jo;
 //  }
-
-
 //  protected boolean save(OutputStream output) {
 //    return write(PApplet.createWriter(output), null);
 //  }
+    public boolean save(File file, String options) {
+        boolean success;
+        try (PrintWriter writer = PApplet.createWriter(file)) {
+            success = write(writer, options);
+        }
+        return success;
+    }
 
+    public boolean write(PrintWriter output) {
+        return write(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);
+    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;
     }
-    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();
+
+    /**
+     * 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
@@ -1179,82 +1143,79 @@ 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 writer
+     * @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;
+                    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);
         }
-        if (indentFactor != -1) {
-          writer.write('\n');
-        }
-        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)));
+
+    /**
+     * 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();
     }
-    return sb.toString();
-  }
 }