[Py-howto-checkins] CVS: pyhowto regex.tex,1.16,1.17

[A.M. K. <aku...@us...>]

Update of /cvsroot/py-howto/pyhowto
In directory sc8-pr-cvs1:/tmp/cvs-serv7696

Modified Files:
	regex.tex 
Log Message:
Describe findall() and finditer(); bump version number

Index: regex.tex
===================================================================
RCS file: /cvsroot/py-howto/pyhowto/regex.tex,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -r1.16 -r1.17
*** regex.tex	6 Apr 2003 23:35:20 -0000	1.16
--- regex.tex	7 Apr 2003 19:51:23 -0000	1.17
***************
*** 3,7 ****
  % TODO:
  % Document lookbehind assertions
- % Add section on findall, finditer methods
  % Better way of displaying a RE, a string, and what it matches
  % Mention optional argument to match.groups()
--- 3,6 ----
***************
*** 10,14 ****
  \title{Regular Expression HOWTO}
  
! \release{0.04}
  
  \author{A.M. Kuchling}
--- 9,13 ----
  \title{Regular Expression HOWTO}
  
! \release{0.05}
  
  \author{A.M. Kuchling}
***************
*** 465,468 ****
--- 464,494 ----
  \end{verbatim}
  
+ Two \class{RegexObject} methods return all of the matches for a pattern.
+ \method{findall()} returns a list of matching strings:
+ 
+ \begin{verbatim}
+ >>> p = re.compile('\d+')
+ >>> p.findall('12 drummers drumming, 11 pipers piping, 10 lords a-leaping')
+ ['12', '11', '10']
+ \end{verbatim}
+ 
+ \method{findall()} has to create the entire list before it can be
+ returned as the result.  In Python 2.2, the \method{finditer()} method
+ is also available, returning a sequence of \class{MatchObject} instances 
+ as an iterator.
+ 
+ \begin{verbatim}
+ >>> iterator = p.finditer('12 drummers drumming, 11 ... 10 ...')
+ >>> iterator
+ <callable-iterator object at 0x401833ac>
+ >>> for match in iterator:
+ ...     print match.span()
+ ...
+ (0, 2)
+ (22, 24)
+ (29, 31)
+ \end{verbatim}
+ 
+ 
  \subsection{Module-Level Functions}
  
***************
*** 1372,1376 ****
  HTML or XML parser module for such tasks.)
  
! \subsection{Not using re.VERBOSE}
  
  By now you've probably noticed that regular expressions are a very
--- 1398,1402 ----
  HTML or XML parser module for such tasks.)
  
! \subsection{Not Using re.VERBOSE}
  
  By now you've probably noticed that regular expressions are a very