Added support for containsAny function

shekhargulati · shekhargulati · commit b24a5ebbf204 · 2016-05-06T15:40:47.000+05:30
diff --git a/README.md b/README.md
@@ -103,8 +103,16 @@ Verifies that all needles are contained in value.
  // result = false
 ```
 
+## containsAny(value, needles, caseSensitive)
    
+Verifies that one or more of needles are contained in value.
 
+```java
+String title = "foo bar";
+String needles = ["foo", "bar", "test"];
+String result = containsAny(title, needles, true);
+// result = true 
+```
 
 ## Other functions that can be added
 
diff --git a/src/main/java/strman/Strman.java b/src/main/java/strman/Strman.java
@@ -151,11 +151,11 @@ static boolean contains(final String value, final String needle, final boolean c
     /**
      * Verifies that all needles are contained in value. The search is case insensitive
      *
-     * @param value         input String to search
-     * @param needles       needles to find
+     * @param value   input String to search
+     * @param needles needles to find
      * @return true if all needles are found else false.
      */
-    static boolean containsAll(String value, String[] needles) {
+    static boolean containsAll(final String value, final String[] needles) {
         validate(value, NULL_STRING_PREDICATE, NULL_STRING_MSG_SUPPLIER);
         return Arrays.stream(needles).allMatch(needle -> contains(value, needle, false));
     }
@@ -168,8 +168,17 @@ static boolean containsAll(String value, String[] needles) {
      * @param caseSensitive true or false
      * @return true if all needles are found else false.
      */
-    static boolean containsAll(String value, String[] needles, boolean caseSensitive) {
+    static boolean containsAll(final String value, final String[] needles, final boolean caseSensitive) {
         validate(value, NULL_STRING_PREDICATE, NULL_STRING_MSG_SUPPLIER);
         return Arrays.stream(needles).allMatch(needle -> contains(value, needle, caseSensitive));
     }
+
+    static boolean containsAny(final String value, final String[] needles) {
+        return containsAny(value, needles, false);
+    }
+
+    static boolean containsAny(final String value, final String[] needles, final boolean caseSensitive) {
+        validate(value, NULL_STRING_PREDICATE, NULL_STRING_MSG_SUPPLIER);
+        return Arrays.stream(needles).anyMatch(needle -> contains(value, needle, caseSensitive));
+    }
 }
diff --git a/src/test/java/strman/StrmanTest.java b/src/test/java/strman/StrmanTest.java
@@ -124,8 +124,26 @@ public void containsAll_shouldReturnFalseOnlyWhenAllNeedlesAreNotContainedInValu
                 "bar foo",
                 "foobar",
         };
-
         Arrays.stream(fixture).forEach(el -> assertFalse(containsAll(el, new String[]{"FOO", "bar"}, true)));
     }
 
+    @Test
+    public void containsAny_shouldReturnTrueWhenAnyOfSearchNeedleExistInInputValue() throws Exception {
+        String[] fixture = {
+                "foo bar",
+                "bar foo",
+                "foobar",
+        };
+        Arrays.stream(fixture).forEach(el -> assertTrue(containsAny(el, new String[]{"foo", "bar", "test"})));
+    }
+
+    @Test
+    public void containsAny_shouldReturnFalseWhenNoneOfSearchNeedleExistInInputValue() throws Exception {
+        String[] fixture = {
+                "foo bar",
+                "bar foo",
+                "foobar",
+        };
+        Arrays.stream(fixture).forEach(el -> assertFalse(containsAny(el, new String[]{"FOO", "BAR", "Test"}, true)));
+    }
 }
