You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by br...@apache.org on 2016/09/11 13:22:26 UTC
[1/4] [lang] Add and correct @since tag for swap and shift methods
introduced in 3.5
Repository: commons-lang
Updated Branches:
refs/heads/master ee6f3fa7a -> 0bdeb204c
Add and correct @since tag for swap and shift methods introduced in 3.5
Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/5b5b374d
Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/5b5b374d
Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/5b5b374d
Branch: refs/heads/master
Commit: 5b5b374de30f5a2b65f465e4c3a51b1a97ec4f1c
Parents: ee6f3fa
Author: Benedikt Ritter <br...@apache.org>
Authored: Sun Sep 11 15:01:03 2016 +0200
Committer: Benedikt Ritter <br...@apache.org>
Committed: Sun Sep 11 15:01:03 2016 +0200
----------------------------------------------------------------------
.../org/apache/commons/lang3/ArrayUtils.java | 44 ++++++++++++++++----
1 file changed, 36 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/5b5b374d/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 cc16828..867794f 100644
--- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java
+++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java
@@ -1851,6 +1851,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final Object[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -1879,6 +1880,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final long[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -1905,6 +1907,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final int[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -1931,6 +1934,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final short[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -1957,6 +1961,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final char[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -1983,6 +1988,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final byte[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -2009,6 +2015,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final double[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -2035,6 +2042,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final float[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -2061,6 +2069,7 @@ public class ArrayUtils {
* @param array the array to swap, may be {@code null}
* @param offset1 the index of the first element to swap
* @param offset2 the index of the second element to swap
+ * @since 3.5
*/
public static void swap(final boolean[] array, int offset1, int offset2) {
if (array == null || array.length == 0) {
@@ -2090,6 +2099,7 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
public static void swap(final boolean[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
@@ -2130,8 +2140,8 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
-
public static void swap(final byte[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
return;
@@ -2171,6 +2181,7 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
public static void swap(final char[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
@@ -2211,6 +2222,7 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
public static void swap(final double[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
@@ -2251,6 +2263,7 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
public static void swap(final float[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
@@ -2292,6 +2305,7 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
public static void swap(final int[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
@@ -2332,6 +2346,7 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
public static void swap(final long[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
@@ -2372,6 +2387,7 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
public static void swap(final Object[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
@@ -2412,6 +2428,7 @@ public class ArrayUtils {
* @param offset1 the index of the first element in the series to swap
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
+ * @since 3.5
*/
public static void swap(final short[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
@@ -2447,6 +2464,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final Object[] array, int offset) {
if (array == null) {
@@ -2464,6 +2482,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final long[] array, int offset) {
if (array == null) {
@@ -2481,6 +2500,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final int[] array, int offset) {
if (array == null) {
@@ -2498,6 +2518,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final short[] array, int offset) {
if (array == null) {
@@ -2515,6 +2536,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final char[] array, int offset) {
if (array == null) {
@@ -2532,6 +2554,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final byte[] array, int offset) {
if (array == null) {
@@ -2549,6 +2572,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final double[] array, int offset) {
if (array == null) {
@@ -2566,6 +2590,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final float[] array, int offset) {
if (array == null) {
@@ -2583,6 +2608,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final boolean[] array, int offset) {
if (array == null) {
@@ -2609,7 +2635,7 @@ public class ArrayUtils {
* @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
+ * @since 3.5
*/
public static void shift(final boolean[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -2670,7 +2696,7 @@ public class ArrayUtils {
* @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
+ * @since 3.5
*/
public static void shift(final byte[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -2731,7 +2757,7 @@ public class ArrayUtils {
* @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
+ * @since 3.5
*/
public static void shift(final char[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -2792,7 +2818,7 @@ public class ArrayUtils {
* @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
+ * @since 3.5
*/
public static void shift(final double[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -2853,7 +2879,7 @@ public class ArrayUtils {
* @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
+ * @since 3.5
*/
public static void shift(final float[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -2914,7 +2940,7 @@ public class ArrayUtils {
* @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
+ * @since 3.5
*/
public static void shift(final int[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -2975,6 +3001,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final long[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -3035,6 +3062,7 @@ public class ArrayUtils {
* @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.5
*/
public static void shift(final Object[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
@@ -3095,7 +3123,7 @@ public class ArrayUtils {
* @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
+ * @since 3.5
*/
public static void shift(final short[] array, int startIndexInclusive, int endIndexExclusive, int offset) {
if (array == null) {
[3/4] [lang] Correct indent of method declaration
Posted by br...@apache.org.
Correct indent of method declaration
Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/ff8fd957
Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/ff8fd957
Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/ff8fd957
Branch: refs/heads/master
Commit: ff8fd9578ee8f66e6f80cd7b9f204767845b7339
Parents: cf6b6d8
Author: Benedikt Ritter <br...@apache.org>
Authored: Sun Sep 11 15:14:24 2016 +0200
Committer: Benedikt Ritter <br...@apache.org>
Committed: Sun Sep 11 15:14:24 2016 +0200
----------------------------------------------------------------------
src/main/java/org/apache/commons/lang3/ArrayUtils.java | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/ff8fd957/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 5cb32bd..db6ce7b 100644
--- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java
+++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java
@@ -2402,7 +2402,7 @@ public class ArrayUtils {
* 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>
@@ -2419,7 +2419,7 @@ public class ArrayUtils {
* @param len the number of elements to swap starting with the given indices
* @since 3.5
*/
- public static void swap(final Object[] array, int offset1, int offset2, int len) {
+ public static void swap(final Object[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
return;
}
[2/4] [lang] Better JavaDoc for ArrayUtils.swap variants
Posted by br...@apache.org.
Better JavaDoc for ArrayUtils.swap variants
Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/cf6b6d8e
Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/cf6b6d8e
Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/cf6b6d8e
Branch: refs/heads/master
Commit: cf6b6d8eb1b524b73cdb74168f3190ab471aa52f
Parents: 5b5b374
Author: Benedikt Ritter <br...@apache.org>
Authored: Sun Sep 11 15:10:46 2016 +0200
Committer: Benedikt Ritter <br...@apache.org>
Committed: Sun Sep 11 15:13:18 2016 +0200
----------------------------------------------------------------------
.../org/apache/commons/lang3/ArrayUtils.java | 264 +++++++++++--------
1 file changed, 148 insertions(+), 116 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/cf6b6d8e/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 867794f..5cb32bd 100644
--- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java
+++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java
@@ -1832,12 +1832,11 @@ public class ArrayUtils {
// Swap
//-----------------------------------------------------------------------
/**
- * <p>Swaps two elements in the given array.
+ * Swaps two elements in the given array.
*
- * <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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -1847,6 +1846,7 @@ public class ArrayUtils {
* <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
@@ -1861,12 +1861,11 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.
- *
- * <p>There is no special handling for multi-dimensional arrays.
+ * <p>Swaps two elements in the given long 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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -1876,7 +1875,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element to swap
@@ -1890,10 +1890,11 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.
+ * Swaps two elements in the given int 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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -1903,6 +1904,7 @@ public class ArrayUtils {
* <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
@@ -1917,10 +1919,11 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.
+ * Swaps two elements in the given short 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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -1930,6 +1933,7 @@ public class ArrayUtils {
* <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
@@ -1944,10 +1948,11 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.
+ * Swaps two elements in the given char 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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -1957,6 +1962,7 @@ public class ArrayUtils {
* <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
@@ -1971,10 +1977,11 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.
+ * Swaps two elements in the given byte 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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -1984,7 +1991,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element to swap
@@ -1998,10 +2006,11 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.
+ * Swaps two elements in the given double 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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -2011,7 +2020,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element to swap
@@ -2025,10 +2035,11 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.
+ * Swaps two elements in the given float 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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -2038,7 +2049,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element to swap
@@ -2052,10 +2064,11 @@ public class ArrayUtils {
}
/**
- * <p>Swaps two elements in the given array.
+ * Swaps two elements in the given boolean 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>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for a {@code null} or empty input array or for overflow indices.
+ * Negative indices are promoted to 0(zero).</p>
*
* <p>Examples:
* <ul>
@@ -2065,7 +2078,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element to swap
@@ -2079,12 +2093,13 @@ public class ArrayUtils {
}
/**
- * <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.
+ * Swaps a series of elements in the given boolean 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>
@@ -2094,14 +2109,15 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
* @since 3.5
*/
- public static void swap(final boolean[] array, int offset1, int offset2, int len) {
+ public static void swap(final boolean[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
return;
}
@@ -2120,13 +2136,14 @@ public class ArrayUtils {
}
/**
- * <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.
- *
+ * Swaps a series of elements in the given byte 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>
@@ -2135,14 +2152,15 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
* @since 3.5
*/
- public static void swap(final byte[] array, int offset1, int offset2, int len) {
+ public static void swap(final byte[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
return;
}
@@ -2161,12 +2179,13 @@ public class ArrayUtils {
}
/**
- * <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.
+ * Swaps a series of elements in the given char 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>
@@ -2176,14 +2195,15 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
* @since 3.5
*/
- public static void swap(final char[] array, int offset1, int offset2, int len) {
+ public static void swap(final char[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
return;
}
@@ -2202,12 +2222,13 @@ public class ArrayUtils {
}
/**
- * <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.
+ * Swaps a series of elements in the given double 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>
@@ -2217,7 +2238,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element in the series to swap
@@ -2243,13 +2265,14 @@ public class ArrayUtils {
}
/**
- * <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.
- *
+ * Swaps a series of elements in the given float 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>
@@ -2258,14 +2281,15 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element in the series to swap
* @param len the number of elements to swap starting with the given indices
* @since 3.5
*/
- public static void swap(final float[] array, int offset1, int offset2, int len) {
+ public static void swap(final float[] array, int offset1, int offset2, int len) {
if (array == null || array.length == 0 || offset1 >= array.length || offset2 >= array.length) {
return;
}
@@ -2285,13 +2309,14 @@ public class ArrayUtils {
}
/**
- * <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.
- *
+ * Swaps a series of elements in the given int 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>
@@ -2300,7 +2325,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element in the series to swap
@@ -2326,13 +2352,14 @@ public class ArrayUtils {
}
/**
- * <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.
- *
+ * Swaps a series of elements in the given long 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>
@@ -2341,7 +2368,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element in the series to swap
@@ -2367,12 +2395,13 @@ public class ArrayUtils {
}
/**
- * <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.
+ * 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>
@@ -2382,7 +2411,8 @@ public class ArrayUtils {
* <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
* @param offset2 the index of the second element in the series to swap
@@ -2408,22 +2438,24 @@ public class ArrayUtils {
}
/**
- * <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>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>
- * </ul>
- *
+ * Swaps a series of elements in the given short 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>
+ * </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
* @param offset2 the index of the second element in the series to swap
[4/4] [lang] Better JavaDoc for ArrayUtils.shift variants
Posted by br...@apache.org.
Better JavaDoc for ArrayUtils.shift variants
Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/0bdeb204
Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/0bdeb204
Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/0bdeb204
Branch: refs/heads/master
Commit: 0bdeb204c880f13890719b102c9f22bc49a84a1c
Parents: ff8fd95
Author: Benedikt Ritter <br...@apache.org>
Authored: Sun Sep 11 15:22:14 2016 +0200
Committer: Benedikt Ritter <br...@apache.org>
Committed: Sun Sep 11 15:22:14 2016 +0200
----------------------------------------------------------------------
.../org/apache/commons/lang3/ArrayUtils.java | 142 +++++++++----------
1 file changed, 70 insertions(+), 72 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/0bdeb204/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 db6ce7b..9ed6441 100644
--- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java
+++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java
@@ -2486,11 +2486,10 @@ public class ArrayUtils {
// Shift
//-----------------------------------------------------------------------
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given array.
*
- * <p>There is no special handling for multi-dimensional arrays.
- *
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2506,9 +2505,10 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given long array.
*
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2524,9 +2524,10 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given int array.
*
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2542,9 +2543,10 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given short array.
*
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2560,9 +2562,10 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given char array.
*
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2578,9 +2581,10 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given byte array.
*
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2596,9 +2600,10 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given double array.
*
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2614,9 +2619,10 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given float array.
*
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2632,9 +2638,10 @@ public class ArrayUtils {
}
/**
- * <p>Shifts the order of the given array.
+ * Shifts the order of the given boolean array.
*
- * <p>This method does nothing for a {@code null} input array.
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array the array to shift, may be {@code null}
* @param offset
@@ -2650,11 +2657,10 @@ public class ArrayUtils {
}
/**
- * <p>
- * Shifts the order of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
+ * Shifts the order of a series of elements in the given boolean array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2711,11 +2717,10 @@ public class ArrayUtils {
}
/**
- * <p>
- * Shifts the order of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
+ * Shifts the order of a series of elements in the given byte array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
*
* @param array
* the array to shift, may be {@code null}
@@ -2772,12 +2777,11 @@ public class ArrayUtils {
}
/**
- * <p>
- * Shifts the order of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
- *
+ * Shifts the order of a series of elements in the given char array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
+ *
* @param array
* the array to shift, may be {@code null}
* @param startIndexInclusive
@@ -2833,12 +2837,11 @@ public class ArrayUtils {
}
/**
- * <p>
- * Shifts the order of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
- *
+ * Shifts the order of a series of elements in the given double array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
+ *
* @param array
* the array to shift, may be {@code null}
* @param startIndexInclusive
@@ -2894,12 +2897,11 @@ public class ArrayUtils {
}
/**
- * <p>
- * Shifts the order of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
- *
+ * Shifts the order of a series of elements in the given float array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
+ *
* @param array
* the array to shift, may be {@code null}
* @param startIndexInclusive
@@ -2955,12 +2957,11 @@ public class ArrayUtils {
}
/**
- * <p>
- * Shifts the order of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
- *
+ * Shifts the order of a series of elements in the given int array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
+ *
* @param array
* the array to shift, may be {@code null}
* @param startIndexInclusive
@@ -3016,12 +3017,11 @@ public class ArrayUtils {
}
/**
- * <p>
- * Shifts the order of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
- *
+ * Shifts the order of a series of elements in the given long array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
+ *
* @param array
* the array to shift, may be {@code null}
* @param startIndexInclusive
@@ -3077,12 +3077,11 @@ public class ArrayUtils {
}
/**
- * <p>
- * Shifts the order of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
- *
+ * Shifts the order of a series of elements in the given array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
+ *
* @param array
* the array to shift, may be {@code null}
* @param startIndexInclusive
@@ -3138,12 +3137,11 @@ public class ArrayUtils {
}
/**
- * <p>
- * Rotate the elements of the given array in the given range.
- *
- * <p>
- * This method does nothing for a {@code null} input array.
- *
+ * Shifts the order of a series of elements in the given short array.
+ *
+ * <p>There is no special handling for multi-dimensional arrays. This method
+ * does nothing for {@code null} or empty input arrays.</p>
+ *
* @param array
* the array to shift, may be {@code null}
* @param startIndexInclusive