• PythonLibraryReference, [http://www.python.org/doc/current/lib/module-re.html 4.2 re module]

• PythonLibraryReference, [http://www.python.org/doc/current/lib/re-syntax.html 4.2.1 Regular Expression Syntax]

Reference Diagrams

http://wiki.python.org/moin/RegularExpression?action=AttachFile&do=get&target=regex_characters.png

flags when compiling:

http://taoriver.net/img/for_pi/regex_flags.png

(All images PD, released by author, LionKimbro.)

Searching & Matching

You can search or match.

• search -- find something anywhere in the string, and return it

• match -- find something from the beginning of the string, and return it

You can also split on a pattern.

For example:

   1 import re
   2 split_up = re.split(r"(\(\([^)]+\)\))",
   3                     "This is a ((test)) of the ((emergency broadcasting station.))")

...which produces:

["This is a ", "((test))", " of the ", "((emergency broadcasting station.))" ]

Compiling

If you use a regex a lot, compile it first.

Consider:

   1 import re
   2 match_obj=re.match("<(.*?)>(.*?)</(.*?)>", "<h1>robot</h1>")
   3 print mo.groups()

...which outputs: ('h1', 'robot', 'h1')

If you were going to do that match a lot, you could compile it, like so:

   1 import re
   2 match_re=re.compile("<(.*?)>(.*?)</(.*?)>")
   3 match_obj=match_re.match("<h1>robot</h1>")
   4 print match_obj.groups()

...which yields the same result.

I don't know how much faster compiled forms are than non-compiled forms.

See Also

• [http://www.amk.ca/python/howto/regex/ Regular Expression HOWTO] - excellent Python-based regular expression tutorial, by [http://www.amk.ca/ A.M. Kuchling.]

• [http://gnosis.cx/TPiP/regex_patterns.gif Summary of Regular Expression Patterns] -- by DavidMertz

• [http://pythoncard.sourceforge.net/samples/redemo.html redemo tool] -- ships with Python (C:\\Python24\Tools\Scripts\redemo.py), indispensible when trying out regular expressions; ships with PythonCard as well

• [http://www.ozonehouse.com/mark/blog/code/PeriodicTable.pdf periodic table of PERL operators] -- for those who like visualization

• SVG source: [http://taoriver.net/img/for_pi/regex_characters.svg 1,] [http://taoriver.net/img/for_pi/regex_flags.svg 2.]

Discussion

Requests

• documentation on using re with ["Unicode"] ..?

Problem?

The following feature does not seems to work in python:

For example, the ICU regular expression provides the following patterns:

• \N{UNICODE CHARACTER NAME} Correspond au caractère nommé
• \p{UNICODE PROPERTY NAME} Correspond au carctère doté de la propriété Unicode spécifiée.
• \P{UNICODE PROPERTY NAME} Correspond au carctère non doté de la propriété Unicode spécifiée.
• \s Correspond à un caractère séparateur. un séparateur est définit comme [\t\n\f\r\p{Z}].
• \uhhhh Correspond à un caractère dont la valeur hexa est hhhh.
• \Uhhhhhhhh Correspond à un caractère dont la valeur hexa est hhhhhhhh. Exactement huit chiffres héxa doivent être fournis, même si le code point unicode le plus grand est \U0010ffff.

-- anonymous

I don't understand the problem. -- LionKimbro DateTime(2006-03-25T16:31:35Z)

Visualization

• I like the Venn diagram in this image. However, one part of the image is confusing. Where it refers to python strings, and "regex strings" (which are actually Python "raw" strings) and something called "match strings" ... what are these "match strings. -- JimD DateTime(2004-12-30T20:03:54Z)

The image isn't meant to be explanatory, it is meant to be reference and refreshing material.

That said: The "match string" is the final product of either of the two above expressions. It is what the above two expressions will literally match. If you have a better phrase, or would like to correct "raw" to "regex," feel free to download the SVG, edit the text, place an image on the web, and link it from here. (The damn [http://visual.wiki.taoriver.net/moin.cgi/LongImageIncorporationProcess LongImageIncorporationProcess] strikes again.) I may eventually get around to it myself one day, but it seems there are higher priorities, and the diagram is "good enough."

That said, I appreciate the correction. -- LionKimbro DateTime(2005-01-01T00:22:14Z)

Image Hosting

At the top of this page were two images/scehmes about re. Is it possible to redraw them here somehow? That server is not working, maybe someone has them dowloaded locally. Thanks a lot. -- PavelKosina

I've uploaded one as an attachment, still need to upload the other... And, the source...

(Anyone can do this, though, when the computers are online.)

-- LionKimbro DateTime(2006-03-25T16:31:35Z)