How to use

us.monoid.json.JSONArray

constructor

/**
 * Put a value in the JSONArray, where the value will be a JSONArray which is
 * produced from a Collection.
 * 
 * @param value
 *          A Collection value.
 * @return this.
 */
public JSONArray put(Collection<?> value) {
  put(new JSONArray(value));
  return this;
}

/**
 * Put a value in the JSONArray, where the value will be a JSONArray which is
 * produced from a Collection.
 * 
 * @param value
 *          A Collection value.
 * @return this.
 */
public JSONArray put(Collection<?> value) {
  put(new JSONArray(value));
  return this;
}

/**
 * Put a key/value pair in the JSONObject, where the value will be a JSONArray
 * which is produced from a Collection.
 * 
 * @param key
 *          A key string.
 * @param value
 *          A Collection value.
 * @return this.
 * @throws JSONException
 */
public JSONObject put(String key, Collection<?> value) throws JSONException {
  put(key, new JSONArray(value));
  return this;
}

/**
 * Put a key/value pair in the JSONObject, where the value will be a JSONArray
 * which is produced from a Collection.
 * 
 * @param key
 *          A key string.
 * @param value
 *          A Collection value.
 * @return this.
 * @throws JSONException
 */
public JSONObject put(String key, Collection<?> value) throws JSONException {
  put(key, new JSONArray(value));
  return this;
}

/**
 * Put a value in the JSONArray, where the value will be a JSONArray which is
 * produced from a Collection.
 * 
 * @param index
 *          The subscript.
 * @param value
 *          A Collection value.
 * @return this.
 * @throws JSONException
 *           If the index is negative or if the value is not finite.
 */
public JSONArray put(int index, Collection<?> value) throws JSONException {
  put(index, new JSONArray(value));
  return this;
}

/**
 * Put a value in the JSONArray, where the value will be a JSONArray which is
 * produced from a Collection.
 * 
 * @param index
 *          The subscript.
 * @param value
 *          A Collection value.
 * @return this.
 * @throws JSONException
 *           If the index is negative or if the value is not finite.
 */
public JSONArray put(int index, Collection<?> value) throws JSONException {
  put(index, new JSONArray(value));
  return this;
}

return new JSONArray((Collection<?>) object);
return new JSONArray(object);

/**
 * Produce a JSONArray containing the names of the elements of this
 * JSONObject.
 * 
 * @return A JSONArray containing the key strings, or null if the JSONObject
 *         is empty.
 */
public JSONArray names() {
  JSONArray ja = new JSONArray();
  Iterator<String> keys = keys();
  while (keys.hasNext()) {
    ja.put(keys.next());
  }
  return ja.length() == 0 ? null : ja;
}

/**
 * Produce a JSONArray containing the names of the elements of this
 * JSONObject.
 * 
 * @return A JSONArray containing the key strings, or null if the JSONObject
 *         is empty.
 */
public JSONArray names() {
  JSONArray ja = new JSONArray();
  Iterator<String> keys = keys();
  while (keys.hasNext()) {
    ja.put(keys.next());
  }
  return ja.length() == 0 ? null : ja;
}

case '(':
  back();
  return new JSONArray(this);

/**
 * Accumulate values under a key. It is similar to the put method except that
 * if there is already an object stored under the key then a JSONArray is
 * stored under the key to hold all of the accumulated values. If there is
 * already a JSONArray, then the new value is appended to it. In contrast, the
 * put method replaces the previous value.
 * 
 * @param key
 *          A key string.
 * @param value
 *          An object to be accumulated under the key.
 * @return this.
 * @throws JSONException
 *           If the value is an invalid number or if the key is null.
 */
public JSONObject accumulate(String key, Object value) throws JSONException {
  testValidity(value);
  Object o = opt(key);
  if (o == null) {
    put(key, value instanceof JSONArray ? new JSONArray().put(value) : value);
  } else if (o instanceof JSONArray) {
    ((JSONArray) o).put(value);
  } else {
    put(key, new JSONArray().put(o).put(value));
  }
  return this;
}

/**
 * Produce a JSONArray of JSONObjects from a comma delimited text string
 * using a supplied JSONArray as the source of element names.
 * @param names A JSONArray of strings.
 * @param x A JSONTokener of the source text.
 * @return A JSONArray of JSONObjects.
 * @throws JSONException
 */
public static JSONArray toJSONArray(JSONArray names, JSONTokener x)
    throws JSONException {
  if (names == null || names.length() == 0) {
    return null;
  }
  JSONArray ja = new JSONArray();
  for (;;) {
    JSONObject jo = rowToJSONObject(names, x);
    if (jo == null) {
      break;
    }
    ja.put(jo);
  }
  if (ja.length() == 0) {
    return null;
  }
  return ja;
}

/**
 * Produce a JSONArray of JSONObjects from a comma delimited text string
 * using a supplied JSONArray as the source of element names.
 * @param names A JSONArray of strings.
 * @param x A JSONTokener of the source text.
 * @return A JSONArray of JSONObjects.
 * @throws JSONException
 */
public static JSONArray toJSONArray(JSONArray names, JSONTokener x)
    throws JSONException {
  if (names == null || names.length() == 0) {
    return null;
  }
  JSONArray ja = new JSONArray();
  for (;;) {
    JSONObject jo = rowToJSONObject(names, x);
    if (jo == null) {
      break;
    }
    ja.put(jo);
  }
  if (ja.length() == 0) {
    return null;
  }
  return ja;
}

/**
 * Accumulate values under a key. It is similar to the put method except that
 * if there is already an object stored under the key then a JSONArray is
 * stored under the key to hold all of the accumulated values. If there is
 * already a JSONArray, then the new value is appended to it. In contrast, the
 * put method replaces the previous value.
 * 
 * @param key
 *          A key string.
 * @param value
 *          An object to be accumulated under the key.
 * @return this.
 * @throws JSONException
 *           If the value is an invalid number or if the key is null.
 */
public JSONObject accumulate(String key, Object value) throws JSONException {
  testValidity(value);
  Object o = opt(key);
  if (o == null) {
    put(key, value instanceof JSONArray ? new JSONArray().put(value) : value);
  } else if (o instanceof JSONArray) {
    ((JSONArray) o).put(value);
  } else {
    put(key, new JSONArray().put(o).put(value));
  }
  return this;
}

/**
 * Produce a JSONArray containing the values of the members of this
 * JSONObject.
 * 
 * @param names
 *          A JSONArray containing a list of key strings. This determines the
 *          sequence of the values in the result.
 * @return A JSONArray of values.
 * @throws JSONException
 *           If any of the values are non-finite numbers.
 */
public JSONArray toJSONArray(JSONArray names) throws JSONException {
  if (names == null || names.length() == 0) {
    return null;
  }
  JSONArray ja = new JSONArray();
  for (int i = 0; i < names.length(); i += 1) {
    ja.put(this.opt(names.getString(i)));
  }
  return ja;
}

/**
 * Produce a JSONArray containing the values of the members of this
 * JSONObject.
 * 
 * @param names
 *          A JSONArray containing a list of key strings. This determines the
 *          sequence of the values in the result.
 * @return A JSONArray of values.
 * @throws JSONException
 *           If any of the values are non-finite numbers.
 */
public JSONArray toJSONArray(JSONArray names) throws JSONException {
  if (names == null || names.length() == 0) {
    return null;
  }
  JSONArray ja = new JSONArray();
  for (int i = 0; i < names.length(); i += 1) {
    ja.put(this.opt(names.getString(i)));
  }
  return ja;
}

JSONArray ja = new JSONArray();
for (;;) {
  String value = getValue(x);

JSONArray ja = new JSONArray();
for (;;) {
  String value = getValue(x);

/**
 * Append values to the array under a key. If the key does not exist in the
 * JSONObject, then the key is put in the JSONObject with its value being a
 * JSONArray containing the value parameter. If the key was already associated
 * with a JSONArray, then the value parameter is appended to it.
 * 
 * @param key
 *          A key string.
 * @param value
 *          An object to be accumulated under the key.
 * @return this.
 * @throws JSONException
 *           If the key is null or if the current value associated with the
 *           key is not a JSONArray.
 */
public JSONObject append(String key, Object value) throws JSONException {
  testValidity(value);
  Object o = opt(key);
  if (o == null) {
    put(key, new JSONArray().put(value));
  } else if (o instanceof JSONArray) {
    put(key, ((JSONArray) o).put(value));
  } else {
    throw new JSONException("JSONObject[" + key + "] is not a JSONArray.");
  }
  return this;
}

/**
 * Append values to the array under a key. If the key does not exist in the
 * JSONObject, then the key is put in the JSONObject with its value being a
 * JSONArray containing the value parameter. If the key was already associated
 * with a JSONArray, then the value parameter is appended to it.
 * 
 * @param key
 *          A key string.
 * @param value
 *          An object to be accumulated under the key.
 * @return this.
 * @throws JSONException
 *           If the key is null or if the current value associated with the
 *           key is not a JSONArray.
 */
public JSONObject append(String key, Object value) throws JSONException {
  testValidity(value);
  Object o = opt(key);
  if (o == null) {
    put(key, new JSONArray().put(value));
  } else if (o instanceof JSONArray) {
    put(key, ((JSONArray) o).put(value));
  } else {
    throw new JSONException("JSONObject[" + key + "] is not a JSONArray.");
  }
  return this;
}