Rename methods in Regex. Add matchEntire method to match entire string against regex.

libraries/stdlib/test/text/RegexJVMTest.kt

@@ -1,17 +1,17 @@
 package test.text
 
 import kotlin.test.*
-import org.junit.Test as test
+import org.junit.Test
 
 
 class RegexJVMTest {
 
-    @test fun matchGroups() {
+    @Test fun matchGroups() {
         val input = "1a 2b 3c"
         val regex = "(\\d)(\\w)".toRegex()
 
-        val matches = regex.matchAll(input).toList()
-        assertTrue(matches.all { it.groups.size() == 3 })
+        val matches = regex.findAll(input).toList()
+        assertTrue(matches.all { it.groups.size == 3 })
         val m1 = matches[0]
         assertEquals("1a", m1.groups[0]?.value)
         assertEquals(0..1, m1.groups[0]?.range)

libraries/stdlib/test/text/RegexTest.kt

@@ -16,7 +16,7 @@ class RegexTest {
 
         assertTrue(p.hasMatch(input))
 
-        val first = p.match(input)
+        val first = p.find(input)
         assertTrue(first != null); first!!
         assertEquals("123", first.value)
 
@@ -26,7 +26,7 @@ class RegexTest {
         assertEquals("456", second1.value)
         assertEquals(second1.value, second2.value)
 
-        assertEquals("56", p.match(input, startIndex = 5)?.value)
+        assertEquals("56", p.find(input, startIndex = 5)?.value)
 
         val last = second1.next()!!
         assertEquals("789", last.value)
@@ -44,12 +44,12 @@ class RegexTest {
         val input = "123 456 789"
         val pattern = "\\d+".toRegex()
 
-        val matches = pattern.matchAll(input)
+        val matches = pattern.findAll(input)
         val values = matches.map { it.value }
         val expected = listOf("123", "456", "789")
         assertEquals(expected, values.toList())
         assertEquals(expected, values.toList(), "running match sequence second time")
-        assertEquals(expected.drop(1), pattern.matchAll(input, startIndex = 3).map { it.value }.toList())
+        assertEquals(expected.drop(1), pattern.findAll(input, startIndex = 3).map { it.value }.toList())
 
         assertEquals(listOf(0..2, 4..6, 8..10), matches.map { it.range }.toList())
     }
@@ -57,18 +57,18 @@ class RegexTest {
     @test fun matchAllSequence() {
         val input = "test"
         val pattern = ".*".toRegex()
-        val matches = pattern.matchAll(input).toList()
+        val matches = pattern.findAll(input).toList()
         assertEquals(input, matches[0].value)
         assertEquals(input, matches.joinToString("") { it.value })
-        assertEquals(2, matches.size())
+        assertEquals(2, matches.size)
     }
 
     @test fun matchGroups() {
         val input = "1a 2b 3c"
         val pattern = "(\\d)(\\w)".toRegex()
 
-        val matches = pattern.matchAll(input).toList()
-        assertTrue(matches.all { it.groups.size() == 3 })
+        val matches = pattern.findAll(input).toList()
+        assertTrue(matches.all { it.groups.size == 3 })
         val m1 = matches[0]
         assertEquals("1a", m1.groups[0]?.value)
         assertEquals("1", m1.groups[1]?.value)
@@ -82,23 +82,43 @@ class RegexTest {
     @test fun matchOptionalGroup() {
         val pattern = "(hi)|(bye)".toRegex(RegexOption.IGNORE_CASE)
 
-        val m1 = pattern.match("Hi!")!!
-        assertEquals(3, m1.groups.size())
+        val m1 = pattern.find("Hi!")!!
+        assertEquals(3, m1.groups.size)
         assertEquals("Hi", m1.groups[1]?.value)
         assertEquals(null, m1.groups[2])
 
-        val m2 = pattern.match("bye...")!!
-        assertEquals(3, m2.groups.size())
+        val m2 = pattern.find("bye...")!!
+        assertEquals(3, m2.groups.size)
         assertEquals(null, m2.groups[1])
         assertEquals("bye", m2.groups[2]?.value)
     }
 
     @test fun matchMultiline() {
         val regex = "^[a-z]*$".toRegex(setOf(RegexOption.IGNORE_CASE, RegexOption.MULTILINE))
-        val matchedValues = regex.matchAll("test\n\nLine").map { it.value }.toList()
+        val matchedValues = regex.findAll("test\n\nLine").map { it.value }.toList()
         assertEquals(listOf("test", "", "Line"), matchedValues)
     }
 
+
+    @test fun matchEntire() {
+        val regex = "(\\d)(\\w)".toRegex()
+
+        assertNull(regex.matchEntire("1a 2b"))
+        assertNotNull(regex.matchEntire("3c")) { m ->
+            assertEquals("3c", m.value)
+            assertEquals(3, m.groups.size)
+            assertEquals(listOf("3c", "3", "c"), m.groups.map { it!!.value })
+        }
+    }
+
+    @test fun matchEntireLazyQuantor() {
+        val regex = "a+b+?".toRegex()
+        val input = StringBuilder("aaaabbbb")
+
+        assertEquals("aaaab", regex.find(input)!!.value)
+        assertEquals("aaaabbbb", regex.matchEntire(input)!!.value)
+    }
+
     @test fun escapeLiteral() {
         val literal = """[-\/\\^$*+?.()|[\]{}]"""
         assertTrue(Regex.fromLiteral(literal).matches(literal))

libraries/stdlib/test/text/StringTest.kt

@@ -664,7 +664,7 @@ ${"    "}
         """.trimIndent()
 
         assertEquals(23, deindented.lines().size())
-        val indents = deindented.lines().map { "^\\s*".toRegex().match(it)!!.value.length }
+        val indents = deindented.lines().map { "^\\s*".toRegex().find(it)!!.value.length }
         assertEquals(0, indents.min())
         assertEquals(42, indents.max())
         assertEquals(1, deindented.lines().count { it.isEmpty() })