You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by pa...@apache.org on 2016/11/30 20:55:35 UTC
[lang] StringUtils improve is*Empty and is*Blank javadoc
Repository: commons-lang
Updated Branches:
refs/heads/master 82d76aca8 -> 1b362986b
StringUtils improve is*Empty and is*Blank javadoc
Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/1b362986
Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/1b362986
Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/1b362986
Branch: refs/heads/master
Commit: 1b362986bc99c04941d046ebb36e19c370435b1f
Parents: 82d76ac
Author: pascalschumacher <pa...@gmx.net>
Authored: Wed Nov 30 21:55:24 2016 +0100
Committer: pascalschumacher <pa...@gmx.net>
Committed: Wed Nov 30 21:55:24 2016 +0100
----------------------------------------------------------------------
.../org/apache/commons/lang3/StringUtils.java | 29 ++++++++++++--------
1 file changed, 17 insertions(+), 12 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-lang/blob/1b362986/src/main/java/org/apache/commons/lang3/StringUtils.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/StringUtils.java b/src/main/java/org/apache/commons/lang3/StringUtils.java
index 3154162..4183c8b 100644
--- a/src/main/java/org/apache/commons/lang3/StringUtils.java
+++ b/src/main/java/org/apache/commons/lang3/StringUtils.java
@@ -230,7 +230,7 @@ public class StringUtils {
}
/**
- * <p>Checks if any one of the CharSequences are empty ("") or null.</p>
+ * <p>Checks if any of the CharSequences are empty ("") or null.</p>
*
* <pre>
* StringUtils.isAnyEmpty(null) = true
@@ -259,10 +259,11 @@ public class StringUtils {
}
/**
- * <p>Checks if any one of the CharSequences are not empty ("") or null.</p>
+ * <p>Checks if any of the CharSequences are not empty ("") and not null.</p>
*
* <pre>
* StringUtils.isAnyNotEmpty(null) = false
+ * StringUtils.isAnyNotEmpty(new String[] {}) = false
* StringUtils.isAnyNotEmpty(null, "foo") = true
* StringUtils.isAnyNotEmpty("", "bar") = true
* StringUtils.isAnyNotEmpty("bob", "") = true
@@ -272,7 +273,7 @@ public class StringUtils {
* </pre>
*
* @param css the CharSequences to check, may be null or empty
- * @return {@code true} if any of the CharSequences are not empty or null
+ * @return {@code true} if any of the CharSequences are not empty and not null
* @since 3.6
*/
public static boolean isAnyNotEmpty(final CharSequence... css) {
@@ -296,6 +297,7 @@ public class StringUtils {
* StringUtils.isNoneEmpty("", "bar") = false
* StringUtils.isNoneEmpty("bob", "") = false
* StringUtils.isNoneEmpty(" bob ", null) = false
+ * StringUtils.isNoneEmpty(new String[] {}) = false
* StringUtils.isNoneEmpty(" ", "bar") = true
* StringUtils.isNoneEmpty("foo", "bar") = true
* </pre>
@@ -309,7 +311,7 @@ public class StringUtils {
}
/**
- * <p>Checks if a CharSequence is whitespace, empty ("") or null.</p>
+ * <p>Checks if a CharSequence is empty (""), null or whitespace only.</p>
*
* </p>Whitespace is defined by {@link Character#isWhitespace(char)}.</p>
*
@@ -322,7 +324,7 @@ public class StringUtils {
* </pre>
*
* @param cs the CharSequence to check, may be null
- * @return {@code true} if the CharSequence is null, empty or whitespace
+ * @return {@code true} if the CharSequence is null, empty or whitespace only
* @since 2.0
* @since 3.0 Changed signature from isBlank(String) to isBlank(CharSequence)
*/
@@ -354,7 +356,7 @@ public class StringUtils {
*
* @param cs the CharSequence to check, may be null
* @return {@code true} if the CharSequence is
- * not empty and not null and not whitespace
+ * not empty and not null and not whitespace only
* @since 2.0
* @since 3.0 Changed signature from isNotBlank(String) to isNotBlank(CharSequence)
*/
@@ -363,7 +365,7 @@ public class StringUtils {
}
/**
- * <p>Checks if any one of the CharSequences are blank ("") or null and not whitespace only.</p>
+ * <p>Checks if any of the CharSequences are empty ("") or null or whitespace only.</p>
*
* </p>Whitespace is defined by {@link Character#isWhitespace(char)}.</p>
*
@@ -375,11 +377,12 @@ public class StringUtils {
* StringUtils.isAnyBlank("bob", "") = true
* StringUtils.isAnyBlank(" bob ", null) = true
* StringUtils.isAnyBlank(" ", "bar") = true
+ * StringUtils.isAnyBlank(new String[] {}) = false
* StringUtils.isAnyBlank("foo", "bar") = false
* </pre>
*
* @param css the CharSequences to check, may be null or empty
- * @return {@code true} if any of the CharSequences are blank or null or whitespace only
+ * @return {@code true} if any of the CharSequences are empty or null or whitespace only
* @since 3.2
*/
public static boolean isAnyBlank(final CharSequence... css) {
@@ -395,7 +398,7 @@ public class StringUtils {
}
/**
- * <p>Checks if any one of the CharSequences are not blank ("") or null and not whitespace only.</p>
+ * <p>Checks if any of the CharSequences are not empty (""), not null and not whitespace only.</p>
*
* </p>Whitespace is defined by {@link Character#isWhitespace(char)}.</p>
*
@@ -408,10 +411,11 @@ public class StringUtils {
* StringUtils.isAnyNotBlank(" bob ", null) = true
* StringUtils.isAnyNotBlank(" ", "bar") = true
* StringUtils.isAnyNotBlank("foo", "bar") = false
+ * StringUtils.isAnyNotBlank(new String[] {}) = false
* </pre>
*
* @param css the CharSequences to check, may be null or empty
- * @return {@code true} if any of the CharSequences are not blank or null or whitespace only
+ * @return {@code true} if any of the CharSequences are not empty and not null and not whitespace only
* @since 3.6
*/
public static boolean isAnyNotBlank(final CharSequence... css) {
@@ -427,7 +431,7 @@ public class StringUtils {
}
/**
- * <p>Checks if none of the CharSequences are blank ("") or null and whitespace only.</p>
+ * <p>Checks if none of the CharSequences are empty (""), null or whitespace only.</p>
*
* </p>Whitespace is defined by {@link Character#isWhitespace(char)}.</p>
*
@@ -439,11 +443,12 @@ public class StringUtils {
* StringUtils.isNoneBlank("bob", "") = false
* StringUtils.isNoneBlank(" bob ", null) = false
* StringUtils.isNoneBlank(" ", "bar") = false
+ * StringUtils.isNoneBlank(new String[] {}) = false
* StringUtils.isNoneBlank("foo", "bar") = true
* </pre>
*
* @param css the CharSequences to check, may be null or empty
- * @return {@code true} if none of the CharSequences are blank or null or whitespace only
+ * @return {@code true} if none of the CharSequences are empty or null or whitespace only
* @since 3.2
*/
public static boolean isNoneBlank(final CharSequence... css) {