Repository: commons-lang Updated Branches: refs/heads/master 09686fad4 -> 0807eedad
Make JavaDoc lint happy Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/0807eeda Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/0807eeda Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/0807eeda Branch: refs/heads/master Commit: 0807eedad6aa9544d90b2e7cec103fb9c40b714d Parents: 09686fa Author: Benedikt Ritter <brit...@apache.org> Authored: Mon Sep 19 13:21:06 2016 +0200 Committer: Benedikt Ritter <brit...@apache.org> Committed: Mon Sep 19 13:21:06 2016 +0200 ---------------------------------------------------------------------- .../org/apache/commons/lang3/ArrayUtils.java | 313 +++++++++---------- .../commons/lang3/reflect/MethodUtils.java | 1 + .../commons/lang3/time/FastDatePrinter.java | 7 + 3 files changed, 156 insertions(+), 165 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/commons-lang/blob/0807eeda/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 8aff5e5..59dcf9d 100644 --- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java +++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java @@ -1838,15 +1838,14 @@ public class ArrayUtils { * 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> - * <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> + * 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> + * </ul> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element to swap @@ -1861,21 +1860,21 @@ public class ArrayUtils { } /** - * <p>Swaps two elements in the given long array. + * Swaps two elements in the given long array. * * <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> - * <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> + * 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> + * </ul> + * * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element to swap @@ -1896,15 +1895,14 @@ public class ArrayUtils { * 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> - * <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> + * 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> + * </ul> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element to swap @@ -1925,16 +1923,15 @@ public class ArrayUtils { * 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> - * <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> - * + * 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> + * </ul> + * * @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 @@ -1954,15 +1951,14 @@ public class ArrayUtils { * 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> - * <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> + * 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> + * </ul> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element to swap @@ -1983,15 +1979,14 @@ public class ArrayUtils { * 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> - * <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> + * 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> + * </ul> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element to swap @@ -2012,15 +2007,14 @@ public class ArrayUtils { * 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> - * <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> + * 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> + * </ul> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element to swap @@ -2041,15 +2035,14 @@ public class ArrayUtils { * 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> - * <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> + * 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> + * </ul> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element to swap @@ -2070,15 +2063,14 @@ public class ArrayUtils { * 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> - * <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> + * 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> + * </ul> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element to swap @@ -2101,15 +2093,14 @@ public class ArrayUtils { * 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> - * </ul> - * </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> + * </ul> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap @@ -2144,15 +2135,14 @@ public class ArrayUtils { * 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> + * 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> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap @@ -2187,15 +2177,14 @@ public class ArrayUtils { * 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> + * 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> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap @@ -2229,16 +2218,15 @@ 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> - * <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> + * + * 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> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap @@ -2273,15 +2261,14 @@ public class ArrayUtils { * 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> + * 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> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap @@ -2317,15 +2304,14 @@ public class ArrayUtils { * 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> + * 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> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap @@ -2360,15 +2346,14 @@ public class ArrayUtils { * 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> + * 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> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap @@ -2403,15 +2388,14 @@ public class ArrayUtils { * 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> + * 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> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap @@ -2446,15 +2430,14 @@ public class ArrayUtils { * 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> + * 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> * * @param array the array to swap, may be {@code null} * @param offset1 the index of the first element in the series to swap http://git-wip-us.apache.org/repos/asf/commons-lang/blob/0807eeda/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java b/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java index 28bae66..3acbd73 100644 --- a/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java +++ b/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java @@ -159,6 +159,7 @@ public class MethodUtils { * </p> * * @param object invoke method on this object + * @param forceAccess force access to invoke method even if it's not accessible * @param methodName get method with this name * @param args use these arguments - treat null as empty array * @return The value returned by the invoked method http://git-wip-us.apache.org/repos/asf/commons-lang/blob/0807eeda/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 13a7899..ae184f2 100644 --- a/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java +++ b/src/main/java/org/apache/commons/lang3/time/FastDatePrinter.java @@ -544,6 +544,13 @@ public class FastDatePrinter implements DatePrinter, Serializable { } /** + * Performs the formatting by applying the rules to the + * specified calendar. + * + * @param calendar the calendar to format + * @param buf the buffer to format into + * @return the specified string buffer + * * @deprecated use {@link #format(Calendar)} or {@link #format(Calendar, Appendable)} */ @Deprecated
