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
The following commit(s) were added to refs/heads/master by this push:
new 1c1d6e90d Javadoc: Normalize some varargs examples
new 371f8c7a7 Merge branch 'master' of
https://[email protected]/apache/commons-lang.git
1c1d6e90d is described below
commit 1c1d6e90d006c3cccec3acd10d0cef59e650ca6a
Author: Gary Gregory <[email protected]>
AuthorDate: Wed Dec 24 08:43:16 2025 -0500
Javadoc: Normalize some varargs examples
---
.../java/org/apache/commons/lang3/StringUtils.java | 74 +++++++++++-----------
1 file changed, 37 insertions(+), 37 deletions(-)
diff --git a/src/main/java/org/apache/commons/lang3/StringUtils.java
b/src/main/java/org/apache/commons/lang3/StringUtils.java
index 185675324..1fe0be0d1 100644
--- a/src/main/java/org/apache/commons/lang3/StringUtils.java
+++ b/src/main/java/org/apache/commons/lang3/StringUtils.java
@@ -1031,10 +1031,10 @@ public static boolean contains(final CharSequence seq,
final int searchChar) {
* StringUtils.containsAny("", *) = false
* StringUtils.containsAny(*, null) = false
* StringUtils.containsAny(*, []) = false
- * StringUtils.containsAny("zzabyycdxx", ['z', 'a']) = true
- * StringUtils.containsAny("zzabyycdxx", ['b', 'y']) = true
- * StringUtils.containsAny("zzabyycdxx", ['z', 'y']) = true
- * StringUtils.containsAny("aba", ['z']) = false
+ * StringUtils.containsAny("zzabyycdxx", 'z', 'a') = true
+ * StringUtils.containsAny("zzabyycdxx", 'b', 'y') = true
+ * StringUtils.containsAny("zzabyycdxx", 'z', 'y') = true
+ * StringUtils.containsAny("aba", 'z]) = false
* </pre>
*
* @param cs the CharSequence to check, may be null.
@@ -1198,13 +1198,13 @@ public static boolean containsIgnoreCase(final
CharSequence str, final CharSeque
* </p>
*
* <pre>
- * StringUtils.containsNone(null, *) = true
- * StringUtils.containsNone(*, null) = true
- * StringUtils.containsNone("", *) = true
- * StringUtils.containsNone("ab", '') = true
- * StringUtils.containsNone("abab", 'xyz') = true
- * StringUtils.containsNone("ab1", 'xyz') = true
- * StringUtils.containsNone("abz", 'xyz') = false
+ * StringUtils.containsNone(null, *) = true
+ * StringUtils.containsNone(*, null) = true
+ * StringUtils.containsNone("", *) = true
+ * StringUtils.containsNone("ab", '') = true
+ * StringUtils.containsNone("abab", 'x', 'y', 'z') = true
+ * StringUtils.containsNone("ab1", 'x', 'y', 'z') = true
+ * StringUtils.containsNone("abz", 'x', 'y', 'z') = false
* </pre>
*
* @param cs the CharSequence to check, may be null.
@@ -1274,13 +1274,13 @@ public static boolean containsNone(final CharSequence
cs, final String invalidCh
* </p>
*
* <pre>
- * StringUtils.containsOnly(null, *) = false
- * StringUtils.containsOnly(*, null) = false
- * StringUtils.containsOnly("", *) = true
- * StringUtils.containsOnly("ab", '') = false
- * StringUtils.containsOnly("abab", 'abc') = true
- * StringUtils.containsOnly("ab1", 'abc') = false
- * StringUtils.containsOnly("abz", 'abc') = false
+ * StringUtils.containsOnly(null, *) = false
+ * StringUtils.containsOnly(*, null) = false
+ * StringUtils.containsOnly("", *) = true
+ * StringUtils.containsOnly("ab", '') = false
+ * StringUtils.containsOnly("abab", 'a', 'b', 'c') = true
+ * StringUtils.containsOnly("ab1", 'a', 'b', 'c') = false
+ * StringUtils.containsOnly("abz", 'a', 'b', 'c') = false
* </pre>
*
* @param cs the String to check, may be null.
@@ -2696,9 +2696,9 @@ public static int indexOf(final CharSequence seq, final
int searchChar, final in
* StringUtils.indexOfAny("", *) = -1
* StringUtils.indexOfAny(*, null) = -1
* StringUtils.indexOfAny(*, []) = -1
- * StringUtils.indexOfAny("zzabyycdxx", ['z', 'a']) = 0
- * StringUtils.indexOfAny("zzabyycdxx", ['b', 'y']) = 3
- * StringUtils.indexOfAny("aba", ['z']) = -1
+ * StringUtils.indexOfAny("zzabyycdxx", 'z', 'a') = 0
+ * StringUtils.indexOfAny("zzabyycdxx", 'b', 'y') = 3
+ * StringUtils.indexOfAny("aba", 'z') = -1
* </pre>
*
* @param cs the CharSequence to check, may be null.
@@ -2721,16 +2721,16 @@ public static int indexOfAny(final CharSequence cs,
final char... searchChars) {
* </p>
*
* <pre>
- * StringUtils.indexOfAny(null, *) = -1
- * StringUtils.indexOfAny(*, null) = -1
- * StringUtils.indexOfAny(*, []) = -1
- * StringUtils.indexOfAny("zzabyycdxx", ["ab", "cd"]) = 2
- * StringUtils.indexOfAny("zzabyycdxx", ["cd", "ab"]) = 2
- * StringUtils.indexOfAny("zzabyycdxx", ["mn", "op"]) = -1
- * StringUtils.indexOfAny("zzabyycdxx", ["zab", "aby"]) = 1
- * StringUtils.indexOfAny("zzabyycdxx", [""]) = 0
- * StringUtils.indexOfAny("", [""]) = 0
- * StringUtils.indexOfAny("", ["a"]) = -1
+ * StringUtils.indexOfAny(null, *) = -1
+ * StringUtils.indexOfAny(*, null) = -1
+ * StringUtils.indexOfAny(*, []) = -1
+ * StringUtils.indexOfAny("zzabyycdxx", "ab", "cd") = 2
+ * StringUtils.indexOfAny("zzabyycdxx", "cd", "ab") = 2
+ * StringUtils.indexOfAny("zzabyycdxx", "mn", "op") = -1
+ * StringUtils.indexOfAny("zzabyycdxx", "zab", "aby") = 1
+ * StringUtils.indexOfAny("zzabyycdxx", "") = 0
+ * StringUtils.indexOfAny("", "") = 0
+ * StringUtils.indexOfAny("", "a") = -1
* </pre>
*
* @param str the CharSequence to check, may be null.
@@ -4687,8 +4687,8 @@ public static String join(final short[] array, final char
delimiter, final int s
* StringUtils.join(null) = null
* StringUtils.join([]) = ""
* StringUtils.join([null]) = ""
- * StringUtils.join(["a", "b", "c"]) = "abc"
- * StringUtils.join([null, "", "a"]) = "a"
+ * StringUtils.join("a", "b", "c") = "abc"
+ * StringUtils.join(null, "", "a") = "a"
* </pre>
*
* @param <T> the specific type of values to join together.
@@ -4710,10 +4710,10 @@ public static <T> String join(final T... elements) {
* </p>
*
* <pre>
- * StringUtils.joinWith(",", {"a", "b"}) = "a,b"
- * StringUtils.joinWith(",", {"a", "b",""}) = "a,b,"
- * StringUtils.joinWith(",", {"a", null, "b"}) = "a,,b"
- * StringUtils.joinWith(null, {"a", "b"}) = "ab"
+ * StringUtils.joinWith(",", "a", "b") = "a,b"
+ * StringUtils.joinWith(",", "a", "b","") = "a,b,"
+ * StringUtils.joinWith(",", "a", null, "b") = "a,,b"
+ * StringUtils.joinWith(null, "a", "b") = "ab"
* </pre>
*
* @param delimiter the separator character to use, null treated as "".
