re54.html 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159
  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;%GLibRegexMatchFlags&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="re53.html" title="&lt;%GLibRegexError&gt;">
  10. <link rel="next" href="re55.html" title="&lt;%GLibSeekType&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="re53.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  20. <td><a accesskey="n" href="re55.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.55"></a><div class="titlepage"></div>
  24. <div class="refnamediv">
  25. <h2>&lt;%GLibRegexMatchFlags&gt;</h2>
  26. <p>&lt;%GLibRegexMatchFlags&gt;</p>
  27. </div>
  28. <div class="refsect1">
  29. <a name="id-1.1.55.2"></a><h2>Description</h2>
  30. <p>Flags specifying match-time options.</p>
  31. </div>
  32. <div class="refsect1">
  33. <a name="id-1.1.55.3"></a><h2>Members</h2>
  34. <div class="refsect2">
  35. <a name="id-1.1.55.3.2"></a><h3>anchored</h3>
  36. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_ANCHORED</code></span></em></p>
  37. <p>The pattern is forced to be "anchored", that is,
  38. it is constrained to match only at the first matching point in the
  39. string that is being searched. This effect can also be achieved by
  40. appropriate constructs in the pattern itself such as the "^"
  41. metacharacter.</p>
  42. </div>
  43. <div class="refsect2">
  44. <a name="id-1.1.55.3.3"></a><h3>notbol</h3>
  45. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NOTBOL</code></span></em></p>
  46. <p>Specifies that first character of the string is
  47. not the beginning of a line, so the circumflex metacharacter should
  48. not match before it. Setting this without <span class="type">G_REGEX_MULTILINE</span> (at
  49. compile time) causes circumflex never to match. This option affects
  50. only the behaviour of the circumflex metacharacter, it does not
  51. affect "\A".</p>
  52. </div>
  53. <div class="refsect2">
  54. <a name="id-1.1.55.3.4"></a><h3>noteol</h3>
  55. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NOTEOL</code></span></em></p>
  56. <p>Specifies that the end of the subject string is
  57. not the end of a line, so the dollar metacharacter should not match
  58. it nor (except in multiline mode) a newline immediately before it.
  59. Setting this without <span class="type">G_REGEX_MULTILINE</span> (at compile time) causes
  60. dollar never to match. This option affects only the behaviour of
  61. the dollar metacharacter, it does not affect "\Z" or "\z".</p>
  62. </div>
  63. <div class="refsect2">
  64. <a name="id-1.1.55.3.5"></a><h3>notempty</h3>
  65. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NOTEMPTY</code></span></em></p>
  66. <p>An empty string is not considered to be a valid
  67. match if this option is set. If there are alternatives in the pattern,
  68. they are tried. If all the alternatives match the empty string, the
  69. entire match fails. For example, if the pattern "a?b?" is applied to
  70. a string not beginning with "a" or "b", it matches the empty string
  71. at the start of the string. With this flag set, this match is not
  72. valid, so GRegex searches further into the string for occurrences
  73. of "a" or "b".</p>
  74. </div>
  75. <div class="refsect2">
  76. <a name="id-1.1.55.3.6"></a><h3>partial</h3>
  77. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_PARTIAL</code></span></em></p>
  78. <p>Turns on the partial matching feature, for more
  79. documentation on partial matching see <code class="function">g_match_info_is_partial_match()</code>.</p>
  80. </div>
  81. <div class="refsect2">
  82. <a name="id-1.1.55.3.7"></a><h3>newline-cr</h3>
  83. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_CR</code></span></em></p>
  84. <p>Overrides the newline definition set when
  85. creating a new <span class="type">GRegex</span>, setting the '\r' character as line terminator.</p>
  86. </div>
  87. <div class="refsect2">
  88. <a name="id-1.1.55.3.8"></a><h3>newline-lf</h3>
  89. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_LF</code></span></em></p>
  90. <p>Overrides the newline definition set when
  91. creating a new <span class="type">GRegex</span>, setting the '\n' character as line terminator.</p>
  92. </div>
  93. <div class="refsect2">
  94. <a name="id-1.1.55.3.9"></a><h3>newline-crlf</h3>
  95. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_CRLF</code></span></em></p>
  96. <p>Overrides the newline definition set when
  97. creating a new <span class="type">GRegex</span>, setting the '\r\n' characters sequence as line terminator.</p>
  98. </div>
  99. <div class="refsect2">
  100. <a name="id-1.1.55.3.10"></a><h3>newline-any</h3>
  101. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_ANY</code></span></em></p>
  102. <p>Overrides the newline definition set when
  103. creating a new <span class="type">GRegex</span>, any Unicode newline sequence
  104. is recognised as a newline. These are '\r', '\n' and '\rn', and the
  105. single characters U+000B LINE TABULATION, U+000C FORM FEED (FF),
  106. U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and
  107. U+2029 PARAGRAPH SEPARATOR.</p>
  108. </div>
  109. <div class="refsect2">
  110. <a name="id-1.1.55.3.11"></a><h3>newline-anycrlf</h3>
  111. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_ANYCRLF</code></span></em></p>
  112. <p>Overrides the newline definition set when
  113. creating a new <span class="type">GRegex</span>; any '\r', '\n', or '\r\n' character sequence
  114. is recognized as a newline. Since: 2.34</p>
  115. </div>
  116. <div class="refsect2">
  117. <a name="id-1.1.55.3.12"></a><h3>bsr-anycrlf</h3>
  118. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_BSR_ANYCRLF</code></span></em></p>
  119. <p>Overrides the newline definition for "\R" set when
  120. creating a new <span class="type">GRegex</span>; only '\r', '\n', or '\r\n' character sequences
  121. are recognized as a newline by "\R". Since: 2.34</p>
  122. </div>
  123. <div class="refsect2">
  124. <a name="id-1.1.55.3.13"></a><h3>bsr-any</h3>
  125. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_BSR_ANY</code></span></em></p>
  126. <p>Overrides the newline definition for "\R" set when
  127. creating a new <span class="type">GRegex</span>; any Unicode newline character or character sequence
  128. are recognized as a newline by "\R". These are '\r', '\n' and '\rn', and the
  129. single characters U+000B LINE TABULATION, U+000C FORM FEED (FF),
  130. U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and
  131. U+2029 PARAGRAPH SEPARATOR. Since: 2.34</p>
  132. </div>
  133. <div class="refsect2">
  134. <a name="id-1.1.55.3.14"></a><h3>partial-soft</h3>
  135. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_PARTIAL_SOFT</code></span></em></p>
  136. <p>An alias for <span class="type">G_REGEX_MATCH_PARTIAL</span>. Since: 2.34</p>
  137. </div>
  138. <div class="refsect2">
  139. <a name="id-1.1.55.3.15"></a><h3>partial-hard</h3>
  140. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_PARTIAL_HARD</code></span></em></p>
  141. <p>Turns on the partial matching feature. In contrast to
  142. to <span class="type">G_REGEX_MATCH_PARTIAL_SOFT</span>, this stops matching as soon as a partial match
  143. is found, without continuing to search for a possible complete match. See
  144. <code class="function">g_match_info_is_partial_match()</code> for more information. Since: 2.34</p>
  145. </div>
  146. <div class="refsect2">
  147. <a name="id-1.1.55.3.16"></a><h3>notempty-atstart</h3>
  148. <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NOTEMPTY_ATSTART</code></span></em></p>
  149. <p>Like <span class="type">G_REGEX_MATCH_NOTEMPTY</span>, but only applied to
  150. the start of the matched string. For anchored
  151. patterns this can only happen for pattern containing "\K". Since: 2.34</p>
  152. </div>
  153. </div>
  154. </div>
  155. <div class="footer">
  156. <hr>Generated by GTK-Doc V1.33.1</div>
  157. </body>
  158. </html>