Regex ReplaceAllIn

Note: Updated on Feb 13th for the newer API on Scala 2.8 trunk. (This is life on the bleeding edge, thanks Daniel).

A couple new methods have just been added to Scala 2.8 Regex. You will need to download a version of Scala 2.8 more recent than Scala2.8-Beta1.

The methods are related to replacing text using a regular expression and to say they are useful is an understatement. Lets take a look:

1. scala> val quote = """I don't like to commit myself about heaven and hell - you see, I have friends in both places. 
2.      | Mark Twain"""                                                                                                
3. quote: java.lang.String = 
4. I don't like to commit myself about heaven and hell - you see, I have friends in both places. 
5. Mark Twain
7. scala> val expr = "e".r    
8. expr: scala.util.matching.Regex = e
10. /* 
11. This first method is not new or is it interesting.  But the new methods are both related
12. so lets start with the basic form of replaceAllIn
13. */
14. scala> expr.replaceAllIn(quote, "**")
15. res1: String = 
16. I don't lik** to commit mys**lf about h**av**n and h**ll - you s****, I hav** fri**nds in both plac**s. 
17. Mark Twain
19. // this does the same thing
20. scala> quote.replaceAll("e","**")
21. res2: java.lang.String = 
22. I don't lik** to commit mys**lf about h**av**n and h**ll - you s****, I hav** fri**nds in both plac**s. 
23. Mark Twain
25. /*
26. Now things get interesting.  Using this form of replaceAllIn we can determine the replacement on a case by case basis.
28. It provides the Match object as the parameter so you have complete access to all 
29. the matched groups, the location of the match etc...
31. The method takes a Match => String function.  Very, very powerful.
32. */
33. scala> expr.replaceAllIn(quote, s => if(util.Random.nextBoolean) "?" else "*")
34. res5: String = 
35. I don't lik? to commit mys?lf about h?av?n and h?ll - you s*?, I hav? fri*nds in both plac*s. 
36. Mark Twain
38. /*
39. Another example using some of the matcher functionality
40. */
41. scala> expr.replaceAllIn(quote, m => m.start.toString)                        
42. res6: String = 
43. I don't lik11 to commit mys26lf about h37av40n and h48ll - you s5960, I hav68 fri73nds in both plac90s. 
44. Mark Twain
46. /*
47. Another crazy useful method is the replaceSomeIn.  It is similar to the replaceAllIn that takes a function except that the function in replaceSomeIn returns an Option.  If None then there is no replacement.  Otherwise a replacement is performed.  Very nice when dealing with complex regular expressions.
49. In this example we are replacing all 'e's start are before the 50th character in the string with -
50. */
51. scala> expr.replaceSomeIn(quote, m => if(m.start > 50) None else Some("-"))
52. res3: String = 
53. I don't lik- to commit mys-lf about h-av-n and h-ll - you see, I have friends in both places.
54. Mark Twain