123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159 |
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
- <title><%GLibRegexMatchFlags>: </title>
- <meta name="generator" content="DocBook XSL Stylesheets V1.79.2">
- <link rel="home" href="index.html" title="">
- <link rel="up" href="ch01.html" title="GLib">
- <link rel="prev" href="re53.html" title="<%GLibRegexError>">
- <link rel="next" href="re55.html" title="<%GLibSeekType>">
- <meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
- <link rel="stylesheet" href="style.css" type="text/css">
- </head>
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
- <td width="100%" align="left" class="shortcuts"></td>
- <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
- <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
- <td><a accesskey="p" href="re53.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
- <td><a accesskey="n" href="re55.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
- </tr></table>
- <div class="refentry">
- <a name="id-1.1.55"></a><div class="titlepage"></div>
- <div class="refnamediv">
- <h2><%GLibRegexMatchFlags></h2>
- <p><%GLibRegexMatchFlags></p>
- </div>
- <div class="refsect1">
- <a name="id-1.1.55.2"></a><h2>Description</h2>
- <p>Flags specifying match-time options.</p>
- </div>
- <div class="refsect1">
- <a name="id-1.1.55.3"></a><h2>Members</h2>
- <div class="refsect2">
- <a name="id-1.1.55.3.2"></a><h3>anchored</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_ANCHORED</code></span></em></p>
- <p>The pattern is forced to be "anchored", that is,
- it is constrained to match only at the first matching point in the
- string that is being searched. This effect can also be achieved by
- appropriate constructs in the pattern itself such as the "^"
- metacharacter.</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.3"></a><h3>notbol</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NOTBOL</code></span></em></p>
- <p>Specifies that first character of the string is
- not the beginning of a line, so the circumflex metacharacter should
- not match before it. Setting this without <span class="type">G_REGEX_MULTILINE</span> (at
- compile time) causes circumflex never to match. This option affects
- only the behaviour of the circumflex metacharacter, it does not
- affect "\A".</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.4"></a><h3>noteol</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NOTEOL</code></span></em></p>
- <p>Specifies that the end of the subject string is
- not the end of a line, so the dollar metacharacter should not match
- it nor (except in multiline mode) a newline immediately before it.
- Setting this without <span class="type">G_REGEX_MULTILINE</span> (at compile time) causes
- dollar never to match. This option affects only the behaviour of
- the dollar metacharacter, it does not affect "\Z" or "\z".</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.5"></a><h3>notempty</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NOTEMPTY</code></span></em></p>
- <p>An empty string is not considered to be a valid
- match if this option is set. If there are alternatives in the pattern,
- they are tried. If all the alternatives match the empty string, the
- entire match fails. For example, if the pattern "a?b?" is applied to
- a string not beginning with "a" or "b", it matches the empty string
- at the start of the string. With this flag set, this match is not
- valid, so GRegex searches further into the string for occurrences
- of "a" or "b".</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.6"></a><h3>partial</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_PARTIAL</code></span></em></p>
- <p>Turns on the partial matching feature, for more
- documentation on partial matching see <code class="function">g_match_info_is_partial_match()</code>.</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.7"></a><h3>newline-cr</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_CR</code></span></em></p>
- <p>Overrides the newline definition set when
- creating a new <span class="type">GRegex</span>, setting the '\r' character as line terminator.</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.8"></a><h3>newline-lf</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_LF</code></span></em></p>
- <p>Overrides the newline definition set when
- creating a new <span class="type">GRegex</span>, setting the '\n' character as line terminator.</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.9"></a><h3>newline-crlf</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_CRLF</code></span></em></p>
- <p>Overrides the newline definition set when
- creating a new <span class="type">GRegex</span>, setting the '\r\n' characters sequence as line terminator.</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.10"></a><h3>newline-any</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_ANY</code></span></em></p>
- <p>Overrides the newline definition set when
- creating a new <span class="type">GRegex</span>, any Unicode newline sequence
- is recognised as a newline. These are '\r', '\n' and '\rn', and the
- single characters U+000B LINE TABULATION, U+000C FORM FEED (FF),
- U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and
- U+2029 PARAGRAPH SEPARATOR.</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.11"></a><h3>newline-anycrlf</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NEWLINE_ANYCRLF</code></span></em></p>
- <p>Overrides the newline definition set when
- creating a new <span class="type">GRegex</span>; any '\r', '\n', or '\r\n' character sequence
- is recognized as a newline. Since: 2.34</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.12"></a><h3>bsr-anycrlf</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_BSR_ANYCRLF</code></span></em></p>
- <p>Overrides the newline definition for "\R" set when
- creating a new <span class="type">GRegex</span>; only '\r', '\n', or '\r\n' character sequences
- are recognized as a newline by "\R". Since: 2.34</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.13"></a><h3>bsr-any</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_BSR_ANY</code></span></em></p>
- <p>Overrides the newline definition for "\R" set when
- creating a new <span class="type">GRegex</span>; any Unicode newline character or character sequence
- are recognized as a newline by "\R". These are '\r', '\n' and '\rn', and the
- single characters U+000B LINE TABULATION, U+000C FORM FEED (FF),
- U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and
- U+2029 PARAGRAPH SEPARATOR. Since: 2.34</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.14"></a><h3>partial-soft</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_PARTIAL_SOFT</code></span></em></p>
- <p>An alias for <span class="type">G_REGEX_MATCH_PARTIAL</span>. Since: 2.34</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.15"></a><h3>partial-hard</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_PARTIAL_HARD</code></span></em></p>
- <p>Turns on the partial matching feature. In contrast to
- to <span class="type">G_REGEX_MATCH_PARTIAL_SOFT</span>, this stops matching as soon as a partial match
- is found, without continuing to search for a possible complete match. See
- <code class="function">g_match_info_is_partial_match()</code> for more information. Since: 2.34</p>
- </div>
- <div class="refsect2">
- <a name="id-1.1.55.3.16"></a><h3>notempty-atstart</h3>
- <p class="remark"><em><span class="remark">alias <code class="code">G_REGEX_MATCH_NOTEMPTY_ATSTART</code></span></em></p>
- <p>Like <span class="type">G_REGEX_MATCH_NOTEMPTY</span>, but only applied to
- the start of the matched string. For anchored
- patterns this can only happen for pattern containing "\K". Since: 2.34</p>
- </div>
- </div>
- </div>
- <div class="footer">
- <hr>Generated by GTK-Doc V1.33.1</div>
- </body>
- </html>
|