Merge pull request #50 from redwerk/javadoc_for_textgroups

added javadoc and test for 'getTextGroups'

Author: lanwen

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

@@ -750,6 +750,12 @@ public String getText(final String toTest, final int group) {
 
     /**
      * Extract exact group from string and add it to list
+     * 
+     * Example:
+     * String text = "SampleHelloWorldString";
+     * VerbalExpression regex = regex().capt().oneOf("Hello", "World").endCapt().maybe("String").build();
+     * list = regex.getTextGroups(text, 0) //result: "Hello", "WorldString"
+     * list = regex.getTextGroups(text, 1) //result: "Hello", "World"
      *
      * @param toTest - string to extract from
      * @param group  - group to extract

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

@@ -611,20 +611,22 @@ public void shouldAddMaybeWithOneOfFromAnotherBuilder() {
 
     @Test
     public void testListOfTextGroups() {
-        String text = "abczbcayyy";
+        String text = "SampleHelloWorldString";
         VerbalExpression regex = regex()
-                .capture()
-                .oneOf("abc", "bca", "yyy")
+                .capt()
+                .oneOf("Hello", "World")
+                .endCapt()
+                .maybe("String")
                 .build();
 
-        List<String> groups = regex.getTextGroups(text, 1);
+        List<String> groups0 = regex.getTextGroups(text, 0);
 
-        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));
+        assertThat(groups0.get(0), equalTo("Hello"));
+        assertThat(groups0.get(1), equalTo("WorldString"));
+
+        List<String> groups1 = regex.getTextGroups(text, 1);
+
+        assertThat(groups1.get(0), equalTo("Hello"));
+        assertThat(groups1.get(1), equalTo("World"));
     }
 }