PageRenderTime 64ms CodeModel.GetById 32ms RepoModel.GetById 0ms app.codeStats 0ms

/docs/re-pysrc.html

https://github.com/adamldoyle/mixins
HTML | 427 lines | 417 code | 5 blank | 5 comment | 0 complexity | 385d7278485f7de3acda6254a1cbfc57 MD5 | raw file

Large files files are truncated, but you can click here to view the full file

  1. <?xml version="1.0" encoding="ascii"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  3. "DTD/xhtml1-transitional.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  5. <head>
  6. <title>re</title>
  7. <link rel="stylesheet" href="epydoc.css" type="text/css" />
  8. <script type="text/javascript" src="epydoc.js"></script>
  9. </head>
  10. <body bgcolor="white" text="black" link="blue" vlink="#204080"
  11. alink="#204080">
  12. <!-- ==================== NAVIGATION BAR ==================== -->
  13. <table class="navbar" border="0" width="100%" cellpadding="0"
  14. bgcolor="#a0c0ff" cellspacing="0">
  15. <tr valign="middle">
  16. <!-- Tree link -->
  17. <th>&nbsp;&nbsp;&nbsp;<a
  18. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  19. <!-- Index link -->
  20. <th>&nbsp;&nbsp;&nbsp;<a
  21. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  22. <!-- Help link -->
  23. <th>&nbsp;&nbsp;&nbsp;<a
  24. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  25. <th class="navbar" width="100%"></th>
  26. </tr>
  27. </table>
  28. <table width="100%" cellpadding="0" cellspacing="0">
  29. <tr valign="top">
  30. <td width="100%">
  31. <span class="breadcrumbs">
  32. Module&nbsp;re
  33. </span>
  34. </td>
  35. <td>
  36. <table cellpadding="0" cellspacing="0">
  37. <!-- hide/show private -->
  38. <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
  39. onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
  40. <tr><td align="right"><span class="options"
  41. >[<a href="frames.html" target="_top">frames</a
  42. >]&nbsp;|&nbsp;<a href="re-pysrc.html"
  43. target="_top">no&nbsp;frames</a>]</span></td></tr>
  44. </table>
  45. </td>
  46. </tr>
  47. </table>
  48. <h1 class="epydoc">Source Code for <a href="re-module.html">Module re</a></h1>
  49. <pre class="py-src">
  50. <a name="L1"></a><tt class="py-lineno"> 1</tt> <tt class="py-line"><tt class="py-comment">#</tt> </tt>
  51. <a name="L2"></a><tt class="py-lineno"> 2</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Secret Labs' Regular Expression Engine</tt> </tt>
  52. <a name="L3"></a><tt class="py-lineno"> 3</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt>
  53. <a name="L4"></a><tt class="py-lineno"> 4</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># re-compatible interface for the sre matching engine</tt> </tt>
  54. <a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt>
  55. <a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Copyright (c) 1998-2001 by Secret Labs AB. All rights reserved.</tt> </tt>
  56. <a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt>
  57. <a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># This version of the SRE library can be redistributed under CNRI's</tt> </tt>
  58. <a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Python 1.6 license. For any other use, please contact Secret Labs</tt> </tt>
  59. <a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># AB (info@pythonware.com).</tt> </tt>
  60. <a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt>
  61. <a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Portions of this engine have been developed in cooperation with</tt> </tt>
  62. <a name="L13"></a><tt class="py-lineno"> 13</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># CNRI. Hewlett-Packard provided funding for 1.6 integration and</tt> </tt>
  63. <a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># other compatibility work.</tt> </tt>
  64. <a name="L15"></a><tt class="py-lineno"> 15</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt>
  65. <a name="L16"></a><tt class="py-lineno"> 16</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt>
  66. <a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"><tt class="py-docstring">r"""Support for regular expressions (RE).</tt> </tt>
  67. <a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  68. <a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"><tt class="py-docstring">This module provides regular expression matching operations similar to</tt> </tt>
  69. <a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"><tt class="py-docstring">those found in Perl. It supports both 8-bit and Unicode strings; both</tt> </tt>
  70. <a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line"><tt class="py-docstring">the pattern and the strings being processed can contain null bytes and</tt> </tt>
  71. <a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"><tt class="py-docstring">characters outside the US ASCII range.</tt> </tt>
  72. <a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  73. <a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"><tt class="py-docstring">Regular expressions can contain both special and ordinary characters.</tt> </tt>
  74. <a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"><tt class="py-docstring">Most ordinary characters, like "A", "a", or "0", are the simplest</tt> </tt>
  75. <a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"><tt class="py-docstring">regular expressions; they simply match themselves. You can</tt> </tt>
  76. <a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"><tt class="py-docstring">concatenate ordinary characters, so last matches the string 'last'.</tt> </tt>
  77. <a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  78. <a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-docstring">The special characters are:</tt> </tt>
  79. <a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"><tt class="py-docstring"> "." Matches any character except a newline.</tt> </tt>
  80. <a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"><tt class="py-docstring"> "^" Matches the start of the string.</tt> </tt>
  81. <a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"><tt class="py-docstring"> "$" Matches the end of the string or just before the newline at</tt> </tt>
  82. <a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"><tt class="py-docstring"> the end of the string.</tt> </tt>
  83. <a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"><tt class="py-docstring"> "*" Matches 0 or more (greedy) repetitions of the preceding RE.</tt> </tt>
  84. <a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"><tt class="py-docstring"> Greedy means that it will match as many repetitions as possible.</tt> </tt>
  85. <a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"><tt class="py-docstring"> "+" Matches 1 or more (greedy) repetitions of the preceding RE.</tt> </tt>
  86. <a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"><tt class="py-docstring"> "?" Matches 0 or 1 (greedy) of the preceding RE.</tt> </tt>
  87. <a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"><tt class="py-docstring"> *?,+?,?? Non-greedy versions of the previous three special characters.</tt> </tt>
  88. <a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"><tt class="py-docstring"> {m,n} Matches from m to n repetitions of the preceding RE.</tt> </tt>
  89. <a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"><tt class="py-docstring"> {m,n}? Non-greedy version of the above.</tt> </tt>
  90. <a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"><tt class="py-docstring"> "\\" Either escapes special characters or signals a special sequence.</tt> </tt>
  91. <a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"><tt class="py-docstring"> [] Indicates a set of characters.</tt> </tt>
  92. <a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"><tt class="py-docstring"> A "^" as the first character indicates a complementing set.</tt> </tt>
  93. <a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"><tt class="py-docstring"> "|" A|B, creates an RE that will match either A or B.</tt> </tt>
  94. <a name="L45"></a><tt class="py-lineno"> 45</tt> <tt class="py-line"><tt class="py-docstring"> (...) Matches the RE inside the parentheses.</tt> </tt>
  95. <a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"><tt class="py-docstring"> The contents can be retrieved or matched later in the string.</tt> </tt>
  96. <a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"><tt class="py-docstring"> (?iLmsux) Set the I, L, M, S, U, or X flag for the RE (see below).</tt> </tt>
  97. <a name="L48"></a><tt class="py-lineno"> 48</tt> <tt class="py-line"><tt class="py-docstring"> (?:...) Non-grouping version of regular parentheses.</tt> </tt>
  98. <a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"><tt class="py-docstring"> (?P&lt;name&gt;...) The substring matched by the group is accessible by name.</tt> </tt>
  99. <a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"><tt class="py-docstring"> (?P=name) Matches the text matched earlier by the group named name.</tt> </tt>
  100. <a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"><tt class="py-docstring"> (?#...) A comment; ignored.</tt> </tt>
  101. <a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"><tt class="py-docstring"> (?=...) Matches if ... matches next, but doesn't consume the string.</tt> </tt>
  102. <a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"><tt class="py-docstring"> (?!...) Matches if ... doesn't match next.</tt> </tt>
  103. <a name="L54"></a><tt class="py-lineno"> 54</tt> <tt class="py-line"><tt class="py-docstring"> (?&lt;=...) Matches if preceded by ... (must be fixed length).</tt> </tt>
  104. <a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"><tt class="py-docstring"> (?&lt;!...) Matches if not preceded by ... (must be fixed length).</tt> </tt>
  105. <a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"><tt class="py-docstring"> (?(id/name)yes|no) Matches yes pattern if the group with id/name matched,</tt> </tt>
  106. <a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"><tt class="py-docstring"> the (optional) no pattern otherwise.</tt> </tt>
  107. <a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  108. <a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"><tt class="py-docstring">The special sequences consist of "\\" and a character from the list</tt> </tt>
  109. <a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"><tt class="py-docstring">below. If the ordinary character is not on the list, then the</tt> </tt>
  110. <a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"><tt class="py-docstring">resulting RE will match the second character.</tt> </tt>
  111. <a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"><tt class="py-docstring"> \number Matches the contents of the group of the same number.</tt> </tt>
  112. <a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"><tt class="py-docstring"> \A Matches only at the start of the string.</tt> </tt>
  113. <a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"><tt class="py-docstring"> \Z Matches only at the end of the string.</tt> </tt>
  114. <a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"><tt class="py-docstring"> \b Matches the empty string, but only at the start or end of a word.</tt> </tt>
  115. <a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"><tt class="py-docstring"> \B Matches the empty string, but not at the start or end of a word.</tt> </tt>
  116. <a name="L67"></a><tt class="py-lineno"> 67</tt> <tt class="py-line"><tt class="py-docstring"> \d Matches any decimal digit; equivalent to the set [0-9].</tt> </tt>
  117. <a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"><tt class="py-docstring"> \D Matches any non-digit character; equivalent to the set [^0-9].</tt> </tt>
  118. <a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"><tt class="py-docstring"> \s Matches any whitespace character; equivalent to [ \t\n\r\f\v].</tt> </tt>
  119. <a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"><tt class="py-docstring"> \S Matches any non-whitespace character; equiv. to [^ \t\n\r\f\v].</tt> </tt>
  120. <a name="L71"></a><tt class="py-lineno"> 71</tt> <tt class="py-line"><tt class="py-docstring"> \w Matches any alphanumeric character; equivalent to [a-zA-Z0-9_].</tt> </tt>
  121. <a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"><tt class="py-docstring"> With LOCALE, it will match the set [0-9_] plus characters defined</tt> </tt>
  122. <a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"><tt class="py-docstring"> as letters for the current locale.</tt> </tt>
  123. <a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"><tt class="py-docstring"> \W Matches the complement of \w.</tt> </tt>
  124. <a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"><tt class="py-docstring"> \\ Matches a literal backslash.</tt> </tt>
  125. <a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  126. <a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"><tt class="py-docstring">This module exports the following functions:</tt> </tt>
  127. <a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"><tt class="py-docstring"> match Match a regular expression pattern to the beginning of a string.</tt> </tt>
  128. <a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"><tt class="py-docstring"> search Search a string for the presence of a pattern.</tt> </tt>
  129. <a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"><tt class="py-docstring"> sub Substitute occurrences of a pattern found in a string.</tt> </tt>
  130. <a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"><tt class="py-docstring"> subn Same as sub, but also return the number of substitutions made.</tt> </tt>
  131. <a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"><tt class="py-docstring"> split Split a string by the occurrences of a pattern.</tt> </tt>
  132. <a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"><tt class="py-docstring"> findall Find all occurrences of a pattern in a string.</tt> </tt>
  133. <a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"><tt class="py-docstring"> finditer Return an iterator yielding a match object for each match.</tt> </tt>
  134. <a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"><tt class="py-docstring"> compile Compile a pattern into a RegexObject.</tt> </tt>
  135. <a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"><tt class="py-docstring"> purge Clear the regular expression cache.</tt> </tt>
  136. <a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"><tt class="py-docstring"> escape Backslash all non-alphanumerics in a string.</tt> </tt>
  137. <a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  138. <a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"><tt class="py-docstring">Some of the functions in this module takes flags as optional parameters:</tt> </tt>
  139. <a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"><tt class="py-docstring"> I IGNORECASE Perform case-insensitive matching.</tt> </tt>
  140. <a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"><tt class="py-docstring"> L LOCALE Make \w, \W, \b, \B, dependent on the current locale.</tt> </tt>
  141. <a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"><tt class="py-docstring"> M MULTILINE "^" matches the beginning of lines (after a newline)</tt> </tt>
  142. <a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"><tt class="py-docstring"> as well as the string.</tt> </tt>
  143. <a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"><tt class="py-docstring"> "$" matches the end of lines (before a newline) as well</tt> </tt>
  144. <a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"><tt class="py-docstring"> as the end of the string.</tt> </tt>
  145. <a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"><tt class="py-docstring"> S DOTALL "." matches any character at all, including the newline.</tt> </tt>
  146. <a name="L97"></a><tt class="py-lineno"> 97</tt> <tt class="py-line"><tt class="py-docstring"> X VERBOSE Ignore whitespace and comments for nicer looking RE's.</tt> </tt>
  147. <a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"><tt class="py-docstring"> U UNICODE Make \w, \W, \b, \B, dependent on the Unicode locale.</tt> </tt>
  148. <a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  149. <a name="L100"></a><tt class="py-lineno">100</tt> <tt class="py-line"><tt class="py-docstring">This module also defines an exception 'error'.</tt> </tt>
  150. <a name="L101"></a><tt class="py-lineno">101</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  151. <a name="L102"></a><tt class="py-lineno">102</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
  152. <a name="L103"></a><tt class="py-lineno">103</tt> <tt class="py-line"> </tt>
  153. <a name="L104"></a><tt class="py-lineno">104</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">sys</tt> </tt>
  154. <a name="L105"></a><tt class="py-lineno">105</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">sre_compile</tt> </tt>
  155. <a name="L106"></a><tt class="py-lineno">106</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">sre_parse</tt> </tt>
  156. <a name="L107"></a><tt class="py-lineno">107</tt> <tt class="py-line"> </tt>
  157. <a name="L108"></a><tt class="py-lineno">108</tt> <tt class="py-line"><tt class="py-comment"># public symbols</tt> </tt>
  158. <a name="L109"></a><tt class="py-lineno">109</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-name">__all__</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt> <tt class="py-string">"match"</tt><tt class="py-op">,</tt> <tt class="py-string">"search"</tt><tt class="py-op">,</tt> <tt class="py-string">"sub"</tt><tt class="py-op">,</tt> <tt class="py-string">"subn"</tt><tt class="py-op">,</tt> <tt class="py-string">"split"</tt><tt class="py-op">,</tt> <tt class="py-string">"findall"</tt><tt class="py-op">,</tt> </tt>
  159. <a name="L110"></a><tt class="py-lineno">110</tt> <tt class="py-line"> <tt class="py-string">"compile"</tt><tt class="py-op">,</tt> <tt class="py-string">"purge"</tt><tt class="py-op">,</tt> <tt class="py-string">"template"</tt><tt class="py-op">,</tt> <tt class="py-string">"escape"</tt><tt class="py-op">,</tt> <tt class="py-string">"I"</tt><tt class="py-op">,</tt> <tt class="py-string">"L"</tt><tt class="py-op">,</tt> <tt class="py-string">"M"</tt><tt class="py-op">,</tt> <tt class="py-string">"S"</tt><tt class="py-op">,</tt> <tt class="py-string">"X"</tt><tt class="py-op">,</tt> </tt>
  160. <a name="L111"></a><tt class="py-lineno">111</tt> <tt class="py-line"> <tt class="py-string">"U"</tt><tt class="py-op">,</tt> <tt class="py-string">"IGNORECASE"</tt><tt class="py-op">,</tt> <tt class="py-string">"LOCALE"</tt><tt class="py-op">,</tt> <tt class="py-string">"MULTILINE"</tt><tt class="py-op">,</tt> <tt class="py-string">"DOTALL"</tt><tt class="py-op">,</tt> <tt class="py-string">"VERBOSE"</tt><tt class="py-op">,</tt> </tt>
  161. <a name="L112"></a><tt class="py-lineno">112</tt> <tt class="py-line"> <tt class="py-string">"UNICODE"</tt><tt class="py-op">,</tt> <tt class="py-string">"error"</tt> <tt class="py-op">]</tt> </tt>
  162. <a name="L113"></a><tt class="py-lineno">113</tt> <tt class="py-line"> </tt>
  163. <a name="L114"></a><tt class="py-lineno">114</tt> <tt class="py-line"><tt class="py-name">__version__</tt> <tt class="py-op">=</tt> <tt class="py-string">"2.2.1"</tt> </tt>
  164. <a name="L115"></a><tt class="py-lineno">115</tt> <tt class="py-line"> </tt>
  165. <a name="L116"></a><tt class="py-lineno">116</tt> <tt class="py-line"><tt class="py-comment"># flags</tt> </tt>
  166. <a name="L117"></a><tt class="py-lineno">117</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-0" class="py-name" targets="Variable re.I=re-module.html#I"><a title="re.I" class="py-name" href="#" onclick="return doclink('link-0', 'I', 'link-0');">I</a></tt> <tt class="py-op">=</tt> <tt id="link-1" class="py-name" targets="Variable re.IGNORECASE=re-module.html#IGNORECASE"><a title="re.IGNORECASE" class="py-name" href="#" onclick="return doclink('link-1', 'IGNORECASE', 'link-1');">IGNORECASE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt class="py-name">SRE_FLAG_IGNORECASE</tt> <tt class="py-comment"># ignore case</tt> </tt>
  167. <a name="L118"></a><tt class="py-lineno">118</tt> <tt class="py-line"><tt id="link-2" class="py-name" targets="Variable re.L=re-module.html#L"><a title="re.L" class="py-name" href="#" onclick="return doclink('link-2', 'L', 'link-2');">L</a></tt> <tt class="py-op">=</tt> <tt id="link-3" class="py-name" targets="Variable re.LOCALE=re-module.html#LOCALE"><a title="re.LOCALE" class="py-name" href="#" onclick="return doclink('link-3', 'LOCALE', 'link-3');">LOCALE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt class="py-name">SRE_FLAG_LOCALE</tt> <tt class="py-comment"># assume current 8-bit locale</tt> </tt>
  168. <a name="L119"></a><tt class="py-lineno">119</tt> <tt class="py-line"><tt id="link-4" class="py-name" targets="Variable re.U=re-module.html#U"><a title="re.U" class="py-name" href="#" onclick="return doclink('link-4', 'U', 'link-4');">U</a></tt> <tt class="py-op">=</tt> <tt id="link-5" class="py-name" targets="Variable re.UNICODE=re-module.html#UNICODE"><a title="re.UNICODE" class="py-name" href="#" onclick="return doclink('link-5', 'UNICODE', 'link-5');">UNICODE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt class="py-name">SRE_FLAG_UNICODE</tt> <tt class="py-comment"># assume unicode locale</tt> </tt>
  169. <a name="L120"></a><tt class="py-lineno">120</tt> <tt class="py-line"><tt id="link-6" class="py-name" targets="Variable re.M=re-module.html#M"><a title="re.M" class="py-name" href="#" onclick="return doclink('link-6', 'M', 'link-6');">M</a></tt> <tt class="py-op">=</tt> <tt id="link-7" class="py-name" targets="Variable re.MULTILINE=re-module.html#MULTILINE"><a title="re.MULTILINE" class="py-name" href="#" onclick="return doclink('link-7', 'MULTILINE', 'link-7');">MULTILINE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt class="py-name">SRE_FLAG_MULTILINE</tt> <tt class="py-comment"># make anchors look for newline</tt> </tt>
  170. <a name="L121"></a><tt class="py-lineno">121</tt> <tt class="py-line"><tt id="link-8" class="py-name" targets="Variable re.S=re-module.html#S"><a title="re.S" class="py-name" href="#" onclick="return doclink('link-8', 'S', 'link-8');">S</a></tt> <tt class="py-op">=</tt> <tt id="link-9" class="py-name" targets="Variable re.DOTALL=re-module.html#DOTALL"><a title="re.DOTALL" class="py-name" href="#" onclick="return doclink('link-9', 'DOTALL', 'link-9');">DOTALL</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt class="py-name">SRE_FLAG_DOTALL</tt> <tt class="py-comment"># make dot match newline</tt> </tt>
  171. <a name="L122"></a><tt class="py-lineno">122</tt> <tt class="py-line"><tt id="link-10" class="py-name" targets="Variable re.X=re-module.html#X"><a title="re.X" class="py-name" href="#" onclick="return doclink('link-10', 'X', 'link-10');">X</a></tt> <tt class="py-op">=</tt> <tt id="link-11" class="py-name" targets="Variable re.VERBOSE=re-module.html#VERBOSE"><a title="re.VERBOSE" class="py-name" href="#" onclick="return doclink('link-11', 'VERBOSE', 'link-11');">VERBOSE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt class="py-name">SRE_FLAG_VERBOSE</tt> <tt class="py-comment"># ignore whitespace and comments</tt> </tt>
  172. <a name="L123"></a><tt class="py-lineno">123</tt> <tt class="py-line"> </tt>
  173. <a name="L124"></a><tt class="py-lineno">124</tt> <tt class="py-line"><tt class="py-comment"># sre extensions (experimental, don't rely on these)</tt> </tt>
  174. <a name="L125"></a><tt class="py-lineno">125</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-12" class="py-name" targets="Variable re.T=re-module.html#T"><a title="re.T" class="py-name" href="#" onclick="return doclink('link-12', 'T', 'link-12');">T</a></tt> <tt class="py-op">=</tt> <tt id="link-13" class="py-name" targets="Variable re.TEMPLATE=re-module.html#TEMPLATE"><a title="re.TEMPLATE" class="py-name" href="#" onclick="return doclink('link-13', 'TEMPLATE', 'link-13');">TEMPLATE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt class="py-name">SRE_FLAG_TEMPLATE</tt> <tt class="py-comment"># disable backtracking</tt> </tt>
  175. <a name="L126"></a><tt class="py-lineno">126</tt> <tt class="py-line"><tt id="link-14" class="py-name" targets="Variable re.DEBUG=re-module.html#DEBUG"><a title="re.DEBUG" class="py-name" href="#" onclick="return doclink('link-14', 'DEBUG', 'link-14');">DEBUG</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt class="py-name">SRE_FLAG_DEBUG</tt> <tt class="py-comment"># dump pattern after compilation</tt> </tt>
  176. <a name="L127"></a><tt class="py-lineno">127</tt> <tt class="py-line"> </tt>
  177. <a name="L128"></a><tt class="py-lineno">128</tt> <tt class="py-line"><tt class="py-comment"># sre exception</tt> </tt>
  178. <a name="L129"></a><tt class="py-lineno">129</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-15" class="py-name" targets="Variable re.error=re-module.html#error"><a title="re.error" class="py-name" href="#" onclick="return doclink('link-15', 'error', 'link-15');">error</a></tt> <tt class="py-op">=</tt> <tt class="py-name">sre_compile</tt><tt class="py-op">.</tt><tt id="link-16" class="py-name"><a title="re.error" class="py-name" href="#" onclick="return doclink('link-16', 'error', 'link-15');">error</a></tt> </tt>
  179. <a name="L130"></a><tt class="py-lineno">130</tt> <tt class="py-line"> </tt>
  180. <a name="L131"></a><tt class="py-lineno">131</tt> <tt class="py-line"><tt class="py-comment"># --------------------------------------------------------------------</tt> </tt>
  181. <a name="L132"></a><tt class="py-lineno">132</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># public interface</tt> </tt>
  182. <a name="L133"></a><tt class="py-lineno">133</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt>
  183. <a name="match"></a><div id="match-def"><a name="L134"></a><tt class="py-lineno">134</tt> <a class="py-toggle" href="#" id="match-toggle" onclick="return toggle('match');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#match">match</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">string</tt><tt class="py-op">,</tt> <tt class="py-param">flags</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  184. </div><div id="match-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="match-expanded"><a name="L135"></a><tt class="py-lineno">135</tt> <tt class="py-line"> <tt class="py-docstring">"""Try to apply the pattern at the start of the string, returning</tt> </tt>
  185. <a name="L136"></a><tt class="py-lineno">136</tt> <tt class="py-line"><tt class="py-docstring"> a match object, or None if no match was found."""</tt> </tt>
  186. <a name="L137"></a><tt class="py-lineno">137</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-17" class="py-name" targets="Function re._compile()=re-module.html#_compile"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-17', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-name">flags</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-18" class="py-name" targets="Function re.match()=re-module.html#match"><a title="re.match" class="py-name" href="#" onclick="return doclink('link-18', 'match', 'link-18');">match</a></tt><tt class="py-op">(</tt><tt class="py-name">string</tt><tt class="py-op">)</tt> </tt>
  187. </div><a name="L138"></a><tt class="py-lineno">138</tt> <tt class="py-line"> </tt>
  188. <a name="search"></a><div id="search-def"><a name="L139"></a><tt class="py-lineno">139</tt> <a class="py-toggle" href="#" id="search-toggle" onclick="return toggle('search');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#search">search</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">string</tt><tt class="py-op">,</tt> <tt class="py-param">flags</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  189. </div><div id="search-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="search-expanded"><a name="L140"></a><tt class="py-lineno">140</tt> <tt class="py-line"> <tt class="py-docstring">"""Scan through string looking for a match to the pattern, returning</tt> </tt>
  190. <a name="L141"></a><tt class="py-lineno">141</tt> <tt class="py-line"><tt class="py-docstring"> a match object, or None if no match was found."""</tt> </tt>
  191. <a name="L142"></a><tt class="py-lineno">142</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-19" class="py-name"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-19', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-name">flags</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-20" class="py-name" targets="Function re.search()=re-module.html#search"><a title="re.search" class="py-name" href="#" onclick="return doclink('link-20', 'search', 'link-20');">search</a></tt><tt class="py-op">(</tt><tt class="py-name">string</tt><tt class="py-op">)</tt> </tt>
  192. </div><a name="L143"></a><tt class="py-lineno">143</tt> <tt class="py-line"> </tt>
  193. <a name="sub"></a><div id="sub-def"><a name="L144"></a><tt class="py-lineno">144</tt> <a class="py-toggle" href="#" id="sub-toggle" onclick="return toggle('sub');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#sub">sub</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">repl</tt><tt class="py-op">,</tt> <tt class="py-param">string</tt><tt class="py-op">,</tt> <tt class="py-param">count</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  194. </div><div id="sub-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="sub-expanded"><a name="L145"></a><tt class="py-lineno">145</tt> <tt class="py-line"> <tt class="py-docstring">"""Return the string obtained by replacing the leftmost</tt> </tt>
  195. <a name="L146"></a><tt class="py-lineno">146</tt> <tt class="py-line"><tt class="py-docstring"> non-overlapping occurrences of the pattern in string by the</tt> </tt>
  196. <a name="L147"></a><tt class="py-lineno">147</tt> <tt class="py-line"><tt class="py-docstring"> replacement repl. repl can be either a string or a callable;</tt> </tt>
  197. <a name="L148"></a><tt class="py-lineno">148</tt> <tt class="py-line"><tt class="py-docstring"> if a callable, it's passed the match object and must return</tt> </tt>
  198. <a name="L149"></a><tt class="py-lineno">149</tt> <tt class="py-line"><tt class="py-docstring"> a replacement string to be used."""</tt> </tt>
  199. <a name="L150"></a><tt class="py-lineno">150</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-21" class="py-name"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-21', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-22" class="py-name" targets="Function re.sub()=re-module.html#sub"><a title="re.sub" class="py-name" href="#" onclick="return doclink('link-22', 'sub', 'link-22');">sub</a></tt><tt class="py-op">(</tt><tt class="py-name">repl</tt><tt class="py-op">,</tt> <tt class="py-name">string</tt><tt class="py-op">,</tt> <tt class="py-name">count</tt><tt class="py-op">)</tt> </tt>
  200. </div><a name="L151"></a><tt class="py-lineno">151</tt> <tt class="py-line"> </tt>
  201. <a name="subn"></a><div id="subn-def"><a name="L152"></a><tt class="py-lineno">152</tt> <a class="py-toggle" href="#" id="subn-toggle" onclick="return toggle('subn');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#subn">subn</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">repl</tt><tt class="py-op">,</tt> <tt class="py-param">string</tt><tt class="py-op">,</tt> <tt class="py-param">count</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  202. </div><div id="subn-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="subn-expanded"><a name="L153"></a><tt class="py-lineno">153</tt> <tt class="py-line"> <tt class="py-docstring">"""Return a 2-tuple containing (new_string, number).</tt> </tt>
  203. <a name="L154"></a><tt class="py-lineno">154</tt> <tt class="py-line"><tt class="py-docstring"> new_string is the string obtained by replacing the leftmost</tt> </tt>
  204. <a name="L155"></a><tt class="py-lineno">155</tt> <tt class="py-line"><tt class="py-docstring"> non-overlapping occurrences of the pattern in the source</tt> </tt>
  205. <a name="L156"></a><tt class="py-lineno">156</tt> <tt class="py-line"><tt class="py-docstring"> string by the replacement repl. number is the number of</tt> </tt>
  206. <a name="L157"></a><tt class="py-lineno">157</tt> <tt class="py-line"><tt class="py-docstring"> substitutions that were made. repl can be either a string or a</tt> </tt>
  207. <a name="L158"></a><tt class="py-lineno">158</tt> <tt class="py-line"><tt class="py-docstring"> callable; if a callable, it's passed the match object and must</tt> </tt>
  208. <a name="L159"></a><tt class="py-lineno">159</tt> <tt class="py-line"><tt class="py-docstring"> return a replacement string to be used."""</tt> </tt>
  209. <a name="L160"></a><tt class="py-lineno">160</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-23" class="py-name"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-23', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-24" class="py-name" targets="Function re.subn()=re-module.html#subn"><a title="re.subn" class="py-name" href="#" onclick="return doclink('link-24', 'subn', 'link-24');">subn</a></tt><tt class="py-op">(</tt><tt class="py-name">repl</tt><tt class="py-op">,</tt> <tt class="py-name">string</tt><tt class="py-op">,</tt> <tt class="py-name">count</tt><tt class="py-op">)</tt> </tt>
  210. </div><a name="L161"></a><tt class="py-lineno">161</tt> <tt class="py-line"> </tt>
  211. <a name="split"></a><div id="split-def"><a name="L162"></a><tt class="py-lineno">162</tt> <a class="py-toggle" href="#" id="split-toggle" onclick="return toggle('split');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#split">split</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">string</tt><tt class="py-op">,</tt> <tt class="py-param">maxsplit</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  212. </div><div id="split-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="split-expanded"><a name="L163"></a><tt class="py-lineno">163</tt> <tt class="py-line"> <tt class="py-docstring">"""Split the source string by the occurrences of the pattern,</tt> </tt>
  213. <a name="L164"></a><tt class="py-lineno">164</tt> <tt class="py-line"><tt class="py-docstring"> returning a list containing the resulting substrings."""</tt> </tt>
  214. <a name="L165"></a><tt class="py-lineno">165</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-25" class="py-name"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-25', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-26" class="py-name" targets="Function re.split()=re-module.html#split"><a title="re.split" class="py-name" href="#" onclick="return doclink('link-26', 'split', 'link-26');">split</a></tt><tt class="py-op">(</tt><tt class="py-name">string</tt><tt class="py-op">,</tt> <tt class="py-name">maxsplit</tt><tt class="py-op">)</tt> </tt>
  215. </div><a name="L166"></a><tt class="py-lineno">166</tt> <tt class="py-line"> </tt>
  216. <a name="findall"></a><div id="findall-def"><a name="L167"></a><tt class="py-lineno">167</tt> <a class="py-toggle" href="#" id="findall-toggle" onclick="return toggle('findall');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#findall">findall</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">string</tt><tt class="py-op">,</tt> <tt class="py-param">flags</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  217. </div><div id="findall-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="findall-expanded"><a name="L168"></a><tt class="py-lineno">168</tt> <tt class="py-line"> <tt class="py-docstring">"""Return a list of all non-overlapping matches in the string.</tt> </tt>
  218. <a name="L169"></a><tt class="py-lineno">169</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  219. <a name="L170"></a><tt class="py-lineno">170</tt> <tt class="py-line"><tt class="py-docstring"> If one or more groups are present in the pattern, return a</tt> </tt>
  220. <a name="L171"></a><tt class="py-lineno">171</tt> <tt class="py-line"><tt class="py-docstring"> list of groups; this will be a list of tuples if the pattern</tt> </tt>
  221. <a name="L172"></a><tt class="py-lineno">172</tt> <tt class="py-line"><tt class="py-docstring"> has more than one group.</tt> </tt>
  222. <a name="L173"></a><tt class="py-lineno">173</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  223. <a name="L174"></a><tt class="py-lineno">174</tt> <tt class="py-line"><tt class="py-docstring"> Empty matches are included in the result."""</tt> </tt>
  224. <a name="L175"></a><tt class="py-lineno">175</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-27" class="py-name"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-27', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-name">flags</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-28" class="py-name" targets="Function re.findall()=re-module.html#findall"><a title="re.findall" class="py-name" href="#" onclick="return doclink('link-28', 'findall', 'link-28');">findall</a></tt><tt class="py-op">(</tt><tt class="py-name">string</tt><tt class="py-op">)</tt> </tt>
  225. </div><a name="L176"></a><tt class="py-lineno">176</tt> <tt class="py-line"> </tt>
  226. <a name="L177"></a><tt class="py-lineno">177</tt> <tt class="py-line"><tt class="py-keyword">if</tt> <tt class="py-name">sys</tt><tt class="py-op">.</tt><tt class="py-name">hexversion</tt> <tt class="py-op">&gt;=</tt> <tt class="py-number">0x02020000</tt><tt class="py-op">:</tt> </tt>
  227. <a name="L178"></a><tt class="py-lineno">178</tt> <tt class="py-line"> <tt class="py-name">__all__</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">"finditer"</tt><tt class="py-op">)</tt> </tt>
  228. <a name="finditer"></a><div id="finditer-def"><a name="L179"></a><tt class="py-lineno">179</tt> <a class="py-toggle" href="#" id="finditer-toggle" onclick="return toggle('finditer');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#finditer">finditer</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">string</tt><tt class="py-op">,</tt> <tt class="py-param">flags</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  229. </div><div id="finditer-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="finditer-expanded"><a name="L180"></a><tt class="py-lineno">180</tt> <tt class="py-line"> <tt class="py-docstring">"""Return an iterator over all non-overlapping matches in the</tt> </tt>
  230. <a name="L181"></a><tt class="py-lineno">181</tt> <tt class="py-line"><tt class="py-docstring"> string. For each match, the iterator returns a match object.</tt> </tt>
  231. <a name="L182"></a><tt class="py-lineno">182</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
  232. <a name="L183"></a><tt class="py-lineno">183</tt> <tt class="py-line"><tt class="py-docstring"> Empty matches are included in the result."""</tt> </tt>
  233. <a name="L184"></a><tt class="py-lineno">184</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-29" class="py-name"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-29', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-name">flags</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-30" class="py-name" targets="Function re.finditer()=re-module.html#finditer"><a title="re.finditer" class="py-name" href="#" onclick="return doclink('link-30', 'finditer', 'link-30');">finditer</a></tt><tt class="py-op">(</tt><tt class="py-name">string</tt><tt class="py-op">)</tt> </tt>
  234. </div><a name="L185"></a><tt class="py-lineno">185</tt> <tt class="py-line"> </tt>
  235. <a name="compile"></a><div id="compile-def"><a name="L186"></a><tt class="py-lineno">186</tt> <a class="py-toggle" href="#" id="compile-toggle" onclick="return toggle('compile');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#compile">compile</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">flags</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  236. </div><div id="compile-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="compile-expanded"><a name="L187"></a><tt class="py-lineno">187</tt> <tt class="py-line"> <tt class="py-docstring">"Compile a regular expression pattern, returning a pattern object."</tt> </tt>
  237. <a name="L188"></a><tt class="py-lineno">188</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-31" class="py-name"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-31', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-name">flags</tt><tt class="py-op">)</tt> </tt>
  238. </div><a name="L189"></a><tt class="py-lineno">189</tt> <tt class="py-line"> </tt>
  239. <a name="purge"></a><div id="purge-def"><a name="L190"></a><tt class="py-lineno">190</tt> <a class="py-toggle" href="#" id="purge-toggle" onclick="return toggle('purge');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#purge">purge</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  240. </div><div id="purge-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="purge-expanded"><a name="L191"></a><tt class="py-lineno">191</tt> <tt class="py-line"> <tt class="py-docstring">"Clear the regular expression cache"</tt> </tt>
  241. <a name="L192"></a><tt class="py-lineno">192</tt> <tt class="py-line"> <tt id="link-32" class="py-name" targets="Variable re._cache=re-module.html#_cache"><a title="re._cache" class="py-name" href="#" onclick="return doclink('link-32', '_cache', 'link-32');">_cache</a></tt><tt class="py-op">.</tt><tt class="py-name">clear</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
  242. <a name="L193"></a><tt class="py-lineno">193</tt> <tt class="py-line"> <tt id="link-33" class="py-name" targets="Variable re._cache_repl=re-module.html#_cache_repl"><a title="re._cache_repl" class="py-name" href="#" onclick="return doclink('link-33', '_cache_repl', 'link-33');">_cache_repl</a></tt><tt class="py-op">.</tt><tt class="py-name">clear</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
  243. </div><a name="L194"></a><tt class="py-lineno">194</tt> <tt class="py-line"> </tt>
  244. <a name="template"></a><div id="template-def"><a name="L195"></a><tt class="py-lineno">195</tt> <a class="py-toggle" href="#" id="template-toggle" onclick="return toggle('template');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#template">template</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">,</tt> <tt class="py-param">flags</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  245. </div><div id="template-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="template-expanded"><a name="L196"></a><tt class="py-lineno">196</tt> <tt class="py-line"> <tt class="py-docstring">"Compile a template pattern, returning a pattern object"</tt> </tt>
  246. <a name="L197"></a><tt class="py-lineno">197</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-34" class="py-name"><a title="re._compile" class="py-name" href="#" onclick="return doclink('link-34', '_compile', 'link-17');">_compile</a></tt><tt class="py-op">(</tt><tt class="py-name">pattern</tt><tt class="py-op">,</tt> <tt class="py-name">flags</tt><tt class="py-op">|</tt><tt id="link-35" class="py-name"><a title="re.T" class="py-name" href="#" onclick="return doclink('link-35', 'T', 'link-12');">T</a></tt><tt class="py-op">)</tt> </tt>
  247. </div><a name="L198"></a><tt class="py-lineno">198</tt> <tt class="py-line"> </tt>
  248. <a name="L199"></a><tt class="py-lineno">199</tt> <tt class="py-line"><tt id="link-36" class="py-name" targets="Variable re._alphanum=re-module.html#_alphanum"><a title="re._alphanum" class="py-name" href="#" onclick="return doclink('link-36', '_alphanum', 'link-36');">_alphanum</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
  249. <a name="L200"></a><tt class="py-lineno">200</tt> <tt class="py-line"><tt class="py-keyword">for</tt> <tt class="py-name">c</tt> <tt class="py-keyword">in</tt> <tt class="py-string">'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ01234567890'</tt><tt class="py-op">:</tt> </tt>
  250. <a name="L201"></a><tt class="py-lineno">201</tt> <tt class="py-line"> <tt id="link-37" class="py-name"><a title="re._alphanum" class="py-name" href="#" onclick="return doclink('link-37', '_alphanum', 'link-36');">_alphanum</a></tt><tt class="py-op">[</tt><tt class="py-name">c</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-number">1</tt> </tt>
  251. <a name="L202"></a><tt class="py-lineno">202</tt> <tt class="py-line"><tt class="py-keyword">del</tt> <tt class="py-name">c</tt> </tt>
  252. <a name="L203"></a><tt class="py-lineno">203</tt> <tt class="py-line"> </tt>
  253. <a name="escape"></a><div id="escape-def"><a name="L204"></a><tt class="py-lineno">204</tt> <a class="py-toggle" href="#" id="escape-toggle" onclick="return toggle('escape');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="re-module.html#escape">escape</a><tt class="py-op">(</tt><tt class="py-param">pattern</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
  254. </div><div id="escape-collapsed" style="d…

Large files files are truncated, but you can click here to view the full file