Case Insensitive Java Regular Expressions - How Did I Miss That!?!
As you all know, in ColdFusion, when you want to do a find or replace with no case sensitivity, you just append "NoCase" to the method call. We have all used:
- FindNoCase()
- REFindNoCase()
- ReplaceNoCase()
- REReplaceNoCase()
As you well know (if you follow my blog), I am a huge fan of using the Java String methods for regular expression find and manipulation. The problem with that though is that there is no "NoCase" type methods built into the Java string (except for String::equalsIgnoreCase(), but that doesn't use regular expressions). I thought the only way to work around this was to either put all characters in regular expression (ie [a-zA-Z]), but it turns out there is a flag for performing a case-insensitive search:
(?i)
How did I miss that? I have been doing regular expressions for a long time now and this one has escaped me. Crazy! But, it's so awesome. You just put the flag (?i) in your regular expression and everything to the right of it will be case-insensitive:
<!--- Set string value. --->
<cfset strText = "Libby is FUNNY" />
<!--- Check case-sensitive match. --->
#strText.Matches( "[a-z ]+" )#
<!--- Check case-INsensitive match. --->
#strText.Matches( "(?i)[a-z ]+" )#
The first method outputs NO... the second method outputs YES. How freakin' cool is that. You can even perform case insensitive sub-strings:
<!--- Only allow case-INsensitivity on LIBBY and FUNNY. --->
#strText.Matches( "(?i:libby)[a-z ]+(?i:funny)" )#
This also outputs YES.
So anyway, that's pretty freakin' cool! I don't know how I missed that when learning Regular Expressions, but now that I know, it is sooo on.
Oh, and just be careful. This is only for JAVA regular expressions. If you try to use this type of notation in ColdFusion method calls, it will throw an error:
Malformed regular expression "(?i:libby)[a-z ]+(?i:funny)". Reason: Sequence (?:...) not recognized.
... Just another reason I am huge fan of using the underlying Java methods.
Want to use code from this post? Check out the license.
Reader Comments
So what exactly are the benefits of using the Java string classes? Is it just a performance issue?
It can be a performance issue, but it's also a utility issues. As I describe above, the regular expression methods used on the Java string class:
String::Matches()
String::ReplaceFirst()
String::ReplaceAll()
... allow for much more powerful AND faster regular expressions. Those methods can handle all the look behinds (negative and possitive) which I don't think ColdFusion can handle at all. That means that they can do much more than things like:
REFind()
REReplace()
So, it's speed, but it's also flexability.
If (?i) and (?i:regex) works, (?-i) might also work, which with some regex libraries turns off case insensitivity for the remainder of the regular expression, e.g.: (?i)libby(?-i)[a-z]
Other things to test, which work with some libraries:
(?s) / (?-s) : Turn on/off dot matches newline.
(?m) / (?-m) : Turn on/off caret and dollar match after and before newlines.
If those work, you should also be able to do, e.g., (?i-sm) to turn on "i" and "m", but turn off "s" for the remainder of the regex.
BTW, is there anything that needs to be done beyond what you show in your example code to make the Java methods available? Having extended regex functionality available to me in ColdFusion (particularly lookbehinds) has been a dream.
Steve,
You know more about regular expressions than I do. I have not tried using (nor did I know about) flags that would turn off previous flags. As far as I know though, CFMX6/7 is running on top of Java 1.4.2 or something, so theoretically, anything that works in that edition of Java will run in ColdFusion (when using the underlying Java methods).
Try searching my site for ReplaceAll() and ReplaceFirst() which are the two main java RegEx string methods that I use:
www.bennadel.com/search/replaceall%20replacefirst
You also might want to search for Split(). Also another great Java String method:
www.bennadel.com/search/split(
Other than that, I am sure once you figure out the methods calls, you seem to know the nuts and bolts of the regex stuff better than I do, you will do great. You will also find that Java Regular expressions are NICE AND FAST.
Also, you might want to search for pattern / matcher:
www.bennadel.com/search/util.regex
Let me know if there is anything I can help with.
Thanks for the leads, Ben!
Trust me, once you go underlying Java string methods... you never go back.
I tried to implement this in the following way
if (s1.indexOf((?i)s2) >= 0)
Where s1 and s2 are string variables. Trying to get an if statement that worked if s1 contained s2 anywhere in it and then perform a loop.
I fought with it for awhile and gave up.
Any thought why this did not work (what syntax did I get wrong?).
Thanks,
bg
@Brian,
I am not sure what you are trying to do? Can you explain a bit more?
This is great!!! Thanks for the tip!
Slighly off-topic, using a reg. expression and the replaceAll function, can you replace only whole words, eg. if I wanted to replace all "and" with "xyz", but only if "and" is not part of another word, as in "hand"?
@Firoz,
Yeah, you just have to use word boundaries: \b
\band\b
... will get "and" only when its a whole word.
Thanks. Very useful information.
Hi! It doesn't work with accents … :/
Try: Águia
I consider this a bug.
Do you know some workaround?
@Leandro,
What doesn't work with accents? I am not sure what you are trying to do?
class DontWorkWithAccent {
public static void main(String[] args) {
String str = "Águia";
str = str.replaceAll("(?i)[á]", "a");
System.out.println(str);
str = str.replaceAll("(?i)[Á]", "a");
System.out.println(str);
}
}
@Leandro,
Hmmm, interesting. I know you can use hex-based values in the regular expression. Example:
[^\x7F]
... so I know it can handle any character at some level. I wonder why this is not working as a standard character class.
Have a way to make a replaceAll in Java equivalent this maked in PHP (http://bit.ly/bZilOh):
word >a href="word"<word>/word<word word
to
repl >a href="word"<repl>/word<repl repl
note thats only "word"s outside a tag are replaced
@Celso,
In the link you gave me, it looks like they are using a negative look-ahead to confirm that they are not inside a tag. Java definitely supports the negative look-ahead, and I pretty sure that ColdFusion also supports them (I believe it is the look-behinds that ColdFusion doesn't support).
Awesome..!! Thanks for sharing. You made my day.
Very very very awesome !!!
I like it!
Seriously, I'm frustrated to don't know that rather!
I always wanted to use regex simplier in CF.
The traditional RE[..]() are too limited compared to java methods so generally I use your component, PaternMatcher.cfc (it's very useful!)!
Thanks for your tip Ben!
Did you have make an entry that reassemble all java methods hidden in native CF objects ? As this trick up above.
Thanks a bunch! This is great info even though I've never used ColdFusion. :)
@Brian,
I know this is really (I mean really) late respons to Brian but... This page was high up on the Google search for "java matcher case insensitive" so I figure others will get here too and maybe wonder about the same thing.
String.indexOf does not use regular expressions so you can't do the magic of (?i) in a parameter to indexOf. So even if you had correct java syntax, it wouldn't work.
Freakin' cool!! Thanks
@Leandro,
The (?i) is documented as working with US-ASCII characters. If you want to work with Unicode characters then you need to use (?iu):
String str = "Águia";
str = str.replaceAll("(?iu)[á]", "a");
http://docs.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html#CASE_INSENSITIVE
@Keith Starsmeare
Thank you.