add method for getting matched text

Author: mgramin

src/main/java/VerbalExpression.java

@@ -258,6 +258,15 @@ public boolean testExact(String toTest) {
     public boolean test(String toTest) {
         return Pattern.compile(this.pattern, this.modifiers).matcher(toTest).find();
     }
+    
+    public String getText(String toTest) {
+        Matcher m = Pattern.compile(this.pattern).matcher(toTest);
+        StringBuilder result = new StringBuilder();
+        while (m.find()){
+            result.append(m.group());
+        }
+        return result.toString();
+    }    
 
     public String toString() {
         return this.pattern.toString();

src/test/java/BasicFunctionalityUnitTests.java

@@ -1,6 +1,7 @@
 import org.junit.Test;
 import org.junit.Before;
 import org.junit.Ignore;
+
 import static org.junit.Assert.*;
 
 public class BasicFunctionalityUnitTests {
@@ -199,4 +200,16 @@ public void testSearchOneLine () {
       testString = "a\nb";
       assertTrue("b is on the second line but we are only searching the first", testRegex.test(testString));
    }
+   
+   
+   @Test
+   public void testGetText () {
+       String testString = "123 https://www.google.com 456";
+       VerbalExpression testRegex = new VerbalExpression().add("http")
+               .maybe("s").then("://").then("www.").anythingBut(" ")
+               .add("com");
+       assertEquals(testRegex.getText(testString), "https://www.google.com");
+       
+   }
+
 }