Fred Drake  committed b59ad4b

Document the finditer() function and method.
This closes SF bug #520904.

Explain that many of the escapes supported by string literals are also
supported by the RE compiler, and list which ones.
This closes SF bug #529923.

  • Participants
  • Parent commits 3f42163
  • Branches 2.2

Comments (0)

Files changed (1)

File Doc/lib/libre.tex

 \item[\code{\e Z}]Matches only at the end of the string.
-\item[\code{\e \e}] Matches a literal backslash.
+Most of the standard escapes supported by Python string literals are
+also accepted by the regular expression parser:
+\a      \b      \f      \n
+\r      \t      \v      \x
+Note that octal escapes are not included.  While the parser can
+attempt to determine whether a character is being specified by it's
+ordinal value expressed in octal, doing so yields an expression which
+is relatively difficult to maintain, as the same syntax is used to
+refer to numbered groups.
 \subsection{Matching vs. Searching \label{matching-searching}}
+\begin{funcdesc}{finditer}{pattern, string}
+  Return an iterator over all non-overlapping matches for the RE
+  \var{pattern} in \var{string}.  For each match, the iterator returns
+  a match object.  Empty matches are included in the result.
+  \versionadded{2.2}
 \begin{funcdesc}{sub}{pattern, repl, string\optional{, count}}
   Return the string obtained by replacing the leftmost non-overlapping
   occurrences of \var{pattern} in \var{string} by the replacement
 Identical to the \function{findall()} function, using the compiled pattern.
+Identical to the \function{finditer()} function, using the compiled pattern.
 \begin{methoddesc}[RegexObject]{sub}{repl, string\optional{, count\code{ = 0}}}
 Identical to the \function{sub()} function, using the compiled pattern.