From 47e20b35ebb90f75c83a413609c7a588038ef3be Mon Sep 17 00:00:00 2001
From: Shekhar Gulati <shekhargulati84@gmail.com>
Date: Mon, 9 May 2016 15:32:37 +0530
Subject: [PATCH] Added support for `ensureLeft` and its variants

---
 src/main/java/strman/Strman.java     | 28 ++++++++++++++++++++++++++++
 src/test/java/strman/StrmanTest.java | 17 +++++++++++++++++
 2 files changed, 45 insertions(+)

diff --git a/src/main/java/strman/Strman.java b/src/main/java/strman/Strman.java
index 765bc19..0eb981e 100644
--- a/src/main/java/strman/Strman.java
+++ b/src/main/java/strman/Strman.java
@@ -265,6 +265,34 @@ public abstract class Strman {
         return value.toLowerCase().indexOf(search.toLowerCase(), remainingLength) > -1;
     }
 
+    /**
+     * Ensures that the value begins with prefix. If it doesn't exist, it's prepended. It is case sensitive.
+     *
+     * @param value  input
+     * @param prefix prefix
+     * @return string with prefix if it was not present.
+     */
+    public static String ensureLeft(final String value, final String prefix) {
+        return ensureLeft(value, prefix, true);
+    }
+
+    /**
+     * Ensures that the value begins with prefix. If it doesn't exist, it's prepended.
+     *
+     * @param value         input
+     * @param prefix        prefix
+     * @param caseSensitive true or false
+     * @return string with prefix if it was not present.
+     */
+    public static String ensureLeft(final String value, final String prefix, final boolean caseSensitive) {
+        validate(value, NULL_STRING_PREDICATE, NULL_STRING_MSG_SUPPLIER);
+        if (caseSensitive) {
+            return value.startsWith(prefix) ? value : prefix + value;
+        }
+        String _value = value.toLowerCase();
+        String _prefix = prefix.toLowerCase();
+        return _value.startsWith(_prefix) ? value : prefix + value;
+    }
 
     private static long countSubstr(String value, String subStr, boolean allowOverlapping, long count) {
         int position = value.indexOf(subStr);
diff --git a/src/test/java/strman/StrmanTest.java b/src/test/java/strman/StrmanTest.java
index e9f56b4..5184094 100644
--- a/src/test/java/strman/StrmanTest.java
+++ b/src/test/java/strman/StrmanTest.java
@@ -230,4 +230,21 @@ public class StrmanTest {
         Arrays.stream(fixture).forEach(el -> assertTrue(endsWith(el, "BAR", el.length() - 1, false)));
     }
 
+    @Test
+    public void ensureLeft_shouldEnsureValueStartsWithFoo() throws Exception {
+        String[] fixture = {
+                "foobar",
+                "bar"
+        };
+
+        Arrays.stream(fixture).forEach(el -> assertThat(ensureLeft(el, "foo"), equalTo("foobar")));
+    }
+
+    @Test
+    public void ensureLeft_notCaseSensitive_shouldEnsureValueStartsWithFoo() throws Exception {
+        assertThat(ensureLeft("foobar", "FOO", false), equalTo("foobar"));
+        assertThat(ensureLeft("bar", "FOO", false), equalTo("FOObar"));
+    }
+
+
 }
\ No newline at end of file