This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-lang.git
commit f1db09fe74ac40fd6f0ff2afa204ffa099ab45b5
Author: Gary Gregory <garydgreg...@gmail.com>
AuthorDate: Wed Mar 5 07:09:48 2025 -0500
Simplify wording
---
.../java/org/apache/commons/lang3/ArrayUtils.java | 104 ++++++++++-----------
1 file changed, 52 insertions(+), 52 deletions(-)
diff --git a/src/main/java/org/apache/commons/lang3/ArrayUtils.java
b/src/main/java/org/apache/commons/lang3/ArrayUtils.java
index 11c35f741..f811f73d0 100644
--- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java
+++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java
@@ -1561,7 +1561,7 @@ public static <T> T[] clone(final T[] array) {
* The method returns {@code false} if a {@code null} array is passed in.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param valueToFind the value to find
* @return {@code true} if the array contains the object
*/
@@ -1579,7 +1579,7 @@ public static boolean contains(final boolean[] array,
final boolean valueToFind)
* {@link Arrays#sort(byte[])} and {@link Arrays#binarySearch(byte[],
byte)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param valueToFind the value to find
* @return {@code true} if the array contains the object
*/
@@ -1597,7 +1597,7 @@ public static boolean contains(final byte[] array, final
byte valueToFind) {
* {@link Arrays#sort(char[])} and {@link Arrays#binarySearch(char[],
char)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param valueToFind the value to find
* @return {@code true} if the array contains the object
* @since 2.1
@@ -1616,7 +1616,7 @@ public static boolean contains(final char[] array, final
char valueToFind) {
* {@link Arrays#sort(double[])} and {@link Arrays#binarySearch(double[],
double)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param valueToFind the value to find
* @return {@code true} if the array contains the object
*/
@@ -1656,7 +1656,7 @@ public static boolean contains(final double[] array,
final double valueToFind, f
* {@link Arrays#sort(float[])} and {@link Arrays#binarySearch(float[],
float)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param valueToFind the value to find
* @return {@code true} if the array contains the object
*/
@@ -1674,7 +1674,7 @@ public static boolean contains(final float[] array, final
float valueToFind) {
* {@link Arrays#sort(int[])} and {@link Arrays#binarySearch(int[], int)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param valueToFind the value to find
* @return {@code true} if the array contains the object
*/
@@ -1692,7 +1692,7 @@ public static boolean contains(final int[] array, final
int valueToFind) {
* {@link Arrays#sort(long[])} and {@link Arrays#binarySearch(long[],
long)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param valueToFind the value to find
* @return {@code true} if the array contains the object
*/
@@ -1710,7 +1710,7 @@ public static boolean contains(final long[] array, final
long valueToFind) {
* {@link Arrays#sort(Object[], Comparator)} and {@link
Arrays#binarySearch(Object[], Object)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param objectToFind the object to find
* @return {@code true} if the array contains the object
*/
@@ -1728,7 +1728,7 @@ public static boolean contains(final Object[] array,
final Object objectToFind)
* {@link Arrays#sort(short[])} and {@link Arrays#binarySearch(short[],
short)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param valueToFind the value to find
* @return {@code true} if the array contains the object
*/
@@ -1746,7 +1746,7 @@ public static boolean contains(final short[] array, final
short valueToFind) {
* {@link Arrays#sort(int[])} and {@link Arrays#binarySearch(int[], int)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param objectsToFind any of the ints to find
* @return {@code true} if the array contains any of the ints
* @since 3.18.0
@@ -1765,7 +1765,7 @@ public static boolean containsAny(final int[] array,
final int... objectsToFind)
* {@link Arrays#sort(Object[], Comparator)} and {@link
Arrays#binarySearch(Object[], Object)}.
* </p>
*
- * @param array the array to search through
+ * @param array the array to search
* @param objectsToFind any of the objects to find
* @return {@code true} if the array contains any of the objects
* @since 3.13.0
@@ -1875,7 +1875,7 @@ public static int hashCode(final Object array) {
* This method returns an empty BitSet for a {@code null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return a BitSet of all the indices of the value within the array,
* an empty BitSet if not found or {@code null} array input
@@ -1895,7 +1895,7 @@ public static BitSet indexesOf(final boolean[] array,
final boolean valueToFind)
* length will return an empty BitSet ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return a BitSet of all the indices of the value within the array,
@@ -1924,7 +1924,7 @@ public static BitSet indexesOf(final boolean[] array,
final boolean valueToFind,
*
* <p>This method returns an empty BitSet for a {@code null} input
array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return a BitSet of all the indices of the value within the array,
* an empty BitSet if not found or {@code null} array input
@@ -1942,7 +1942,7 @@ public static BitSet indexesOf(final byte[] array, final
byte valueToFind) {
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return an empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return a BitSet of all the indices of the value within the array,
@@ -1971,7 +1971,7 @@ public static BitSet indexesOf(final byte[] array, final
byte valueToFind, int s
*
* <p>This method returns an empty BitSet for a {@code null} input
array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return a BitSet of all the indices of the value within the array,
* an empty BitSet if not found or {@code null} array input
@@ -1989,7 +1989,7 @@ public static BitSet indexesOf(final char[] array, final
char valueToFind) {
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return an empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return a BitSet of all the indices of the value within the array,
@@ -2017,7 +2017,7 @@ public static BitSet indexesOf(final char[] array, final
char valueToFind, int s
*
* <p>This method returns empty BitSet for a {@code null} input array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return a BitSet of all the indices of the value within the array,
* an empty BitSet if not found or {@code null} array input
@@ -2037,7 +2037,7 @@ public static BitSet indexesOf(final double[] array,
final double valueToFind) {
*
* <p>This method returns an empty BitSet for a {@code null} input
array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param tolerance tolerance of the search
* @return a BitSet of all the indices of the value within the array,
@@ -2056,7 +2056,7 @@ public static BitSet indexesOf(final double[] array,
final double valueToFind, f
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return an empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return a BitSet of the indices of the value within the array,
@@ -2092,7 +2092,7 @@ public static BitSet indexesOf(final double[] array,
final double valueToFind, i
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return an empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @param tolerance tolerance of the search
@@ -2121,7 +2121,7 @@ public static BitSet indexesOf(final double[] array,
final double valueToFind, i
*
* <p>This method returns an empty BitSet for a {@code null} input
array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return a BitSet of all the indices of the value within the array,
* an empty BitSet if not found or {@code null} array input
@@ -2139,7 +2139,7 @@ public static BitSet indexesOf(final float[] array, final
float valueToFind) {
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return a BitSet of all the indices of the value within the array,
@@ -2167,7 +2167,7 @@ public static BitSet indexesOf(final float[] array, final
float valueToFind, int
*
* <p>This method returns an empty BitSet for a {@code null} input
array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return a BitSet of all the indices of the value within the array,
* an empty BitSet if not found or {@code null} array input
@@ -2185,7 +2185,7 @@ public static BitSet indexesOf(final int[] array, final
int valueToFind) {
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return an empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return a BitSet of all the indices of the value within the array,
@@ -2214,7 +2214,7 @@ public static BitSet indexesOf(final int[] array, final
int valueToFind, int sta
*
* <p>This method returns an empty BitSet for a {@code null} input
array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return a BitSet of all the indices of the value within the array,
* an empty BitSet if not found or {@code null} array input
@@ -2232,7 +2232,7 @@ public static BitSet indexesOf(final long[] array, final
long valueToFind) {
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return an empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return a BitSet of all the indices of the value within the array,
@@ -2260,7 +2260,7 @@ public static BitSet indexesOf(final long[] array, final
long valueToFind, int s
*
* <p>This method returns an empty BitSet for a {@code null} input
array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param objectToFind the object to find, may be {@code null}
* @return a BitSet of all the indices of the object within the array,
* an empty BitSet if not found or {@code null} array input
@@ -2278,7 +2278,7 @@ public static BitSet indexesOf(final Object[] array,
final Object objectToFind)
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return an empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param objectToFind the object to find, may be {@code null}
* @param startIndex the index to start searching at
* @return a BitSet of all the indices of the object within the array
starting at the index,
@@ -2306,7 +2306,7 @@ public static BitSet indexesOf(final Object[] array,
final Object objectToFind,
*
* <p>This method returns an empty BitSet for a {@code null} input
array.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return a BitSet of all the indices of the value within the array,
* an empty BitSet if not found or {@code null} array input
@@ -2324,7 +2324,7 @@ public static BitSet indexesOf(final short[] array, final
short valueToFind) {
* <p>A negative startIndex is treated as zero. A startIndex larger than
the array
* length will return an empty BitSet.</p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return a BitSet of all the indices of the value within the array,
@@ -2353,7 +2353,7 @@ public static BitSet indexesOf(final short[] array, final
short valueToFind, int
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return the index of the value within the array,
* {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
array input
@@ -2372,7 +2372,7 @@ public static int indexOf(final boolean[] array, final
boolean valueToFind) {
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return the index of the value within the array,
@@ -2397,7 +2397,7 @@ public static int indexOf(final boolean[] array, final
boolean valueToFind, fina
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return the index of the value within the array,
* {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
array input
@@ -2416,7 +2416,7 @@ public static int indexOf(final byte[] array, final byte
valueToFind) {
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return the index of the value within the array,
@@ -2440,7 +2440,7 @@ public static int indexOf(final byte[] array, final byte
valueToFind, final int
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return the index of the value within the array,
* {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
array input
@@ -2460,7 +2460,7 @@ public static int indexOf(final char[] array, final char
valueToFind) {
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return the index of the value within the array,
@@ -2485,7 +2485,7 @@ public static int indexOf(final char[] array, final char
valueToFind, final int
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return the index of the value within the array,
* {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
array input
@@ -2502,7 +2502,7 @@ public static int indexOf(final double[] array, final
double valueToFind) {
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param tolerance tolerance of the search
* @return the index of the value within the array,
@@ -2522,7 +2522,7 @@ public static int indexOf(final double[] array, final
double valueToFind, final
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return the index of the value within the array,
@@ -2554,7 +2554,7 @@ public static int indexOf(final double[] array, final
double valueToFind, final
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @param tolerance tolerance of the search
@@ -2581,7 +2581,7 @@ public static int indexOf(final double[] array, final
double valueToFind, final
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return the index of the value within the array,
* {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
array input
@@ -2600,7 +2600,7 @@ public static int indexOf(final float[] array, final
float valueToFind) {
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return the index of the value within the array,
@@ -2626,7 +2626,7 @@ public static int indexOf(final float[] array, final
float valueToFind, final in
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return the index of the value within the array,
* {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
array input
@@ -2645,7 +2645,7 @@ public static int indexOf(final int[] array, final int
valueToFind) {
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return the index of the value within the array,
@@ -2669,7 +2669,7 @@ public static int indexOf(final int[] array, final int
valueToFind, final int st
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return the index of the value within the array, {@link
#INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
* array input
@@ -2688,7 +2688,7 @@ public static int indexOf(final long[] array, final long
valueToFind) {
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return the index of the value within the array,
@@ -2712,7 +2712,7 @@ public static int indexOf(final long[] array, final long
valueToFind, final int
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param objectToFind the object to find, may be {@code null}
* @return the index of the object within the array,
* {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
array input
@@ -2731,7 +2731,7 @@ public static int indexOf(final Object[] array, final
Object objectToFind) {
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param objectToFind the object to find, may be {@code null}
* @param startIndex the index to start searching at
* @return the index of the object within the array starting at the index,
@@ -2764,7 +2764,7 @@ public static int indexOf(final Object[] array, final
Object objectToFind, int s
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @return the index of the value within the array,
* {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null}
array input
@@ -2783,7 +2783,7 @@ public static int indexOf(final short[] array, final
short valueToFind) {
* length will return {@link #INDEX_NOT_FOUND} ({@code -1}).
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param startIndex the index to start searching at
* @return the index of the value within the array,
@@ -3960,7 +3960,7 @@ public static int lastIndexOf(final double[] array, final
double valueToFind) {
* This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code
null} input array.
* </p>
*
- * @param array the array to search through for the object, may be {@code
null}
+ * @param array the array to search for the object, may be {@code null}
* @param valueToFind the value to find
* @param tolerance tolerance of the search
* @return the index of the value within the array,
