iterator();
/**
* Adds the given value at the end of this {@link JSONArray}.
*
* @param value The value to add.
*/
void addEntry(@Nullable final Object value);
/**
* Inserts the given value at the given index, adding 1 to the index of
* every entry after the given index.
*
* If the given index is less than 0 or greater than the current size of
* this {@link JSONArray} minus 1, an {@link IndexOutOfBoundsException} will
* be thrown.
*
* @param index The index to insert into.
* @param value The value to insert.
*/
void insertEntry(final int index, @Nullable final Object value) throws IndexOutOfBoundsException;
/**
* Sets the given index to the given value, overwriting any other value that
* was previously set there.
*
* If the given index is less than 0 or greater than the current size of
* this {@link JSONArray} minus 1, an {@link IndexOutOfBoundsException} will
* be thrown.
*
* @param index The index to set at.
* @param value The value to set.
*/
void setEntry(final int index, @Nullable final Object value) throws IndexOutOfBoundsException;
/**
* Removes the entry at the given index, subtracting 1 from the index of
* every entry after the given index.
*
* If the given index is less than 0 or greater than the current size of
* this {@link JSONArray} minus 1, an {@link IndexOutOfBoundsException} will
* be thrown.
*
* @param index The index of the entry to remove.
*/
void unsetEntry(final int index) throws IndexOutOfBoundsException;
/**
* Checks if there is a null value at the given index.
*
* This will return {@code false} if the index is outside this
* {@link JSONArray}'s bounds, or if there is an entry at the index and the
* value is not {@code null}.
*
* This will return {@code true} if the data at the index is {@code null}
* (the index must be within this {@link JSONArray}'s bounds), regardless of
* what type of {@link Object} the entry is supposed to be.
*
* @param index The index to check.
* @return {@code true} if there is a {@code null} entry at the given index,
* {@code false} otherwise.
*/
boolean isNull(final int index);
/**
* Checks if there is a boolean value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not a boolean.
*
* @param index The index to check.
* @return {@code true} if there is a boolean at the given index,
* {@code false} otherwise.
*/
boolean isBoolean(final int index);
/**
* Gets the boolean value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a boolean, {@code false}
* will be returned.
*
* @param index The index of the boolean to retrieve.
* @return The boolean value at the index.
* @see JSONArray#getBoolean(int, boolean)
*/
boolean getBoolean(final int index);
/**
* Gets the boolean value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a boolean, the default
* value will be returned.
*
* @param index The index of the boolean to retrieve.
* @param def The default value.
* @return The boolean value at the index.
*/
boolean getBoolean(final int index, final boolean def);
/**
* Checks if there is a byte value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not a byte.
*
* @param index The index to check.
* @return {@code true} if there is a byte at the given index,
* {@code false} otherwise.
*/
boolean isByte(final int index);
/**
* Gets the byte value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a byte, {@code (byte) 0}
* will be returned.
*
* @param index The index of the byte to retrieve.
* @return The byte value at the index.
* @see JSONArray#getByte(int, byte)
*/
byte getByte(final int index);
/**
* Gets the byte value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a byte, the default
* value will be returned.
*
* @param index The index of the byte to retrieve.
* @param def The default value.
* @return The byte value at the index.
*/
byte getByte(final int index, final byte def);
/**
* Checks if there is a short value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not a short.
*
* @param index The index to check.
* @return {@code true} if there is a short at the given index,
* {@code false} otherwise.
*/
boolean isShort(final int index);
/**
* Gets the short value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a short,
* {@code (short) 0} will be returned.
*
* @param index The index of the short to retrieve.
* @return The short value at the index.
* @see JSONArray#getShort(int, short)
*/
short getShort(final int index);
/**
* Gets the short value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a short, the default
* value will be returned.
*
* @param index The index of the short to retrieve.
* @param def The default value.
* @return The short value at the index.
*/
short getShort(final int index, final short def);
/**
* Checks if there is an integer value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not an integer.
*
* @param index The index to check.
* @return {@code true} if there is an integer at the given index,
* {@code false} otherwise.
*/
boolean isInteger(final int index);
/**
* Gets the integer value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not an integer,
* {@code 0} will be returned.
*
* @param index The index of the integer to retrieve.
* @return The integer value at the index.
* @see JSONArray#getInteger(int, int)
*/
int getInteger(final int index);
/**
* Gets the integer value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not an integer, the default
* value will be returned.
*
* @param index The index of the integer to retrieve.
* @param def The default value.
* @return The integer value at the index.
*/
int getInteger(final int index, final int def);
/**
* Checks if there is a long value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not a long.
*
* @param index The index to check.
* @return {@code true} if there is a long at the given index,
* {@code false} otherwise.
*/
boolean isLong(final int index);
/**
* Gets the long value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a long, {@code 0L}
* will be returned.
*
* @param index The index of the long to retrieve.
* @return The long value at the index.
* @see JSONArray#getLong(int, long)
*/
long getLong(final int index);
/**
* Gets the long value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a long, the default
* value will be returned.
*
* @param index The index of the long to retrieve.
* @param def The default value.
* @return The long value at the index.
*/
long getLong(final int index, final long def);
/**
* Checks if there is a float value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not a float.
*
* @param index The index to check.
* @return {@code true} if there is a float at the given index,
* {@code false} otherwise.
*/
boolean isFloat(final int index);
/**
* Gets the float value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a float, {@code 0.0F}
* will be returned.
*
* @param index The index of the float to retrieve.
* @return The float value at the index.
* @see JSONArray#getFloat(int, float)
*/
float getFloat(final int index);
/**
* Gets the float value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a float, the default
* value will be returned.
*
* @param index The index of the float to retrieve.
* @param def The default value.
* @return The float value at the index.
*/
float getFloat(final int index, final float def);
/**
* Checks if there is a double value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not a double.
*
* @param index The index to check.
* @return {@code true} if there is a double at the given index,
* {@code false} otherwise.
*/
boolean isDouble(final int index);
/**
* Gets the double value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a double, {@code 0.0D}
* will be returned.
*
* @param index The index of the double to retrieve.
* @return The double value at the index.
* @see JSONArray#getDouble(int, double)
*/
double getDouble(final int index);
/**
* Gets the double value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a double, the default
* value will be returned.
*
* @param index The index of the double to retrieve.
* @param def The default value.
* @return The double value at the index.
*/
double getDouble(final int index, final double def);
/**
* Checks if there is a {@link String} value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not a {@link String}.
*
* @param index The index to check.
* @return {@code true} if there is a {@link String} at the given index,
* {@code false} otherwise.
*/
boolean isString(final int index);
/**
* Gets the {@link String} value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a {@link String},
* {@code null} will be returned.
*
* @param index The index of the {@link String} to retrieve.
* @return The {@link String} value at the index.
* @see JSONArray#getString(int, String)
*/
@Nullable
String getString(final int index);
/**
* Gets the {@link String} value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a {@link String},
* the default value will be returned.
*
* @param index The index of the {@link String} to retrieve.
* @param def The default value.
* @return The {@link String} value at the index.
*/
@Contract("_, !null -> !null")
@Nullable
String getString(final int index, @Nullable final String def);
/**
* Checks if there is a {@link JSONArray} value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONArray}'s bounds, or if there is no entry ({@code null}), or if
* the entry is not a {@link JSONArray}.
*
* @param index The index to check.
* @return {@code true} if there is a {@link JSONArray} at the given index,
* {@code false} otherwise.
*/
boolean isArray(final int index);
/**
* Gets the {@link JSONArray} value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a {@link JSONArray},
* {@code null} will be returned.
*
* @param index The index of the {@link JSONArray} to retrieve.
* @return The {@link JSONArray} value at the index.
* @see JSONArray#getArray(int, JSONArray)
*/
@Nullable
JSONArray getArray(final int index);
/**
* Gets the {@link JSONArray} value at the given index.
*
* If the index is out of the {@link JSONArray}'s bounds, no entry set
* ({@code null}), or the value at the index is not a {@link JSONArray},
* the default value will be returned.
*
* @param index The index of the {@link JSONArray} to retrieve.
* @param def The default value.
* @return The {@link JSONArray} value at the index.
*/
@Contract("_, !null -> !null")
@Nullable
JSONArray getArray(final int index, @Nullable final JSONArray def);
/**
* Checks if there is a {@link JSONObject} value at the given index.
*
* This will return {@code false} if the index is out of this
* {@link JSONObject}'s bounds, or if there is no entry ({@code null}), or
* if the entry is not a {@link JSONObject}.
*
* @param index The index to check.
* @return {@code true} if there is a {@link JSONObject} at the given index,
* {@code false} otherwise.
*/
boolean isObject(final int index);
/**
* Gets the {@link JSONObject} value at the given index.
*
* If the index is out of the {@link JSONObject}'s bounds, no entry set
* ({@code null}), or the value at the index is not a {@link JSONObject},
* {@code null} will be returned.
*
* @param index The index of the {@link JSONObject} to retrieve.
* @return The {@link JSONObject} value at the index.
* @see JSONArray#getObject(int, JSONObject)
*/
@Nullable
JSONObject getObject(final int index);
/**
* Gets the {@link JSONObject} value at the given index.
*
* If the index is out of the {@link JSONObject}'s bounds, no entry set
* ({@code null}), or the value at the index is not a {@link JSONObject},
* the default value will be returned.
*
* @param index The index of the {@link JSONObject} to retrieve.
* @param def The default value.
* @return The {@link JSONObject} value at the index.
*/
@Contract("_, !null -> !null")
@Nullable
JSONObject getObject(final int index, @Nullable final JSONObject def);
}
