Merge pull request #42 from redwerk/improvement#28

Added list of matching groups #28

Author: lanwen

src/main/java/ru/lanwen/verbalregex/VerbalExpression.java

@@ -2,6 +2,8 @@
 
 import static java.lang.String.valueOf;
 
+import java.util.ArrayList;
+import java.util.List;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
@@ -746,6 +748,21 @@ public String getText(final String toTest, final int group) {
         return result.toString();
     }
 
+    /**
+     * Extract exact group from string and add it to list
+     *
+     * @param toTest - string to extract from
+     * @param group  - group to extract
+     * @return list of extracted groups
+     */
+    public List<String> getTextGroups(final String toTest, final int group) {
+        List<String> groups = new ArrayList<>();
+        Matcher m = pattern.matcher(toTest);
+        while (m.find()) {
+            groups.add(m.group(group));
+        }
+        return groups;
+    }
 
     @Override
     public String toString() {

src/test/java/ru/lanwen/verbalregex/BasicFunctionalityUnitTest.java

@@ -2,6 +2,8 @@
 
 import org.junit.Test;
 
+import java.util.List;
+
 import static org.hamcrest.CoreMatchers.*;
 import static org.junit.Assert.*;
 import static ru.lanwen.verbalregex.VerbalExpression.regex;
@@ -606,4 +608,23 @@ public void shouldAddMaybeWithOneOfFromAnotherBuilder() {
 	assertThat("Is a name without prefix", name, matchesTo("James"));
 
     }
+    
+    @Test
+    public void testListOfTextGroups() {
+        String text = "abczbcayyy";
+        VerbalExpression regex = regex()
+                .capture()
+                .oneOf("abc", "bca", "yyy")
+                .build();
+        
+        List<String> groups = regex.getTextGroups(text, 1);
+
+        assertThat(groups.get(0), equalTo("abc"));
+        assertThat(groups.get(1), equalTo("bca"));
+        assertThat(groups.get(2), equalTo("yyy"));
+        
+        String concatenatedText = groups.get(0) + groups.get(1) + groups.get(2);
+        
+        assertThat(regex.getText(text, 1), equalTo(concatenatedText));
+    }
 }