re52.html 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  5. <title>&lt;%GLibRegexCompileFlags&gt;: </title>
  6. <meta name="generator" content="DocBook XSL Stylesheets V1.79.2">
  7. <link rel="home" href="index.html" title="">
  8. <link rel="up" href="ch01.html" title="GLib">
  9. <link rel="prev" href="re51.html" title="&lt;GRegex&gt;">
  10. <link rel="next" href="re53.html" title="&lt;%GLibRegexError&gt;">
  11. <meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
  12. <link rel="stylesheet" href="style.css" type="text/css">
  13. </head>
  14. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15. <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
  16. <td width="100%" align="left" class="shortcuts"></td>
  17. <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  18. <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
  19. <td><a accesskey="p" href="re51.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  20. <td><a accesskey="n" href="re53.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  21. </tr></table>
  22. <div class="refentry">
  23. <a name="id-1.1.53"></a><div class="titlepage"></div>
  24. <div class="refnamediv">
  25. <h2>&lt;%GLibRegexCompileFlags&gt;</h2>
  26. <p>&lt;%GLibRegexCompileFlags&gt;</p>
  27. </div>
  28. <div class="refsect1">
  29. <a name="id-1.1.53.2"></a><h2>Description</h2>
  30. <p>Flags specifying compile-time options.</p>
  31. </div>
  32. <div class="refsect1">
  33. <a name="id-1.1.53.3"></a><h2>Members</h2>
  34. <div class="refsect2">
  35. <a name="id-1.1.53.3.2"></a><h3>caseless</h3>
  36. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_CASELESS</code></span></em></p>
  37. <p>Letters in the pattern match both upper- and
  38. lowercase letters. This option can be changed within a pattern
  39. by a "(?i)" option setting.</p>
  40. </div>
  41. <div class="refsect2">
  42. <a name="id-1.1.53.3.3"></a><h3>multiline</h3>
  43. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MULTILINE</code></span></em></p>
  44. <p>By default, GRegex treats the strings as consisting
  45. of a single line of characters (even if it actually contains
  46. newlines). The "start of line" metacharacter ("^") matches only
  47. at the start of the string, while the "end of line" metacharacter
  48. ("$") matches only at the end of the string, or before a terminating
  49. newline (unless <span class="type">G_REGEX_DOLLAR_ENDONLY</span> is set). When
  50. <span class="type">G_REGEX_MULTILINE</span> is set, the "start of line" and "end of line"
  51. constructs match immediately following or immediately before any
  52. newline in the string, respectively, as well as at the very start
  53. and end. This can be changed within a pattern by a "(?m)" option
  54. setting.</p>
  55. </div>
  56. <div class="refsect2">
  57. <a name="id-1.1.53.3.4"></a><h3>dotall</h3>
  58. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_DOTALL</code></span></em></p>
  59. <p>A dot metacharacter (".") in the pattern matches all
  60. characters, including newlines. Without it, newlines are excluded.
  61. This option can be changed within a pattern by a ("?s") option setting.</p>
  62. </div>
  63. <div class="refsect2">
  64. <a name="id-1.1.53.3.5"></a><h3>extended</h3>
  65. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_EXTENDED</code></span></em></p>
  66. <p>Whitespace data characters in the pattern are
  67. totally ignored except when escaped or inside a character class.
  68. Whitespace does not include the VT character (code 11). In addition,
  69. characters between an unescaped "#" outside a character class and
  70. the next newline character, inclusive, are also ignored. This can
  71. be changed within a pattern by a "(?x)" option setting.</p>
  72. </div>
  73. <div class="refsect2">
  74. <a name="id-1.1.53.3.6"></a><h3>anchored</h3>
  75. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_ANCHORED</code></span></em></p>
  76. <p>The pattern is forced to be "anchored", that is,
  77. it is constrained to match only at the first matching point in the
  78. string that is being searched. This effect can also be achieved by
  79. appropriate constructs in the pattern itself such as the "^"
  80. metacharacter.</p>
  81. </div>
  82. <div class="refsect2">
  83. <a name="id-1.1.53.3.7"></a><h3>dollar-endonly</h3>
  84. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_DOLLAR_ENDONLY</code></span></em></p>
  85. <p>A dollar metacharacter ("$") in the pattern
  86. matches only at the end of the string. Without this option, a
  87. dollar also matches immediately before the final character if
  88. it is a newline (but not before any other newlines). This option
  89. is ignored if <span class="type">G_REGEX_MULTILINE</span> is set.</p>
  90. </div>
  91. <div class="refsect2">
  92. <a name="id-1.1.53.3.8"></a><h3>ungreedy</h3>
  93. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_UNGREEDY</code></span></em></p>
  94. <p>Inverts the "greediness" of the quantifiers so that
  95. they are not greedy by default, but become greedy if followed by "?".
  96. It can also be set by a "(?U)" option setting within the pattern.</p>
  97. </div>
  98. <div class="refsect2">
  99. <a name="id-1.1.53.3.9"></a><h3>raw</h3>
  100. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_RAW</code></span></em></p>
  101. <p>Usually strings must be valid UTF-8 strings, using this
  102. flag they are considered as a raw sequence of bytes.</p>
  103. </div>
  104. <div class="refsect2">
  105. <a name="id-1.1.53.3.10"></a><h3>no-auto-capture</h3>
  106. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_NO_AUTO_CAPTURE</code></span></em></p>
  107. <p>Disables the use of numbered capturing
  108. parentheses in the pattern. Any opening parenthesis that is not
  109. followed by "?" behaves as if it were followed by "?:" but named
  110. parentheses can still be used for capturing (and they acquire numbers
  111. in the usual way).</p>
  112. </div>
  113. <div class="refsect2">
  114. <a name="id-1.1.53.3.11"></a><h3>optimize</h3>
  115. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_OPTIMIZE</code></span></em></p>
  116. <p>Optimize the regular expression. If the pattern will
  117. be used many times, then it may be worth the effort to optimize it
  118. to improve the speed of matches.</p>
  119. </div>
  120. <div class="refsect2">
  121. <a name="id-1.1.53.3.12"></a><h3>firstline</h3>
  122. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_FIRSTLINE</code></span></em></p>
  123. <p>Limits an unanchored pattern to match before (or at) the
  124. first newline. Since: 2.34</p>
  125. </div>
  126. <div class="refsect2">
  127. <a name="id-1.1.53.3.13"></a><h3>dupnames</h3>
  128. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_DUPNAMES</code></span></em></p>
  129. <p>Names used to identify capturing subpatterns need not
  130. be unique. This can be helpful for certain types of pattern when it
  131. is known that only one instance of the named subpattern can ever be
  132. matched.</p>
  133. </div>
  134. <div class="refsect2">
  135. <a name="id-1.1.53.3.14"></a><h3>newline-cr</h3>
  136. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_NEWLINE_CR</code></span></em></p>
  137. <p>Usually any newline character or character sequence is
  138. recognized. If this option is set, the only recognized newline character
  139. is '\r'.</p>
  140. </div>
  141. <div class="refsect2">
  142. <a name="id-1.1.53.3.15"></a><h3>newline-lf</h3>
  143. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_NEWLINE_LF</code></span></em></p>
  144. <p>Usually any newline character or character sequence is
  145. recognized. If this option is set, the only recognized newline character
  146. is '\n'.</p>
  147. </div>
  148. <div class="refsect2">
  149. <a name="id-1.1.53.3.16"></a><h3>newline-crlf</h3>
  150. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_NEWLINE_CRLF</code></span></em></p>
  151. <p>Usually any newline character or character sequence is
  152. recognized. If this option is set, the only recognized newline character
  153. sequence is '\r\n'.</p>
  154. </div>
  155. <div class="refsect2">
  156. <a name="id-1.1.53.3.17"></a><h3>newline-anycrlf</h3>
  157. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_NEWLINE_ANYCRLF</code></span></em></p>
  158. <p>Usually any newline character or character sequence
  159. is recognized. If this option is set, the only recognized newline character
  160. sequences are '\r', '\n', and '\r\n'. Since: 2.34</p>
  161. </div>
  162. <div class="refsect2">
  163. <a name="id-1.1.53.3.18"></a><h3>bsr-anycrlf</h3>
  164. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_BSR_ANYCRLF</code></span></em></p>
  165. <p>Usually any newline character or character sequence
  166. is recognised. If this option is set, then "\R" only recognizes the newline
  167. characters '\r', '\n' and '\r\n'. Since: 2.34</p>
  168. </div>
  169. <div class="refsect2">
  170. <a name="id-1.1.53.3.19"></a><h3>javascript-compat</h3>
  171. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_JAVASCRIPT_COMPAT</code></span></em></p>
  172. <p>Changes behaviour so that it is compatible with
  173. JavaScript rather than PCRE. Since: 2.34</p>
  174. </div>
  175. </div>
  176. </div>
  177. <div class="footer">
  178. <hr>Generated by GTK-Doc V1.33.1</div>
  179. </body>
  180. </html>