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 <pascalschumac...@gmx.net> Authored: Wed Nov 30 21:55:24 2016 +0100 Committer: pascalschumacher <pascalschumac...@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) {