enum support

stleary · stleary · commit 9785b4ff0b2d · 2015-07-22T20:16:02.000-05:00
diff --git a/JSONArray.java b/JSONArray.java
@@ -254,7 +254,7 @@ public double getDouble(int index) throws JSONException {
     *            The type of enum to retrieve.
     * @param index
     *            The index must be between 0 and length() - 1.
-    * @return The enum value.
+    * @return The enum value at the index location
     * @throws JSONException
     *            if the key is not found or if the value cannot be converted
     *            to an enum.
@@ -563,7 +563,7 @@ public int optInt(int index, int defaultValue) {
      *            The type of enum to retrieve.
      * @param index
      *            The index must be between 0 and length() - 1.
-     * @return The enum value or null if not found
+     * @return The enum value at the index location or null if not found
      */
     public <E extends Enum<E>> E optEnum(Class<E> clazz, int index) {
         return this.optEnum(clazz, index, null);
@@ -578,8 +578,8 @@ public <E extends Enum<E>> E optEnum(Class<E> clazz, int index) {
      *            The index must be between 0 and length() - 1.
      * @param defaultValue
      *            The default in case the value is not found
-     * @return The enum value or defaultValue if the value is not found or
-     *            cannot be assigned to clazz
+     * @return The enum value at the index location or defaultValue if
+     *            the value is not found or cannot be assigned to clazz
      */
     public <E extends Enum<E>> E optEnum(Class<E> clazz, int index, E defaultValue) {
         try {
diff --git a/JSONObject.java b/JSONObject.java
@@ -486,7 +486,7 @@ public Object get(String key) throws JSONException {
     *           The type of enum to retrieve.
     * @param key
     *           A key string.
-    * @return The enum value.
+    * @return The enum value associated with the key
     * @throws JSONException
     *             if the key is not found or if the value cannot be converted
     *             to an enum.
@@ -876,7 +876,7 @@ public Object opt(String key) {
      *            The type of enum to retrieve.
      * @param key
      *            A key string.
-     * @return The enum value or null if not found
+     * @return The enum value associated with the key or null if not found
      */
     public <E extends Enum<E>> E optEnum(Class<E> clazz, String key) {
         return this.optEnum(clazz, key, null);
@@ -891,8 +891,8 @@ public <E extends Enum<E>> E optEnum(Class<E> clazz, String key) {
      *            A key string.
      * @param defaultValue
      *            The default in case the value is not found
-     * @return The enum value or defaultValue if the value is not found or
-     *            cannot be assigned to clazz
+     * @return The enum value associated with the key or defaultValue
+     *            if the value is not found or cannot be assigned to clazz
      */
     public <E extends Enum<E>> E optEnum(Class<E> clazz, String key, E defaultValue) {
         try {
