Repository: commons-lang Updated Branches: refs/heads/master 31a9fa0cc -> 3ce7f9eec
LANG-1293: Add StringUtils#isAllEmpty and #isAllBlank methods Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/6b9c3315 Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/6b9c3315 Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/6b9c3315 Branch: refs/heads/master Commit: 6b9c3315885f8f9e4be19db9ef05257035b97bca Parents: 31a9fa0 Author: Martin <tmartin...@gmail.com> Authored: Sun Dec 4 22:13:20 2016 +0100 Committer: pascalschumacher <pascalschumac...@gmx.net> Committed: Sun Mar 12 17:07:31 2017 +0100 ---------------------------------------------------------------------- .../org/apache/commons/lang3/StringUtils.java | 48 ++++++++++++++++++++ .../lang3/StringUtilsEmptyBlankTest.java | 29 ++++++++++++ 2 files changed, 77 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/commons-lang/blob/6b9c3315/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 63caeac..d91ad55 100644 --- a/src/main/java/org/apache/commons/lang3/StringUtils.java +++ b/src/main/java/org/apache/commons/lang3/StringUtils.java @@ -311,6 +311,29 @@ public class StringUtils { } /** + * <p>Checks if all of the CharSequences are empty ("") or null.</p> + * + * <pre> + * StringUtils.isAllEmpty(null) = true + * StringUtils.isAllEmpty(null, "") = true + * StringUtils.isAllEmpty(new String[] {}) = true + * StringUtils.isAllEmpty(null, "foo") = false + * StringUtils.isAllEmpty("", "bar") = false + * StringUtils.isAllEmpty("bob", "") = false + * StringUtils.isAllEmpty(" bob ", null) = false + * StringUtils.isAllEmpty(" ", "bar") = false + * StringUtils.isAllEmpty("foo", "bar") = false + * </pre> + * + * @param css the CharSequences to check, may be null or empty + * @return {@code true} if all of the CharSequences are empty or null + * @since 3.6 + */ + public static boolean isAllEmpty(final CharSequence... css) { + return !isAnyNotEmpty(css); + } + + /** * <p>Checks if a CharSequence is empty (""), null or whitespace only.</p> * * <p>Whitespace is defined by {@link Character#isWhitespace(char)}.</p> @@ -455,6 +478,31 @@ public class StringUtils { return !isAnyBlank(css); } + /** + * <p>Checks if all of the CharSequences are empty (""), null or whitespace only.</p> + * + * </p>Whitespace is defined by {@link Character#isWhitespace(char)}.</p> + * + * <pre> + * StringUtils.isAllBlank(null) = true + * StringUtils.isAllBlank(null, "foo") = false + * StringUtils.isAllBlank(null, null) = true + * StringUtils.isAllBlank("", "bar") = false + * StringUtils.isAllBlank("bob", "") = false + * StringUtils.isAllBlank(" bob ", null) = false + * StringUtils.isAllBlank(" ", "bar") = false + * StringUtils.isAllBlank("foo", "bar") = false + * StringUtils.isAllBlank(new String[] {}) = true + * </pre> + * + * @param css the CharSequences to check, may be null or empty + * @return {@code true} if all of the CharSequences are empty or null or whitespace only + * @since 3.6 + */ + public static boolean isAllBlank(final CharSequence... css) { + return !isAnyNotBlank(css); + } + // Trim //----------------------------------------------------------------------- /** http://git-wip-us.apache.org/repos/asf/commons-lang/blob/6b9c3315/src/test/java/org/apache/commons/lang3/StringUtilsEmptyBlankTest.java ---------------------------------------------------------------------- diff --git a/src/test/java/org/apache/commons/lang3/StringUtilsEmptyBlankTest.java b/src/test/java/org/apache/commons/lang3/StringUtilsEmptyBlankTest.java index 769a138..b04d0da 100644 --- a/src/test/java/org/apache/commons/lang3/StringUtilsEmptyBlankTest.java +++ b/src/test/java/org/apache/commons/lang3/StringUtilsEmptyBlankTest.java @@ -82,6 +82,21 @@ public class StringUtilsEmptyBlankTest { } @Test + public void testIsAllEmpty() { + assertTrue(StringUtils.isAllEmpty()); + assertTrue(StringUtils.isAllEmpty(new String[]{})); + assertTrue(StringUtils.isAllEmpty((String) null)); + assertTrue(StringUtils.isAllEmpty((String[]) null)); + assertFalse(StringUtils.isAllEmpty(null, "foo")); + assertFalse(StringUtils.isAllEmpty("", "bar")); + assertFalse(StringUtils.isAllEmpty("bob", "")); + assertFalse(StringUtils.isAllEmpty(" bob ", null)); + assertFalse(StringUtils.isAllEmpty(" ", "bar")); + assertFalse(StringUtils.isAllEmpty("foo", "bar")); + assertTrue(StringUtils.isAllEmpty("", null)); + } + + @Test public void testIsBlank() { assertTrue(StringUtils.isBlank(null)); assertTrue(StringUtils.isBlank("")); @@ -137,4 +152,18 @@ public class StringUtilsEmptyBlankTest { assertFalse(StringUtils.isNoneBlank(" ", "bar")); assertTrue(StringUtils.isNoneBlank("foo", "bar")); } + + @Test + public void testIsAllBlank() { + assertTrue(StringUtils.isAllBlank((String) null)); + assertTrue(StringUtils.isAllBlank((String[]) null)); + assertTrue(StringUtils.isAllBlank(null, null)); + assertTrue(StringUtils.isAllBlank(null, " ")); + assertFalse(StringUtils.isAllBlank(null, "foo")); + assertFalse(StringUtils.isAllBlank("", "bar")); + assertFalse(StringUtils.isAllBlank("bob", "")); + assertFalse(StringUtils.isAllBlank(" bob ", null)); + assertFalse(StringUtils.isAllBlank(" ", "bar")); + assertFalse(StringUtils.isAllBlank("foo", "bar")); + } }