You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ch...@apache.org on 2016/04/24 02:31:27 UTC
[1/3] [lang] clean up javadoc;
fix complaints from maven-javadoc-plugin
Repository: commons-lang
Updated Branches:
refs/heads/master 3c92830ec -> ac1c34155
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/StringUtils.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/StringUtils.java b/src/main/java/org/apache/commons/lang3/StringUtils.java
index bd2b645..f4ec00b 100644
--- a/src/main/java/org/apache/commons/lang3/StringUtils.java
+++ b/src/main/java/org/apache/commons/lang3/StringUtils.java
@@ -4743,8 +4743,8 @@ public class StringUtils {
* StringUtils.removeAll("any", ".*") = ""
* StringUtils.removeAll("any", ".+") = ""
* StringUtils.removeAll("abc", ".?") = ""
- * StringUtils.removeAll("A<__>\n<__>B", "<.*>") = "A\nB"
- * StringUtils.removeAll("A<__>\n<__>B", "(?s)<.*>") = "AB"
+ * StringUtils.removeAll("A<__>\n<__>B", "<.*>") = "A\nB"
+ * StringUtils.removeAll("A<__>\n<__>B", "(?s)<.*>") = "AB"
* StringUtils.removeAll("ABCabc123abc", "[a-z]") = "ABC123"
* </pre>
*
@@ -4789,8 +4789,8 @@ public class StringUtils {
* StringUtils.removeFirst("any", ".*") = ""
* StringUtils.removeFirst("any", ".+") = ""
* StringUtils.removeFirst("abc", ".?") = "bc"
- * StringUtils.removeFirst("A<__>\n<__>B", "<.*>") = "A\n<__>B"
- * StringUtils.removeFirst("A<__>\n<__>B", "(?s)<.*>") = "AB"
+ * StringUtils.removeFirst("A<__>\n<__>B", "<.*>") = "A\n<__>B"
+ * StringUtils.removeFirst("A<__>\n<__>B", "(?s)<.*>") = "AB"
* StringUtils.removeFirst("ABCabc123", "[a-z]") = "ABCbc123"
* StringUtils.removeFirst("ABCabc123abc", "[a-z]+") = "ABC123abc"
* </pre>
@@ -4861,7 +4861,7 @@ public class StringUtils {
* StringUtils.replacePattern("", "", "zzz") = "zzz"
* StringUtils.replacePattern("", ".*", "zzz") = "zzz"
* StringUtils.replacePattern("", ".+", "zzz") = ""
- * StringUtils.replacePattern("<__>\n<__>", "<.*>", "z") = "z"
+ * StringUtils.replacePattern("<__>\n<__>", "<.*>", "z") = "z"
* StringUtils.replacePattern("ABCabc123", "[a-z]", "_") = "ABC___123"
* StringUtils.replacePattern("ABCabc123", "[^A-Z0-9]+", "_") = "ABC_123"
* StringUtils.replacePattern("ABCabc123", "[^A-Z0-9]+", "") = "ABC123"
@@ -4903,7 +4903,7 @@ public class StringUtils {
* <pre>
* StringUtils.removePattern(null, *) = null
* StringUtils.removePattern("any", null) = "any"
- * StringUtils.removePattern("A<__>\n<__>B", "<.*>") = "AB"
+ * StringUtils.removePattern("A<__>\n<__>B", "<.*>") = "AB"
* StringUtils.removePattern("ABCabc123", "[a-z]") = "ABC123"
* </pre>
*
@@ -4947,8 +4947,8 @@ public class StringUtils {
* StringUtils.replaceAll("", ".*", "zzz") = "zzz"
* StringUtils.replaceAll("", ".+", "zzz") = ""
* StringUtils.replaceAll("abc", "", "ZZ") = "ZZaZZbZZcZZ"
- * StringUtils.replaceAll("<__>\n<__>", "<.*>", "z") = "z\nz"
- * StringUtils.replaceAll("<__>\n<__>", "(?s)<.*>", "z") = "z"
+ * StringUtils.replaceAll("<__>\n<__>", "<.*>", "z") = "z\nz"
+ * StringUtils.replaceAll("<__>\n<__>", "(?s)<.*>", "z") = "z"
* StringUtils.replaceAll("ABCabc123", "[a-z]", "_") = "ABC___123"
* StringUtils.replaceAll("ABCabc123", "[^A-Z0-9]+", "_") = "ABC_123"
* StringUtils.replaceAll("ABCabc123", "[^A-Z0-9]+", "") = "ABC123"
@@ -5001,8 +5001,8 @@ public class StringUtils {
* StringUtils.replaceFirst("", ".*", "zzz") = "zzz"
* StringUtils.replaceFirst("", ".+", "zzz") = ""
* StringUtils.replaceFirst("abc", "", "ZZ") = "ZZabc"
- * StringUtils.replaceFirst("<__>\n<__>", "<.*>", "z") = "z\n<__>"
- * StringUtils.replaceFirst("<__>\n<__>", "(?s)<.*>", "z") = "z"
+ * StringUtils.replaceFirst("<__>\n<__>", "<.*>", "z") = "z\n<__>"
+ * StringUtils.replaceFirst("<__>\n<__>", "(?s)<.*>", "z") = "z"
* StringUtils.replaceFirst("ABCabc123", "[a-z]", "_") = "ABC_bc123"
* StringUtils.replaceFirst("ABCabc123abc", "[^A-Z0-9]+", "_") = "ABC_123abc"
* StringUtils.replaceFirst("ABCabc123abc", "[^A-Z0-9]+", "") = "ABC123abc"
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/exception/ExceptionUtils.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/exception/ExceptionUtils.java b/src/main/java/org/apache/commons/lang3/exception/ExceptionUtils.java
index 7474d28..0a7c2cc 100644
--- a/src/main/java/org/apache/commons/lang3/exception/ExceptionUtils.java
+++ b/src/main/java/org/apache/commons/lang3/exception/ExceptionUtils.java
@@ -740,15 +740,15 @@ public class ExceptionUtils {
* exceptions as checked.
*
* @since 3.5
- * @see {{@link #wrapAndThrow(Throwable)}
+ * @see #wrapAndThrow(Throwable)
*
* @param throwable
* The throwable to rethrow.
- * @return R Never actually returns, this generic type matches any type
+ * @param <R> The type of the returned value.
+ * @return Never actually returned, this generic type matches any type
* which the calling site requires. "Returning" the results of this
* method, as done in the propagateExample above, will satisfy the
* java compiler requirement that all code paths return a value.
- * @throws throwable
*/
public static <R> R rethrow(Throwable throwable) {
// claim that the typeErasure invocation throws a RuntimeException
@@ -777,15 +777,16 @@ public class ExceptionUtils {
* determine if the caught exception was caused by the checked exception.
*
* @since 3.5
- * @see {{@link #rethrow(Throwable)}, {{@link #hasCause(Throwable, Class)}
+ * @see #rethrow(Throwable)
+ * @see #hasCause(Throwable, Class)
*
* @param throwable
* The throwable to rethrow.
- * @return R Never actually returns, this generic type matches any type
+ * @param <R> The type of the returned value.
+ * @return Never actually returned, this generic type matches any type
* which the calling site requires. "Returning" the results of this
- * method, will satisfy the java compiler requirement that all code
+ * method will satisfy the java compiler requirement that all code
* paths return a value.
- * @throws throwable
*/
public static <R> R wrapAndThrow(Throwable throwable) {
if (throwable instanceof RuntimeException) {
@@ -802,7 +803,7 @@ public class ExceptionUtils {
* of the given type?
*
* @since 3.5
- * @see {{@link #wrapAndThrow(Throwable)}
+ * @see #wrapAndThrow(Throwable)
*
* @param chain
* The root of a Throwable causal chain.
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java b/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
index 6f8da7f..c34e23d 100644
--- a/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
+++ b/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
@@ -1220,7 +1220,7 @@ public class StrSubstitutor {
* <code>$${this-is-escaped}</code> becomes
* <code>${this-is-escaped}</code>). The default value is <b>false</b>
*
- * @param preserveEscapes
+ * @param preserveEscapes true if escapes are to be preserved
*/
public void setPreserveEscapes(final boolean preserveEscapes) {
this.preserveEscapes = preserveEscapes;
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/text/WordUtils.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/text/WordUtils.java b/src/main/java/org/apache/commons/lang3/text/WordUtils.java
index b805d6b..da92856 100644
--- a/src/main/java/org/apache/commons/lang3/text/WordUtils.java
+++ b/src/main/java/org/apache/commons/lang3/text/WordUtils.java
@@ -16,12 +16,12 @@
*/
package org.apache.commons.lang3.text;
+import java.util.regex.Pattern;
+
import org.apache.commons.lang3.ArrayUtils;
import org.apache.commons.lang3.StringUtils;
import org.apache.commons.lang3.SystemUtils;
-import java.util.regex.Pattern;
-
/**
* <p>Operations on Strings that contain words.</p>
*
@@ -567,7 +567,7 @@ public class WordUtils {
* <p>Checks if the String contains all words in the given array.</p>
*
* <p>
- * A {@code null} String will return {@code false}. A {@code null, zero
+ * A {@code null} String will return {@code false}. A {@code null}, zero
* length search array or if one element of array is null will return {@code false}.
* </p>
*
@@ -581,7 +581,7 @@ public class WordUtils {
* </pre>
*
*
- * @param str The str to check, may be null
+ * @param word The CharSequence to check, may be null
* @param words The array of String words to search for, may be null
* @return {@code true} if all search words are found, {@code false} otherwise
*/
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/time/DatePrinter.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/time/DatePrinter.java b/src/main/java/org/apache/commons/lang3/time/DatePrinter.java
index a2e97a9..8f42ec7 100644
--- a/src/main/java/org/apache/commons/lang3/time/DatePrinter.java
+++ b/src/main/java/org/apache/commons/lang3/time/DatePrinter.java
@@ -102,6 +102,7 @@ public interface DatePrinter {
*
* @param millis the millisecond value to format
* @param buf the buffer to format into
+ * @param <B> the Appendable class type, usually StringBuilder or StringBuffer.
* @return the specified string buffer
* @since 3.5
*/
@@ -113,6 +114,7 @@ public interface DatePrinter {
*
* @param date the date to format
* @param buf the buffer to format into
+ * @param <B> the Appendable class type, usually StringBuilder or StringBuffer.
* @return the specified string buffer
* @since 3.5
*/
@@ -126,6 +128,7 @@ public interface DatePrinter {
*
* @param calendar the calendar to format
* @param buf the buffer to format into
+ * @param <B> the Appendable class type, usually StringBuilder or StringBuffer.
* @return the specified string buffer
* @since 3.5
*/
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java b/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java
index c2907b2..15dab8d 100644
--- a/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java
+++ b/src/main/java/org/apache/commons/lang3/time/FastDateFormat.java
@@ -658,9 +658,9 @@ public class FastDateFormat extends Format implements DateParser, DatePrinter {
/**
* <p>Performs the formatting by applying the rules to the
* specified calendar.</p>
- * @deprecated Use {{@link #format(Calendar, Appendable)
+ * @deprecated Use {@link #format(Calendar, Appendable)}
*
- * @param calendar the calendar to format
+ * @param calendar the calendar to format
* @param buf the buffer to format into
* @return the specified string buffer
*/
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/time/FastDateParser.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/time/FastDateParser.java b/src/main/java/org/apache/commons/lang3/time/FastDateParser.java
index 62f3577..dd369e0 100644
--- a/src/main/java/org/apache/commons/lang3/time/FastDateParser.java
+++ b/src/main/java/org/apache/commons/lang3/time/FastDateParser.java
@@ -124,8 +124,6 @@ public class FastDateParser implements DateParser, Serializable {
* @param timeZone non-null time zone to use
* @param locale non-null locale
* @param centuryStart The start of the century for 2 digit year parsing
- * @param lenient if true, non-standard values for Calendar fields should be accepted;
- * if false, non-standard values will cause a ParseException to be thrown {@link CalendaretLenient(boolean)}
*
* @since 3.5
*/
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java b/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java
index f044552..91ee719 100644
--- a/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java
+++ b/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java
@@ -545,6 +545,7 @@ public class FastDatePrinter implements DatePrinter, Serializable {
*
* @param calendar the calendar to format
* @param buf the buffer to format into
+ * @param <B> the Appendable class type, usually StringBuilder or StringBuffer.
* @return the specified string buffer
*/
protected <B extends Appendable> B applyRules(final Calendar calendar, final B buf) {
[2/3] [lang] clean up javadoc;
fix complaints from maven-javadoc-plugin
Posted by ch...@apache.org.
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ac1c3415/src/main/java/org/apache/commons/lang3/ArrayUtils.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/ArrayUtils.java b/src/main/java/org/apache/commons/lang3/ArrayUtils.java
index b913f20..e8a327e 100644
--- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java
+++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java
@@ -32,14 +32,14 @@ import org.apache.commons.lang3.mutable.MutableInt;
/**
* <p>Operations on arrays, primitive arrays (like {@code int[]}) and
- * primitive wrapper arrays (like {@code Integer[]}).</p>
+ * primitive wrapper arrays (like {@code Integer[]}).
*
* <p>This class tries to handle {@code null} input gracefully.
* An exception will not be thrown for a {@code null}
* array input. However, an Object array that contains a {@code null}
- * element may throw an exception. Each method documents its behaviour.</p>
+ * element may throw an exception. Each method documents its behaviour.
*
- * <p>#ThreadSafe#</p>
+ * <p>#ThreadSafe#
* @since 2.0
*/
public class ArrayUtils {
@@ -130,10 +130,10 @@ public class ArrayUtils {
/**
* <p>ArrayUtils instances should NOT be constructed in standard programming.
- * Instead, the class should be used as <code>ArrayUtils.clone(new int[] {2})</code>.</p>
+ * Instead, the class should be used as <code>ArrayUtils.clone(new int[] {2})</code>.
*
* <p>This constructor is public to permit tools that require a JavaBean instance
- * to operate.</p>
+ * to operate.
*/
public ArrayUtils() {
super();
@@ -146,12 +146,12 @@ public class ArrayUtils {
// Basic methods handling multi-dimensional arrays
//-----------------------------------------------------------------------
/**
- * <p>Outputs an array as a String, treating {@code null} as an empty array.</p>
+ * <p>Outputs an array as a String, treating {@code null} as an empty array.
*
* <p>Multi-dimensional arrays are handled correctly, including
- * multi-dimensional primitive arrays.</p>
+ * multi-dimensional primitive arrays.
*
- * <p>The format is that of Java source code, for example <code>{a,b}</code>.</p>
+ * <p>The format is that of Java source code, for example <code>{a,b}</code>.
*
* @param array the array to get a toString for, may be {@code null}
* @return a String representation of the array, '{}' if null array input
@@ -161,12 +161,12 @@ public class ArrayUtils {
}
/**
- * <p>Outputs an array as a String handling {@code null}s.</p>
+ * <p>Outputs an array as a String handling {@code null}s.
*
* <p>Multi-dimensional arrays are handled correctly, including
- * multi-dimensional primitive arrays.</p>
+ * multi-dimensional primitive arrays.
*
- * <p>The format is that of Java source code, for example <code>{a,b}</code>.</p>
+ * <p>The format is that of Java source code, for example <code>{a,b}</code>.
*
* @param array the array to get a toString for, may be {@code null}
* @param stringIfNull the String to return if the array is {@code null}
@@ -180,9 +180,9 @@ public class ArrayUtils {
}
/**
- * <p>Get a hash code for an array handling multi-dimensional arrays correctly.</p>
+ * <p>Get a hash code for an array handling multi-dimensional arrays correctly.
*
- * <p>Multi-dimensional primitive arrays are also handled correctly by this method.</p>
+ * <p>Multi-dimensional primitive arrays are also handled correctly by this method.
*
* @param array the array to get a hash code for, {@code null} returns zero
* @return a hash code for the array
@@ -193,9 +193,9 @@ public class ArrayUtils {
/**
* <p>Compares two arrays, using equals(), handling multi-dimensional arrays
- * correctly.</p>
+ * correctly.
*
- * <p>Multi-dimensional primitive arrays are also handled correctly by this method.</p>
+ * <p>Multi-dimensional primitive arrays are also handled correctly by this method.
*
* @param array1 the left hand array to compare, may be {@code null}
* @param array2 the right hand array to compare, may be {@code null}
@@ -214,9 +214,9 @@ public class ArrayUtils {
* <p>Converts the given array into a {@link java.util.Map}. Each element of the array
* must be either a {@link java.util.Map.Entry} or an Array, containing at least two
* elements, where the first element is used as key and the second as
- * value.</p>
+ * value.
*
- * <p>This method can be used to initialize:</p>
+ * <p>This method can be used to initialize:
* <pre>
* // Create a Map mapping colors.
* Map colorMap = MapUtils.toMap(new String[][] {{
@@ -225,7 +225,7 @@ public class ArrayUtils {
* {"BLUE", "#0000FF"}});
* </pre>
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array an array whose elements are either a {@link java.util.Map.Entry} or
* an Array containing at least two elements, may be {@code null}
@@ -265,9 +265,9 @@ public class ArrayUtils {
// Generic array
//-----------------------------------------------------------------------
/**
- * <p>Create a type-safe generic array.</p>
+ * <p>Create a type-safe generic array.
*
- * <p>The Java language does not allow an array to be created from a generic type:</p>
+ * <p>The Java language does not allow an array to be created from a generic type:
*
* <pre>
public static <T> T[] createAnArray(int size) {
@@ -279,7 +279,7 @@ public class ArrayUtils {
* </pre>
*
* <p>Therefore new arrays of generic types can be created with this method.
- * For example, an array of Strings can be created:</p>
+ * For example, an array of Strings can be created:
*
* <pre>
String[] array = ArrayUtils.toArray("1", "2");
@@ -287,14 +287,14 @@ public class ArrayUtils {
* </pre>
*
* <p>The method is typically used in scenarios, where the caller itself uses generic types
- * that have to be combined into an array.</p>
+ * that have to be combined into an array.
*
* <p>Note, this method makes only sense to provide arguments of the same type so that the
* compiler can deduce the type of the array itself. While it is possible to select the
* type explicitly like in
* <code>Number[] array = ArrayUtils.<Number>toArray(Integer.valueOf(42), Double.valueOf(Math.PI))</code>,
* there is no real advantage when compared to
- * <code>new Number[] {Integer.valueOf(42), Double.valueOf(Math.PI)}</code>.</p>
+ * <code>new Number[] {Integer.valueOf(42), Double.valueOf(Math.PI)}</code>.
*
* @param <T> the array's element type
* @param items the varargs array items, null allowed
@@ -309,12 +309,12 @@ public class ArrayUtils {
//-----------------------------------------------------------------------
/**
* <p>Shallow clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
* <p>The objects in the array are not cloned, thus there is no special
- * handling for multi-dimensional arrays.</p>
+ * handling for multi-dimensional arrays.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param <T> the component type of the array
* @param array the array to shallow clone, may be {@code null}
@@ -329,9 +329,9 @@ public class ArrayUtils {
/**
* <p>Clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array the array to clone, may be {@code null}
* @return the cloned array, {@code null} if {@code null} input
@@ -345,9 +345,9 @@ public class ArrayUtils {
/**
* <p>Clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array the array to clone, may be {@code null}
* @return the cloned array, {@code null} if {@code null} input
@@ -361,9 +361,9 @@ public class ArrayUtils {
/**
* <p>Clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array the array to clone, may be {@code null}
* @return the cloned array, {@code null} if {@code null} input
@@ -377,9 +377,9 @@ public class ArrayUtils {
/**
* <p>Clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array the array to clone, may be {@code null}
* @return the cloned array, {@code null} if {@code null} input
@@ -393,9 +393,9 @@ public class ArrayUtils {
/**
* <p>Clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array the array to clone, may be {@code null}
* @return the cloned array, {@code null} if {@code null} input
@@ -409,9 +409,9 @@ public class ArrayUtils {
/**
* <p>Clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array the array to clone, may be {@code null}
* @return the cloned array, {@code null} if {@code null} input
@@ -425,9 +425,9 @@ public class ArrayUtils {
/**
* <p>Clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array the array to clone, may be {@code null}
* @return the cloned array, {@code null} if {@code null} input
@@ -441,9 +441,9 @@ public class ArrayUtils {
/**
* <p>Clones an array returning a typecast result and handling
- * {@code null}.</p>
+ * {@code null}.
*
- * <p>This method returns {@code null} for a {@code null} input array.</p>
+ * <p>This method returns {@code null} for a {@code null} input array.
*
* @param array the array to clone, may be {@code null}
* @return the cloned array, {@code null} if {@code null} input
@@ -459,12 +459,13 @@ public class ArrayUtils {
//-----------------------------------------------------------------------
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* @param array the array to check for {@code null} or empty
* @param type the class representation of the desired array
+ * @param <T> the class type
* @return the same array, {@code public static} empty array if {@code null}
* @throws IllegalArgumentException if the type argument is null
* @since 3.5
@@ -483,12 +484,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -503,12 +504,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -523,12 +524,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -543,12 +544,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -563,12 +564,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -583,12 +584,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -603,12 +604,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -623,12 +624,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -643,12 +644,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -663,12 +664,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -683,12 +684,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -703,12 +704,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -723,12 +724,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -743,12 +744,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -763,12 +764,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -783,12 +784,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -803,12 +804,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -823,12 +824,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -843,12 +844,12 @@ public class ArrayUtils {
/**
* <p>Defensive programming technique to change a {@code null}
- * reference to an empty one.</p>
+ * reference to an empty one.
*
- * <p>This method returns an empty array for a {@code null} input array.</p>
+ * <p>This method returns an empty array for a {@code null} input array.
*
* <p>As a memory optimizing technique an empty array passed in will be overridden with
- * the empty {@code public static} references in this class.</p>
+ * the empty {@code public static} references in this class.
*
* @param array the array to check for {@code null} or empty
* @return the same array, {@code public static} empty array if {@code null} or empty input
@@ -865,14 +866,14 @@ public class ArrayUtils {
//-----------------------------------------------------------------------
/**
* <p>Produces a new array containing the elements between
- * the start and end indices.</p>
+ * the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* <p>The component type of the subarray is always the same as
* that of the input array. Thus, if the input is an array of type
- * {@code Date}, the following usage is envisaged:</p>
+ * {@code Date}, the following usage is envisaged:
*
* <pre>
* Date[] someDates = (Date[])ArrayUtils.subarray(allDates, 2, 5);
@@ -918,10 +919,10 @@ public class ArrayUtils {
/**
* <p>Produces a new {@code long} array containing the elements
- * between the start and end indices.</p>
+ * between the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* @param array the array
* @param startIndexInclusive the starting index. Undervalue (<0)
@@ -958,10 +959,10 @@ public class ArrayUtils {
/**
* <p>Produces a new {@code int} array containing the elements
- * between the start and end indices.</p>
+ * between the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* @param array the array
* @param startIndexInclusive the starting index. Undervalue (<0)
@@ -998,10 +999,10 @@ public class ArrayUtils {
/**
* <p>Produces a new {@code short} array containing the elements
- * between the start and end indices.</p>
+ * between the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* @param array the array
* @param startIndexInclusive the starting index. Undervalue (<0)
@@ -1038,10 +1039,10 @@ public class ArrayUtils {
/**
* <p>Produces a new {@code char} array containing the elements
- * between the start and end indices.</p>
+ * between the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* @param array the array
* @param startIndexInclusive the starting index. Undervalue (<0)
@@ -1078,10 +1079,10 @@ public class ArrayUtils {
/**
* <p>Produces a new {@code byte} array containing the elements
- * between the start and end indices.</p>
+ * between the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* @param array the array
* @param startIndexInclusive the starting index. Undervalue (<0)
@@ -1118,10 +1119,10 @@ public class ArrayUtils {
/**
* <p>Produces a new {@code double} array containing the elements
- * between the start and end indices.</p>
+ * between the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* @param array the array
* @param startIndexInclusive the starting index. Undervalue (<0)
@@ -1158,10 +1159,10 @@ public class ArrayUtils {
/**
* <p>Produces a new {@code float} array containing the elements
- * between the start and end indices.</p>
+ * between the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* @param array the array
* @param startIndexInclusive the starting index. Undervalue (<0)
@@ -1198,10 +1199,10 @@ public class ArrayUtils {
/**
* <p>Produces a new {@code boolean} array containing the elements
- * between the start and end indices.</p>
+ * between the start and end indices.
*
* <p>The start index is inclusive, the end index exclusive.
- * Null array input produces null output.</p>
+ * Null array input produces null output.
*
* @param array the array
* @param startIndexInclusive the starting index. Undervalue (<0)
@@ -1242,7 +1243,7 @@ public class ArrayUtils {
* <p>Checks whether two arrays are the same length, treating
* {@code null} arrays as length {@code 0}.
*
- * <p>Any multi-dimensional aspects of the arrays are ignored.</p>
+ * <p>Any multi-dimensional aspects of the arrays are ignored.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1255,7 +1256,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same length, treating
- * {@code null} arrays as length {@code 0}.</p>
+ * {@code null} arrays as length {@code 0}.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1268,7 +1269,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same length, treating
- * {@code null} arrays as length {@code 0}.</p>
+ * {@code null} arrays as length {@code 0}.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1281,7 +1282,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same length, treating
- * {@code null} arrays as length {@code 0}.</p>
+ * {@code null} arrays as length {@code 0}.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1294,7 +1295,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same length, treating
- * {@code null} arrays as length {@code 0}.</p>
+ * {@code null} arrays as length {@code 0}.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1307,7 +1308,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same length, treating
- * {@code null} arrays as length {@code 0}.</p>
+ * {@code null} arrays as length {@code 0}.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1320,7 +1321,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same length, treating
- * {@code null} arrays as length {@code 0}.</p>
+ * {@code null} arrays as length {@code 0}.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1333,7 +1334,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same length, treating
- * {@code null} arrays as length {@code 0}.</p>
+ * {@code null} arrays as length {@code 0}.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1346,7 +1347,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same length, treating
- * {@code null} arrays as length {@code 0}.</p>
+ * {@code null} arrays as length {@code 0}.
*
* @param array1 the first array, may be {@code null}
* @param array2 the second array, may be {@code null}
@@ -1360,9 +1361,9 @@ public class ArrayUtils {
//-----------------------------------------------------------------------
/**
* <p>Returns the length of the specified array.
- * This method can deal with {@code Object} arrays and with primitive arrays.</p>
+ * This method can deal with {@code Object} arrays and with primitive arrays.
*
- * <p>If the input array is {@code null}, {@code 0} is returned.</p>
+ * <p>If the input array is {@code null}, {@code 0} is returned.
*
* <pre>
* ArrayUtils.getLength(null) = 0
@@ -1387,7 +1388,7 @@ public class ArrayUtils {
/**
* <p>Checks whether two arrays are the same type taking into account
- * multi-dimensional arrays.</p>
+ * multi-dimensional arrays.
*
* @param array1 the first array, must not be {@code null}
* @param array2 the second array, must not be {@code null}
@@ -1404,11 +1405,11 @@ public class ArrayUtils {
// Reverse
//-----------------------------------------------------------------------
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>There is no special handling for multi-dimensional arrays.</p>
+ * <p>There is no special handling for multi-dimensional arrays.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1420,9 +1421,9 @@ public class ArrayUtils {
}
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1434,9 +1435,9 @@ public class ArrayUtils {
}
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1448,9 +1449,9 @@ public class ArrayUtils {
}
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1462,9 +1463,9 @@ public class ArrayUtils {
}
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1476,9 +1477,9 @@ public class ArrayUtils {
}
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1490,9 +1491,9 @@ public class ArrayUtils {
}
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1504,9 +1505,9 @@ public class ArrayUtils {
}
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1518,9 +1519,9 @@ public class ArrayUtils {
}
/**
- * <p>Reverses the order of the given array.</p>
+ * <p>Reverses the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to reverse, may be {@code null}
*/
@@ -1534,11 +1535,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1569,11 +1568,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1604,11 +1601,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1639,11 +1634,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1674,11 +1667,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1709,11 +1700,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1744,11 +1733,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1779,11 +1766,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1814,11 +1799,9 @@ public class ArrayUtils {
/**
* <p>
* Reverses the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to reverse, may be {@code null}
@@ -1849,22 +1832,21 @@ public class ArrayUtils {
// Swap
//-----------------------------------------------------------------------
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
- * <p>There is no special handling for multi-dimensional arrays.</p>
+ * <p>There is no special handling for multi-dimensional arrays.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap(["1", "2", "3"], 0, 2) -> ["3", "2", "1"]</li>
- * <li>ArrayUtils.swap(["1", "2", "3"], 0, 0) -> ["1", "2", "3"]</li>
- * <li>ArrayUtils.swap(["1", "2", "3"], 1, 0) -> ["2", "1", "3"]</li>
- * <li>ArrayUtils.swap(["1", "2", "3"], 0, 5) -> ["1", "2", "3"]</li>
- * <li>ArrayUtils.swap(["1", "2", "3"], -1, 1) -> ["2", "1", "3"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3"], 0, 2) -> ["3", "2", "1"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3"], 0, 0) -> ["1", "2", "3"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3"], 1, 0) -> ["2", "1", "3"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3"], 0, 5) -> ["1", "2", "3"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3"], -1, 1) -> ["2", "1", "3"]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -1878,22 +1860,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
- * <p>There is no special handling for multi-dimensional arrays.</p>
+ * <p>There is no special handling for multi-dimensional arrays.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([true, false, true], 0, 2) -> [true, false, true]</li>
- * <li>ArrayUtils.swap([true, false, true], 0, 0) -> [true, false, true]</li>
- * <li>ArrayUtils.swap([true, false, true], 1, 0) -> [false, true, true]</li>
- * <li>ArrayUtils.swap([true, false, true], 0, 5) -> [true, false, true]</li>
- * <li>ArrayUtils.swap([true, false, true], -1, 1) -> [false, true, true]</li>
+ * <li>ArrayUtils.swap([true, false, true], 0, 2) -> [true, false, true]</li>
+ * <li>ArrayUtils.swap([true, false, true], 0, 0) -> [true, false, true]</li>
+ * <li>ArrayUtils.swap([true, false, true], 1, 0) -> [false, true, true]</li>
+ * <li>ArrayUtils.swap([true, false, true], 0, 5) -> [true, false, true]</li>
+ * <li>ArrayUtils.swap([true, false, true], -1, 1) -> [false, true, true]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -1907,20 +1888,19 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -1934,20 +1914,19 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -1961,20 +1940,19 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -1988,20 +1966,19 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -2015,20 +1992,19 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -2042,20 +2018,19 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -2069,20 +2044,19 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.</p>
+ * <p>Swaps two elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
- * Negative indices are promoted to 0(zero).</p>
+ * Negative indices are promoted to 0(zero).
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
- * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> [1, 2, 3]</li>
+ * <li>ArrayUtils.swap([1, 2, 3], -1, 1) -> [2, 1, 3]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
@@ -2096,23 +2070,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([true, false, true, false], 0, 2, 1) -> [true, false, true, false]</li>
- * <li>ArrayUtils.swap([true, false, true, false], 0, 0, 1) -> [true, false, true, false]</li>
- * <li>ArrayUtils.swap([true, false, true, false], 0, 2, 2) -> [true, false, true, false]</li>
- * <li>ArrayUtils.swap([true, false, true, false], -3, 2, 2) -> [true, false, true, false]</li>
- * <li>ArrayUtils.swap([true, false, true, false], 0, 3, 3) -> [false, false, true, true]</li>
+ * <li>ArrayUtils.swap([true, false, true, false], 0, 2, 1) -> [true, false, true, false]</li>
+ * <li>ArrayUtils.swap([true, false, true, false], 0, 0, 1) -> [true, false, true, false]</li>
+ * <li>ArrayUtils.swap([true, false, true, false], 0, 2, 2) -> [true, false, true, false]</li>
+ * <li>ArrayUtils.swap([true, false, true, false], -3, 2, 2) -> [true, false, true, false]</li>
+ * <li>ArrayUtils.swap([true, false, true, false], 0, 3, 3) -> [false, false, true, true]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2138,23 +2110,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2181,23 +2151,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2223,23 +2191,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2265,23 +2231,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2308,23 +2272,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2350,23 +2312,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2392,23 +2352,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 2, 1) -> ["3", "2", "1", "4"]</li>
- * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 0, 1) -> ["1", "2", "3", "4"]</li>
- * <li>ArrayUtils.swap(["1", "2", "3", "4"], 2, 0, 2) -> ["3", "4", "1", "2"]</li>
- * <li>ArrayUtils.swap(["1", "2", "3", "4"], -3, 2, 2) -> ["3", "4", "1", "2"]</li>
- * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 3, 3) -> ["4", "2", "3", "1"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 2, 1) -> ["3", "2", "1", "4"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 0, 1) -> ["1", "2", "3", "4"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3", "4"], 2, 0, 2) -> ["3", "4", "1", "2"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3", "4"], -3, 2, 2) -> ["3", "4", "1", "2"]</li>
+ * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 3, 3) -> ["4", "2", "3", "1"]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2434,23 +2392,21 @@ public class ArrayUtils {
}
/**
- * <p>Swaps a series of elements in the given array.</p>
+ * <p>Swaps a series of elements in the given array.
*
* <p>This method does nothing for a {@code null} or empty input array or for overflow indices.
* Negative indices are promoted to 0(zero).
* If any of the sub-arrays to swap falls outside of the given array,
* then the swap is stopped at the end of the array and as many as possible elements are swapped.
- * </p>
*
* <p>Examples:
* <ul>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
- * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], -3, 2, 2) -> [3, 4, 1, 2]</li>
+ * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> [4, 2, 3, 1]</li>
* </ul>
- * </p>
*
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element in the series to swap
@@ -2481,14 +2437,17 @@ public class ArrayUtils {
// Shift
//-----------------------------------------------------------------------
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>There is no special handling for multi-dimensional arrays.</p>
+ * <p>There is no special handling for multi-dimensional arrays.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
* @param offset how many position to the right to shift the array, if negative it will be shiftd to the left.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final Object[] array, int offset) {
if (array == null) {
@@ -2498,11 +2457,14 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final long[] array, int offset) {
if (array == null) {
@@ -2512,11 +2474,14 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final int[] array, int offset) {
if (array == null) {
@@ -2526,11 +2491,14 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final short[] array, int offset) {
if (array == null) {
@@ -2540,11 +2508,14 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final char[] array, int offset) {
if (array == null) {
@@ -2554,11 +2525,14 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final byte[] array, int offset) {
if (array == null) {
@@ -2568,11 +2542,14 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final double[] array, int offset) {
if (array == null) {
@@ -2582,11 +2559,14 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final float[] array, int offset) {
if (array == null) {
@@ -2596,11 +2576,14 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.</p>
+ * <p>Shifts the order of the given array.
*
- * <p>This method does nothing for a {@code null} input array.</p>
+ * <p>This method does nothing for a {@code null} input array.
*
* @param array the array to shift, may be {@code null}
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final boolean[] array, int offset) {
if (array == null) {
@@ -2612,11 +2595,9 @@ public class ArrayUtils {
/**
* <p>
* Shifts the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2626,6 +2607,9 @@ public class ArrayUtils {
* @param endIndexExclusive
* elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
* @since 3.2
*/
public static void shift(final boolean[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
@@ -2672,11 +2656,9 @@ public class ArrayUtils {
/**
* <p>
* Shifts the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2686,6 +2668,9 @@ public class ArrayUtils {
* @param endIndexExclusive
* elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
* @since 3.2
*/
public static void shift(final byte[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
@@ -2732,11 +2717,9 @@ public class ArrayUtils {
/**
* <p>
* Shifts the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2746,6 +2729,9 @@ public class ArrayUtils {
* @param endIndexExclusive
* elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
* @since 3.2
*/
public static void shift(final char[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
@@ -2792,11 +2778,9 @@ public class ArrayUtils {
/**
* <p>
* Shifts the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2806,6 +2790,9 @@ public class ArrayUtils {
* @param endIndexExclusive
* elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
* @since 3.2
*/
public static void shift(final double[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
@@ -2852,11 +2839,9 @@ public class ArrayUtils {
/**
* <p>
* Shifts the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2866,6 +2851,9 @@ public class ArrayUtils {
* @param endIndexExclusive
* elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
* @since 3.2
*/
public static void shift(final float[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
@@ -2912,11 +2900,9 @@ public class ArrayUtils {
/**
* <p>
* Shifts the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2926,6 +2912,9 @@ public class ArrayUtils {
* @param endIndexExclusive
* elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
* @since 3.2
*/
public static void shift(final int[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
@@ -2972,11 +2961,9 @@ public class ArrayUtils {
/**
* <p>
* Shifts the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2986,6 +2973,9 @@ public class ArrayUtils {
* @param endIndexExclusive
* elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final long[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -3031,11 +3021,9 @@ public class ArrayUtils {
/**
* <p>
* Shifts the order of the given array in the given range.
- * </p>
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -3045,6 +3033,9 @@ public class ArrayUtils {
* @param endIndexExclusive
* elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
*/
public static void shift(final Object[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -3089,12 +3080,10 @@ public class ArrayUtils {
/**
* <p>
- * Shifts the order of the given array in the given range.
- * </p>
+ * Rotate the elements of the given array in the given range.
*
* <p>
* This method does nothing for a {@code null} input array.
- * </p>
*
* @param array
* the array to shift, may be {@code null}
@@ -3102,8 +3091,11 @@ public class ArrayUtils {
* the starting index. Undervalue (<0) is promoted to 0, overvalue (>array.length) results in no
* change.
* @param endIndexExclusive
- * elements up to endIndex-1 are shiftd in the array. Undervalue (< start index) results in no
+ * elements up to endIndex-1 are shifted in the array. Undervalue (< start index) results in no
* change. Overvalue (>array.length) is demoted to array length.
+ * @param offset
+ * The number of positions to rotate the elements. If the offset is larger than the number of elements to
+ * rotate, than the effective offset is modulo the number of elements to rotate.
* @since 3.2
*/
public static void shift(final short[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
@@ -3153,9 +3145,9 @@ public class ArrayUtils {
// Object IndexOf
//-----------------------------------------------------------------------
/**
- * <p>Finds the index of the given object in the array.</p>
+ * <p>Finds the index of the given object in the array.
*
- * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p>
+ * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.
*
* @param array the array to search through for the object, may be {@code null}
* @param objectToFind the object to find, may be {@code null}
@@ -3167,12 +3159,12 @@ public class ArrayUtils {
}
/**
- * <p>Finds the index of the given object in the array starting at the given index.</p>
+ * <p>Finds the index of the given object in the array starting at the given index.
*
- * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p>
+ * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.
*
* <p>A negative startIndex is treated as zero. A startIndex larger than the array
- * length will return {@link #INDEX_NOT_FOUND} ({@code -1}).</p>
+ * length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
*
* @param array the array to search through for the object, may be {@code null}
* @param objectToFind the object to find, may be {@code null}
@@ -3204,9 +3196,9 @@ public class ArrayUtils {
}
/**
- * <p>Finds the last index of the given object within the array.</p>
+ * <p>Finds the last index of the given object within the array.
*
- * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p>
+ * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.
*
* @param array the array to travers backwords looking for the object, may be {@code null}
* @param objectToFind the object to find, may be {@code null}
@@ -3218,12 +3210,12 @@ public class ArrayUtils {
}
/**
- * <p>Finds the last index of the given object in the array starting at the given index.</p>
+ * <p>Finds the last index of the given object in the array starting at the given index.
*
- * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p>
+ * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.
*
* <p>A negative startIndex will return {@link #INDEX_NOT_FOUND} ({@code -1}). A startIndex larger than
- * the array length will search from the end of the array.</p>
+ * the array length wil
<TRUNCATED>
[3/3] [lang] clean up javadoc;
fix complaints from maven-javadoc-plugin
Posted by ch...@apache.org.
clean up javadoc; fix complaints from maven-javadoc-plugin
Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/ac1c3415
Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/ac1c3415
Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/ac1c3415
Branch: refs/heads/master
Commit: ac1c341558ae3139a5c1eb07bf148230192d6f57
Parents: 3c92830
Author: Chas Honton <ch...@apache.org>
Authored: Sat Apr 23 17:31:14 2016 -0700
Committer: Chas Honton <ch...@apache.org>
Committed: Sat Apr 23 17:31:14 2016 -0700
----------------------------------------------------------------------
.../org/apache/commons/lang3/ArrayUtils.java | 1431 +++++++++---------
.../org/apache/commons/lang3/StringUtils.java | 20 +-
.../commons/lang3/exception/ExceptionUtils.java | 17 +-
.../commons/lang3/text/StrSubstitutor.java | 2 +-
.../apache/commons/lang3/text/WordUtils.java | 8 +-
.../apache/commons/lang3/time/DatePrinter.java | 3 +
.../commons/lang3/time/FastDateFormat.java | 4 +-
.../commons/lang3/time/FastDateParser.java | 2 -
.../commons/lang3/time/FastDatePrinter.java | 1 +
9 files changed, 737 insertions(+), 751 deletions(-)
----------------------------------------------------------------------