~ubuntu-branches/debian/squeeze/glib2.0/squeeze
» Revision
70
: docs/reference/glib/html/glib-Perl-compatible-regular-expressions.html
« back to all changes in this revision
Viewing changes to docs/reference/glib/html/glib-Perl-compatible-regular-expressions.html
- browse files at revision 70
- compare with another revision
- download diff
- download tarball
- view history from revision 70
- Committer: Bazaar Package Importer
- Author(s): Gustavo Noronha Silva
- Date: 2009-02-15 13:00:43 UTC
- mfrom: (1.3.1 upstream) (69.1.10 intrepid)
- Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields
- files added:
- build/win32/vs8/gio.vcproj
- gio/fen
- gio/win32
- files removed:
- docs/reference/gio/html/gio-extension-points.html
- files modified:
- ChangeLog
added
removed
docs/reference/glib/html/glib-Perl-compatible-regular-expressions.html
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
2
<html>
3
3
<head>
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Perl-compatible regular expressions</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
<link rel="start" href="index.html" title="GLib Reference Manual">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
7
<link rel="home" href="index.html" title="GLib Reference Manual">
8
8
<link rel="up" href="glib-utilities.html" title="GLib Utilities">
9
9
<link rel="prev" href="glib-Glob-style-pattern-matching.html" title="Glob-style pattern matching">
10
10
<link rel="next" href="glib-Simple-XML-Subset-Parser.html" title="Simple XML Subset Parser">
11
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="glib.html" title="GLib Overview">
14
14
<link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals">
26
26
<link rel="index" href="ix08.html" title="Index of new symbols in 2.12">
27
27
<link rel="index" href="ix09.html" title="Index of new symbols in 2.14">
28
28
<link rel="index" href="ix10.html" title="Index of new symbols in 2.16">
29
<link rel="index" href="ix11.html" title="Index of new symbols in 2.18">
29
30
</head>
30
31
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
31
32
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
36
37
<th width="100%" align="center">GLib Reference Manual</th>
37
38
<td><a accesskey="n" href="glib-Simple-XML-Subset-Parser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
38
39
</tr>
39
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3199765" class="shortcut">Top</a>
40
 | 
41
<a href="#id3201178" class="shortcut">Description</a></nobr></td></tr>
40
<tr><td colspan="5" class="shortcuts">
41
<a href="#glib-Perl-compatible-regular-expressions.synopsis" class="shortcut">Top</a>
42
|
43
<a href="#glib-Perl-compatible-regular-expressions.description" class="shortcut">Description</a>
44
</td></tr>
42
45
</table>
43
46
<div class="refentry" lang="en">
44
47
<a name="glib-Perl-compatible-regular-expressions"></a><div class="titlepage"></div>
45
48
<div class="refnamediv"><table width="100%"><tr>
46
49
<td valign="top">
47
<h2>
48
<a name="id3199765"></a><span class="refentrytitle">Perl-compatible regular expressions</span>
49
</h2>
50
<p>Perl-compatible regular expressions — matches strings against regular expressions</p>
50
<h2><span class="refentrytitle"><a name="glib-Perl-compatible-regular-expressions.top_of_page"></a>Perl-compatible regular expressions</span></h2>
51
<p>Perl-compatible regular expressions — matches strings against regular expressions</p>
51
52
</td>
52
53
<td valign="top" align="right"></td>
53
54
</tr></table></div>
54
55
<div class="refsynopsisdiv">
55
<h2>Synopsis</h2>
56
<a name="glib-Perl-compatible-regular-expressions.synopsis"></a><h2>Synopsis</h2>
56
57
<pre class="synopsis">
57
58
58
59
#include <glib.h>
59
60
60
61
enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexError">GRegexError</a>;
62
#define <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-ERROR:CAPS">G_REGEX_ERROR</a>
63
enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a>;
64
enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a>;
65
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a>;
66
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexEvalCallback">*GRegexEvalCallback</a>) (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
67
<a class="link" href="glib-Strings.html#GString">GString</a> *result,
68
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);
69
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new">g_regex_new</a> (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *pattern,
70
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
71
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
72
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
73
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-ref">g_regex_ref</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);
74
void <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-unref">g_regex_unref</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);
75
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-get-pattern">g_regex_get_pattern</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);
76
<a class="link" href="glib-Basic-Types.html#gint">gint</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-get-max-backref">g_regex_get_max_backref</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);
77
<a class="link" href="glib-Basic-Types.html#gint">gint</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-get-capture-count">g_regex_get_capture_count</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);
78
<a class="link" href="glib-Basic-Types.html#gint">gint</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-get-string-number">g_regex_get_string_number</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
79
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name);
80
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-escape-string">g_regex_escape_string</a> (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
81
<a class="link" href="glib-Basic-Types.html#gint">gint</a> length);
82
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-simple">g_regex_match_simple</a> (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *pattern,
83
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
84
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
85
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);
86
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match">g_regex_match</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
87
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
88
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
89
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info);
90
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-full">g_regex_match_full</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
91
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
92
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
93
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
94
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
95
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info,
96
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
97
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all">g_regex_match_all</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
98
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
99
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
100
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info);
101
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full">g_regex_match_all_full</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
102
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
103
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
104
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
105
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
106
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info,
107
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
108
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>** <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split-simple">g_regex_split_simple</a> (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *pattern,
109
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
110
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
111
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);
112
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>** <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split">g_regex_split</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
113
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
114
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);
115
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>** <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split-full">g_regex_split_full</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
116
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
117
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
118
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
119
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
120
<a class="link" href="glib-Basic-Types.html#gint">gint</a> max_tokens,
121
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
122
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace">g_regex_replace</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
123
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
124
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
125
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
126
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *replacement,
127
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
128
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
129
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-literal">g_regex_replace_literal</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
130
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
131
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
132
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
133
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *replacement,
134
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
135
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
136
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-eval">g_regex_replace_eval</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
137
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
138
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
139
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
140
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
141
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexEvalCallback">GRegexEvalCallback</a> eval,
142
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data,
143
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
144
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-check-replacement">g_regex_check_replacement</a> (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *replacement,
145
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> *has_references,
146
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
147
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a>;
148
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-regex">g_match_info_get_regex</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);
149
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-string">g_match_info_get_string</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);
150
void <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-free">g_match_info_free</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);
151
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-matches">g_match_info_matches</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);
152
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-next">g_match_info_next</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
153
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
154
<a class="link" href="glib-Basic-Types.html#gint">gint</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-match-count">g_match_info_get_match_count</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);
155
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-is-partial-match">g_match_info_is_partial_match</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);
156
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-expand-references">g_match_info_expand_references</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
157
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string_to_expand,
158
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);
159
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch">g_match_info_fetch</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
160
<a class="link" href="glib-Basic-Types.html#gint">gint</a> match_num);
161
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-pos">g_match_info_fetch_pos</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
162
<a class="link" href="glib-Basic-Types.html#gint">gint</a> match_num,
163
<a class="link" href="glib-Basic-Types.html#gint">gint</a> *start_pos,
164
<a class="link" href="glib-Basic-Types.html#gint">gint</a> *end_pos);
165
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-named">g_match_info_fetch_named</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
166
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name);
167
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-named-pos">g_match_info_fetch_named_pos</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
168
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name,
169
<a class="link" href="glib-Basic-Types.html#gint">gint</a> *start_pos,
170
<a class="link" href="glib-Basic-Types.html#gint">gint</a> *end_pos);
171
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>** <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-all">g_match_info_fetch_all</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);
172
61
enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexError" title="enum GRegexError">GRegexError</a>;
62
#define <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-ERROR--CAPS" title="G_REGEX_ERROR">G_REGEX_ERROR</a>
63
enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags" title="enum GRegexCompileFlags">GRegexCompileFlags</a>;
64
enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a>;
65
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a>;
66
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexEvalCallback" title="GRegexEvalCallback ()">*GRegexEvalCallback</a>) (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
67
<a class="link" href="glib-Strings.html#GString" title="GString">GString</a> *result,
68
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);
69
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()">g_regex_new</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *pattern,
70
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags" title="enum GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
71
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
72
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
73
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-ref" title="g_regex_ref ()">g_regex_ref</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);
74
void <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-unref" title="g_regex_unref ()">g_regex_unref</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);
75
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-get-pattern" title="g_regex_get_pattern ()">g_regex_get_pattern</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);
76
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-get-max-backref" title="g_regex_get_max_backref ()">g_regex_get_max_backref</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);
77
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-get-capture-count" title="g_regex_get_capture_count ()">g_regex_get_capture_count</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);
78
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-get-string-number" title="g_regex_get_string_number ()">g_regex_get_string_number</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
79
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *name);
80
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-escape-string" title="g_regex_escape_string ()">g_regex_escape_string</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
81
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> length);
82
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-simple" title="g_regex_match_simple ()">g_regex_match_simple</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *pattern,
83
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
84
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags" title="enum GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
85
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options);
86
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match" title="g_regex_match ()">g_regex_match</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
87
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
88
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
89
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> **match_info);
90
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-full" title="g_regex_match_full ()">g_regex_match_full</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
91
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
92
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
93
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
94
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
95
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> **match_info,
96
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
97
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all" title="g_regex_match_all ()">g_regex_match_all</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
98
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
99
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
100
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> **match_info);
101
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full" title="g_regex_match_all_full ()">g_regex_match_all_full</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
102
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
103
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
104
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
105
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
106
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> **match_info,
107
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
108
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> ** <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split-simple" title="g_regex_split_simple ()">g_regex_split_simple</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *pattern,
109
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
110
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags" title="enum GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
111
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options);
112
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> ** <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split" title="g_regex_split ()">g_regex_split</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
113
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
114
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options);
115
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> ** <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split-full" title="g_regex_split_full ()">g_regex_split_full</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
116
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
117
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
118
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
119
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
120
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> max_tokens,
121
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
122
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace" title="g_regex_replace ()">g_regex_replace</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
123
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
124
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
125
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
126
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *replacement,
127
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
128
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
129
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-literal" title="g_regex_replace_literal ()">g_regex_replace_literal</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
130
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
131
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
132
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
133
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *replacement,
134
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
135
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
136
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-eval" title="g_regex_replace_eval ()">g_regex_replace_eval</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
137
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
138
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
139
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
140
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
141
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexEvalCallback" title="GRegexEvalCallback ()">GRegexEvalCallback</a> eval,
142
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data,
143
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
144
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-check-replacement" title="g_regex_check_replacement ()">g_regex_check_replacement</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *replacement,
145
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> *has_references,
146
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
147
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a>;
148
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-regex" title="g_match_info_get_regex ()">g_match_info_get_regex</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);
149
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-string" title="g_match_info_get_string ()">g_match_info_get_string</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);
150
void <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-free" title="g_match_info_free ()">g_match_info_free</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);
151
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-matches" title="g_match_info_matches ()">g_match_info_matches</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);
152
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-next" title="g_match_info_next ()">g_match_info_next</a> (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
153
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
154
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-match-count" title="g_match_info_get_match_count ()">g_match_info_get_match_count</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);
155
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-is-partial-match" title="g_match_info_is_partial_match ()">g_match_info_is_partial_match</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);
156
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-expand-references" title="g_match_info_expand_references ()">g_match_info_expand_references</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
157
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string_to_expand,
158
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);
159
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch" title="g_match_info_fetch ()">g_match_info_fetch</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
160
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> match_num);
161
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-pos" title="g_match_info_fetch_pos ()">g_match_info_fetch_pos</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
162
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> match_num,
163
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> *start_pos,
164
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> *end_pos);
165
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-named" title="g_match_info_fetch_named ()">g_match_info_fetch_named</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
166
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *name);
167
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-named-pos" title="g_match_info_fetch_named_pos ()">g_match_info_fetch_named_pos</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
168
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *name,
169
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> *start_pos,
170
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> *end_pos);
171
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> ** <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-all" title="g_match_info_fetch_all ()">g_match_info_fetch_all</a> (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);
173
172
</pre>
174
173
</div>
175
174
<div class="refsect1" lang="en">
176
<a name="id3201178"></a><h2>Description</h2>
175
<a name="glib-Perl-compatible-regular-expressions.description"></a><h2>Description</h2>
177
176
<p>
178
177
The <code class="function">g_regex_*()</code> functions implement regular
179
178
expression pattern matching using syntax and semantics similar to
182
181
<p>
183
182
Some functions accept a <em class="parameter"><code>start_position</code></em> argument,
184
183
setting it differs from just passing over a shortened string and setting
185
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL:CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern that begins with any kind
184
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL--CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern that begins with any kind
186
185
of lookbehind assertion.
187
186
For example, consider the pattern "\Biss\B" which finds occurrences of "iss"
188
187
in the middle of words. ("\B" matches only if the current position in the
195
194
to discover that it is preceded by a letter.
196
195
</p>
197
196
<p>
198
Note that, unless you set the <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-RAW:CAPS"><span class="type">G_REGEX_RAW</span></a> flag, all the strings passed
197
Note that, unless you set the <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-RAW--CAPS"><span class="type">G_REGEX_RAW</span></a> flag, all the strings passed
199
198
to these functions must be encoded in UTF-8. The lengths and the positions
200
199
inside the strings are in bytes and not in characters, so, for instance,
201
"\xc3\xa0" (i.e. "à") is two bytes long but it is treated as a single
202
character. If you set <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-RAW:CAPS"><span class="type">G_REGEX_RAW</span></a> the strings can be non-valid UTF-8
200
"\xc3\xa0" (i.e. "à") is two bytes long but it is treated as a single
201
character. If you set <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-RAW--CAPS"><span class="type">G_REGEX_RAW</span></a> the strings can be non-valid UTF-8
203
202
strings and a byte is treated as a character, so "\xc3\xa0" is two bytes
204
203
and two characters long.
205
204
</p>
215
214
<p>
216
215
The behaviour of the dot, circumflex, and dollar metacharacters are affected by
217
216
newline characters, the default is to recognize any newline character (the same
218
characters recognized by "\R"). This can be changed with <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-NEWLINE-CR:CAPS"><span class="type">G_REGEX_NEWLINE_CR</span></a>,
219
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-NEWLINE-LF:CAPS"><span class="type">G_REGEX_NEWLINE_LF</span></a> and <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-NEWLINE-CRLF:CAPS"><span class="type">G_REGEX_NEWLINE_CRLF</span></a> compile options,
220
and with <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NEWLINE-ANY:CAPS"><span class="type">G_REGEX_MATCH_NEWLINE_ANY</span></a>, <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NEWLINE-CR:CAPS"><span class="type">G_REGEX_MATCH_NEWLINE_CR</span></a>,
221
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NEWLINE-LF:CAPS"><span class="type">G_REGEX_MATCH_NEWLINE_LF</span></a> and <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NEWLINE-CRLF:CAPS"><span class="type">G_REGEX_MATCH_NEWLINE_CRLF</span></a> match options.
217
characters recognized by "\R"). This can be changed with <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-NEWLINE-CR--CAPS"><span class="type">G_REGEX_NEWLINE_CR</span></a>,
218
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-NEWLINE-LF--CAPS"><span class="type">G_REGEX_NEWLINE_LF</span></a> and <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-NEWLINE-CRLF--CAPS"><span class="type">G_REGEX_NEWLINE_CRLF</span></a> compile options,
219
and with <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NEWLINE-ANY--CAPS"><span class="type">G_REGEX_MATCH_NEWLINE_ANY</span></a>, <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NEWLINE-CR--CAPS"><span class="type">G_REGEX_MATCH_NEWLINE_CR</span></a>,
220
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NEWLINE-LF--CAPS"><span class="type">G_REGEX_MATCH_NEWLINE_LF</span></a> and <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NEWLINE-CRLF--CAPS"><span class="type">G_REGEX_MATCH_NEWLINE_CRLF</span></a> match options.
222
221
These settings are also relevant when compiling a pattern if
223
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-EXTENDED:CAPS"><span class="type">G_REGEX_EXTENDED</span></a> is set, and an unescaped "#" outside a character class is
222
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-EXTENDED--CAPS"><span class="type">G_REGEX_EXTENDED</span></a> is set, and an unescaped "#" outside a character class is
224
223
encountered. This indicates a comment that lasts until after the next
225
224
newline.
226
225
</p>
227
226
<p>
228
Creating and manipulating the same <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure from different
229
threads is not a problem as <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> does not modify its internal
230
state between creation and destruction, on the other hand <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> is
227
Creating and manipulating the same <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure from different
228
threads is not a problem as <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> does not modify its internal
229
state between creation and destruction, on the other hand <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> is
231
230
not threadsafe.
232
231
</p>
233
232
<p>
237
236
</p>
238
237
</div>
239
238
<div class="refsect1" lang="en">
240
<a name="id3201412"></a><h2>Details</h2>
239
<a name="glib-Perl-compatible-regular-expressions.details"></a><h2>Details</h2>
241
240
<div class="refsect2" lang="en">
242
<a name="id3201422"></a><h3>
243
<a name="GRegexError"></a>enum GRegexError</h3>
244
<a class="indexterm" name="id3201437"></a><pre class="programlisting">typedef enum
241
<a name="GRegexError"></a><h3>enum GRegexError</h3>
242
<pre class="programlisting">typedef enum
245
243
{
246
244
G_REGEX_ERROR_COMPILE,
247
245
G_REGEX_ERROR_OPTIMIZE,
296
294
<col align="left" valign="top">
297
295
<tbody>
298
296
<tr>
299
<td><p><span class="term"><a name="G-REGEX-ERROR-COMPILE:CAPS"></a><code class="literal">G_REGEX_ERROR_COMPILE</code></span></p></td>
297
<td><p><a name="G-REGEX-ERROR-COMPILE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_COMPILE</code></span></p></td>
300
298
<td>Compilation of the regular expression failed.
301
299
</td>
302
300
</tr>
303
301
<tr>
304
<td><p><span class="term"><a name="G-REGEX-ERROR-OPTIMIZE:CAPS"></a><code class="literal">G_REGEX_ERROR_OPTIMIZE</code></span></p></td>
302
<td><p><a name="G-REGEX-ERROR-OPTIMIZE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_OPTIMIZE</code></span></p></td>
305
303
<td>Optimization of the regular expression failed.
306
304
</td>
307
305
</tr>
308
306
<tr>
309
<td><p><span class="term"><a name="G-REGEX-ERROR-REPLACE:CAPS"></a><code class="literal">G_REGEX_ERROR_REPLACE</code></span></p></td>
307
<td><p><a name="G-REGEX-ERROR-REPLACE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_REPLACE</code></span></p></td>
310
308
<td>Replacement failed due to an ill-formed replacement string.
311
309
</td>
312
310
</tr>
313
311
<tr>
314
<td><p><span class="term"><a name="G-REGEX-ERROR-MATCH:CAPS"></a><code class="literal">G_REGEX_ERROR_MATCH</code></span></p></td>
312
<td><p><a name="G-REGEX-ERROR-MATCH--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_MATCH</code></span></p></td>
315
313
<td>The match process failed.
316
314
</td>
317
315
</tr>
318
316
<tr>
319
<td><p><span class="term"><a name="G-REGEX-ERROR-INTERNAL:CAPS"></a><code class="literal">G_REGEX_ERROR_INTERNAL</code></span></p></td>
317
<td><p><a name="G-REGEX-ERROR-INTERNAL--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_INTERNAL</code></span></p></td>
320
318
<td>Internal error of the regular expression engine. Since 2.16
321
319
</td>
322
320
</tr>
323
321
<tr>
324
<td><p><span class="term"><a name="G-REGEX-ERROR-STRAY-BACKSLASH:CAPS"></a><code class="literal">G_REGEX_ERROR_STRAY_BACKSLASH</code></span></p></td>
322
<td><p><a name="G-REGEX-ERROR-STRAY-BACKSLASH--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_STRAY_BACKSLASH</code></span></p></td>
325
323
<td>"\\" at end of pattern. Since 2.16
326
324
</td>
327
325
</tr>
328
326
<tr>
329
<td><p><span class="term"><a name="G-REGEX-ERROR-MISSING-CONTROL-CHAR:CAPS"></a><code class="literal">G_REGEX_ERROR_MISSING_CONTROL_CHAR</code></span></p></td>
327
<td><p><a name="G-REGEX-ERROR-MISSING-CONTROL-CHAR--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_MISSING_CONTROL_CHAR</code></span></p></td>
330
328
<td>"\\c" at end of pattern. Since 2.16
331
329
</td>
332
330
</tr>
333
331
<tr>
334
<td><p><span class="term"><a name="G-REGEX-ERROR-UNRECOGNIZED-ESCAPE:CAPS"></a><code class="literal">G_REGEX_ERROR_UNRECOGNIZED_ESCAPE</code></span></p></td>
332
<td><p><a name="G-REGEX-ERROR-UNRECOGNIZED-ESCAPE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_UNRECOGNIZED_ESCAPE</code></span></p></td>
335
333
<td>Unrecognized character follows "\\". Since 2.16
336
334
</td>
337
335
</tr>
338
336
<tr>
339
<td><p><span class="term"><a name="G-REGEX-ERROR-QUANTIFIERS-OUT-OF-ORDER:CAPS"></a><code class="literal">G_REGEX_ERROR_QUANTIFIERS_OUT_OF_ORDER</code></span></p></td>
337
<td><p><a name="G-REGEX-ERROR-QUANTIFIERS-OUT-OF-ORDER--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_QUANTIFIERS_OUT_OF_ORDER</code></span></p></td>
340
338
<td>Numbers out of order in "{}" quantifier. Since 2.16
341
339
</td>
342
340
</tr>
343
341
<tr>
344
<td><p><span class="term"><a name="G-REGEX-ERROR-QUANTIFIER-TOO-BIG:CAPS"></a><code class="literal">G_REGEX_ERROR_QUANTIFIER_TOO_BIG</code></span></p></td>
342
<td><p><a name="G-REGEX-ERROR-QUANTIFIER-TOO-BIG--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_QUANTIFIER_TOO_BIG</code></span></p></td>
345
343
<td>Number too big in "{}" quantifier. Since 2.16
346
344
</td>
347
345
</tr>
348
346
<tr>
349
<td><p><span class="term"><a name="G-REGEX-ERROR-UNTERMINATED-CHARACTER-CLASS:CAPS"></a><code class="literal">G_REGEX_ERROR_UNTERMINATED_CHARACTER_CLASS</code></span></p></td>
347
<td><p><a name="G-REGEX-ERROR-UNTERMINATED-CHARACTER-CLASS--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_UNTERMINATED_CHARACTER_CLASS</code></span></p></td>
350
348
<td>Missing terminating "]" for character class. Since 2.16
351
349
</td>
352
350
</tr>
353
351
<tr>
354
<td><p><span class="term"><a name="G-REGEX-ERROR-INVALID-ESCAPE-IN-CHARACTER-CLASS:CAPS"></a><code class="literal">G_REGEX_ERROR_INVALID_ESCAPE_IN_CHARACTER_CLASS</code></span></p></td>
352
<td><p><a name="G-REGEX-ERROR-INVALID-ESCAPE-IN-CHARACTER-CLASS--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_INVALID_ESCAPE_IN_CHARACTER_CLASS</code></span></p></td>
355
353
<td>Invalid escape sequence in character class. Since 2.16
356
354
</td>
357
355
</tr>
358
356
<tr>
359
<td><p><span class="term"><a name="G-REGEX-ERROR-RANGE-OUT-OF-ORDER:CAPS"></a><code class="literal">G_REGEX_ERROR_RANGE_OUT_OF_ORDER</code></span></p></td>
357
<td><p><a name="G-REGEX-ERROR-RANGE-OUT-OF-ORDER--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_RANGE_OUT_OF_ORDER</code></span></p></td>
360
358
<td>Range out of order in character class. Since 2.16
361
359
</td>
362
360
</tr>
363
361
<tr>
364
<td><p><span class="term"><a name="G-REGEX-ERROR-NOTHING-TO-REPEAT:CAPS"></a><code class="literal">G_REGEX_ERROR_NOTHING_TO_REPEAT</code></span></p></td>
362
<td><p><a name="G-REGEX-ERROR-NOTHING-TO-REPEAT--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_NOTHING_TO_REPEAT</code></span></p></td>
365
363
<td>Nothing to repeat. Since 2.16
366
364
</td>
367
365
</tr>
368
366
<tr>
369
<td><p><span class="term"><a name="G-REGEX-ERROR-UNRECOGNIZED-CHARACTER:CAPS"></a><code class="literal">G_REGEX_ERROR_UNRECOGNIZED_CHARACTER</code></span></p></td>
367
<td><p><a name="G-REGEX-ERROR-UNRECOGNIZED-CHARACTER--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_UNRECOGNIZED_CHARACTER</code></span></p></td>
370
368
<td>Unrecognized character after "(?", "(?<" or "(?P". Since 2.16
371
369
</td>
372
370
</tr>
373
371
<tr>
374
<td><p><span class="term"><a name="G-REGEX-ERROR-POSIX-NAMED-CLASS-OUTSIDE-CLASS:CAPS"></a><code class="literal">G_REGEX_ERROR_POSIX_NAMED_CLASS_OUTSIDE_CLASS</code></span></p></td>
372
<td><p><a name="G-REGEX-ERROR-POSIX-NAMED-CLASS-OUTSIDE-CLASS--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_POSIX_NAMED_CLASS_OUTSIDE_CLASS</code></span></p></td>
375
373
<td>POSIX named classes are supported only within a class. Since 2.16
376
374
</td>
377
375
</tr>
378
376
<tr>
379
<td><p><span class="term"><a name="G-REGEX-ERROR-UNMATCHED-PARENTHESIS:CAPS"></a><code class="literal">G_REGEX_ERROR_UNMATCHED_PARENTHESIS</code></span></p></td>
377
<td><p><a name="G-REGEX-ERROR-UNMATCHED-PARENTHESIS--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_UNMATCHED_PARENTHESIS</code></span></p></td>
380
378
<td>Missing terminating ")" or ")" without opening "(". Since 2.16
381
379
</td>
382
380
</tr>
383
381
<tr>
384
<td><p><span class="term"><a name="G-REGEX-ERROR-INEXISTENT-SUBPATTERN-REFERENCE:CAPS"></a><code class="literal">G_REGEX_ERROR_INEXISTENT_SUBPATTERN_REFERENCE</code></span></p></td>
382
<td><p><a name="G-REGEX-ERROR-INEXISTENT-SUBPATTERN-REFERENCE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_INEXISTENT_SUBPATTERN_REFERENCE</code></span></p></td>
385
383
<td>Reference to non-existent subpattern. Since 2.16
386
384
</td>
387
385
</tr>
388
386
<tr>
389
<td><p><span class="term"><a name="G-REGEX-ERROR-UNTERMINATED-COMMENT:CAPS"></a><code class="literal">G_REGEX_ERROR_UNTERMINATED_COMMENT</code></span></p></td>
387
<td><p><a name="G-REGEX-ERROR-UNTERMINATED-COMMENT--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_UNTERMINATED_COMMENT</code></span></p></td>
390
388
<td>Missing terminating ")" after comment. Since 2.16
391
389
</td>
392
390
</tr>
393
391
<tr>
394
<td><p><span class="term"><a name="G-REGEX-ERROR-EXPRESSION-TOO-LARGE:CAPS"></a><code class="literal">G_REGEX_ERROR_EXPRESSION_TOO_LARGE</code></span></p></td>
392
<td><p><a name="G-REGEX-ERROR-EXPRESSION-TOO-LARGE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_EXPRESSION_TOO_LARGE</code></span></p></td>
395
393
<td>Regular expression too large. Since 2.16
396
394
</td>
397
395
</tr>
398
396
<tr>
399
<td><p><span class="term"><a name="G-REGEX-ERROR-MEMORY-ERROR:CAPS"></a><code class="literal">G_REGEX_ERROR_MEMORY_ERROR</code></span></p></td>
397
<td><p><a name="G-REGEX-ERROR-MEMORY-ERROR--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_MEMORY_ERROR</code></span></p></td>
400
398
<td>Failed to get memory. Since 2.16
401
399
</td>
402
400
</tr>
403
401
<tr>
404
<td><p><span class="term"><a name="G-REGEX-ERROR-VARIABLE-LENGTH-LOOKBEHIND:CAPS"></a><code class="literal">G_REGEX_ERROR_VARIABLE_LENGTH_LOOKBEHIND</code></span></p></td>
402
<td><p><a name="G-REGEX-ERROR-VARIABLE-LENGTH-LOOKBEHIND--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_VARIABLE_LENGTH_LOOKBEHIND</code></span></p></td>
405
403
<td>Lookbehind assertion is not fixed length. Since 2.16
406
404
</td>
407
405
</tr>
408
406
<tr>
409
<td><p><span class="term"><a name="G-REGEX-ERROR-MALFORMED-CONDITION:CAPS"></a><code class="literal">G_REGEX_ERROR_MALFORMED_CONDITION</code></span></p></td>
407
<td><p><a name="G-REGEX-ERROR-MALFORMED-CONDITION--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_MALFORMED_CONDITION</code></span></p></td>
410
408
<td>Malformed number or name after "(?(". Since 2.16
411
409
</td>
412
410
</tr>
413
411
<tr>
414
<td><p><span class="term"><a name="G-REGEX-ERROR-TOO-MANY-CONDITIONAL-BRANCHES:CAPS"></a><code class="literal">G_REGEX_ERROR_TOO_MANY_CONDITIONAL_BRANCHES</code></span></p></td>
412
<td><p><a name="G-REGEX-ERROR-TOO-MANY-CONDITIONAL-BRANCHES--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_TOO_MANY_CONDITIONAL_BRANCHES</code></span></p></td>
415
413
<td>Conditional group contains more than two branches. Since 2.16
416
414
</td>
417
415
</tr>
418
416
<tr>
419
<td><p><span class="term"><a name="G-REGEX-ERROR-ASSERTION-EXPECTED:CAPS"></a><code class="literal">G_REGEX_ERROR_ASSERTION_EXPECTED</code></span></p></td>
417
<td><p><a name="G-REGEX-ERROR-ASSERTION-EXPECTED--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_ASSERTION_EXPECTED</code></span></p></td>
420
418
<td>Assertion expected after "(?(". Since 2.16
421
419
</td>
422
420
</tr>
423
421
<tr>
424
<td><p><span class="term"><a name="G-REGEX-ERROR-UNKNOWN-POSIX-CLASS-NAME:CAPS"></a><code class="literal">G_REGEX_ERROR_UNKNOWN_POSIX_CLASS_NAME</code></span></p></td>
422
<td><p><a name="G-REGEX-ERROR-UNKNOWN-POSIX-CLASS-NAME--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_UNKNOWN_POSIX_CLASS_NAME</code></span></p></td>
425
423
<td>Unknown POSIX class name. Since 2.16
426
424
</td>
427
425
</tr>
428
426
<tr>
429
<td><p><span class="term"><a name="G-REGEX-ERROR-POSIX-COLLATING-ELEMENTS-NOT-SUPPORTED:CAPS"></a><code class="literal">G_REGEX_ERROR_POSIX_COLLATING_ELEMENTS_NOT_SUPPORTED</code></span></p></td>
427
<td><p><a name="G-REGEX-ERROR-POSIX-COLLATING-ELEMENTS-NOT-SUPPORTED--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_POSIX_COLLATING_ELEMENTS_NOT_SUPPORTED</code></span></p></td>
430
428
<td>POSIX collating elements are not supported. Since 2.16
431
429
</td>
432
430
</tr>
433
431
<tr>
434
<td><p><span class="term"><a name="G-REGEX-ERROR-HEX-CODE-TOO-LARGE:CAPS"></a><code class="literal">G_REGEX_ERROR_HEX_CODE_TOO_LARGE</code></span></p></td>
432
<td><p><a name="G-REGEX-ERROR-HEX-CODE-TOO-LARGE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_HEX_CODE_TOO_LARGE</code></span></p></td>
435
433
<td>Character value in "\\x{...}" sequence is too large. Since 2.16
436
434
</td>
437
435
</tr>
438
436
<tr>
439
<td><p><span class="term"><a name="G-REGEX-ERROR-INVALID-CONDITION:CAPS"></a><code class="literal">G_REGEX_ERROR_INVALID_CONDITION</code></span></p></td>
437
<td><p><a name="G-REGEX-ERROR-INVALID-CONDITION--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_INVALID_CONDITION</code></span></p></td>
440
438
<td>Invalid condition "(?(0)". Since 2.16
441
439
</td>
442
440
</tr>
443
441
<tr>
444
<td><p><span class="term"><a name="G-REGEX-ERROR-SINGLE-BYTE-MATCH-IN-LOOKBEHIND:CAPS"></a><code class="literal">G_REGEX_ERROR_SINGLE_BYTE_MATCH_IN_LOOKBEHIND</code></span></p></td>
442
<td><p><a name="G-REGEX-ERROR-SINGLE-BYTE-MATCH-IN-LOOKBEHIND--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_SINGLE_BYTE_MATCH_IN_LOOKBEHIND</code></span></p></td>
445
443
<td>\\C not allowed in lookbehind assertion. Since 2.16
446
444
</td>
447
445
</tr>
448
446
<tr>
449
<td><p><span class="term"><a name="G-REGEX-ERROR-INFINITE-LOOP:CAPS"></a><code class="literal">G_REGEX_ERROR_INFINITE_LOOP</code></span></p></td>
447
<td><p><a name="G-REGEX-ERROR-INFINITE-LOOP--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_INFINITE_LOOP</code></span></p></td>
450
448
<td>Recursive call could loop indefinitely. Since 2.16
451
449
</td>
452
450
</tr>
453
451
<tr>
454
<td><p><span class="term"><a name="G-REGEX-ERROR-MISSING-SUBPATTERN-NAME-TERMINATOR:CAPS"></a><code class="literal">G_REGEX_ERROR_MISSING_SUBPATTERN_NAME_TERMINATOR</code></span></p></td>
452
<td><p><a name="G-REGEX-ERROR-MISSING-SUBPATTERN-NAME-TERMINATOR--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_MISSING_SUBPATTERN_NAME_TERMINATOR</code></span></p></td>
455
453
<td>Missing terminator in subpattern name. Since 2.16
456
454
</td>
457
455
</tr>
458
456
<tr>
459
<td><p><span class="term"><a name="G-REGEX-ERROR-DUPLICATE-SUBPATTERN-NAME:CAPS"></a><code class="literal">G_REGEX_ERROR_DUPLICATE_SUBPATTERN_NAME</code></span></p></td>
457
<td><p><a name="G-REGEX-ERROR-DUPLICATE-SUBPATTERN-NAME--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_DUPLICATE_SUBPATTERN_NAME</code></span></p></td>
460
458
<td>Two named subpatterns have the same name. Since 2.16
461
459
</td>
462
460
</tr>
463
461
<tr>
464
<td><p><span class="term"><a name="G-REGEX-ERROR-MALFORMED-PROPERTY:CAPS"></a><code class="literal">G_REGEX_ERROR_MALFORMED_PROPERTY</code></span></p></td>
462
<td><p><a name="G-REGEX-ERROR-MALFORMED-PROPERTY--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_MALFORMED_PROPERTY</code></span></p></td>
465
463
<td>Malformed "\\P" or "\\p" sequence. Since 2.16
466
464
</td>
467
465
</tr>
468
466
<tr>
469
<td><p><span class="term"><a name="G-REGEX-ERROR-UNKNOWN-PROPERTY:CAPS"></a><code class="literal">G_REGEX_ERROR_UNKNOWN_PROPERTY</code></span></p></td>
467
<td><p><a name="G-REGEX-ERROR-UNKNOWN-PROPERTY--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_UNKNOWN_PROPERTY</code></span></p></td>
470
468
<td>Unknown property name after "\\P" or "\\p". Since 2.16
471
469
</td>
472
470
</tr>
473
471
<tr>
474
<td><p><span class="term"><a name="G-REGEX-ERROR-SUBPATTERN-NAME-TOO-LONG:CAPS"></a><code class="literal">G_REGEX_ERROR_SUBPATTERN_NAME_TOO_LONG</code></span></p></td>
472
<td><p><a name="G-REGEX-ERROR-SUBPATTERN-NAME-TOO-LONG--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_SUBPATTERN_NAME_TOO_LONG</code></span></p></td>
475
473
<td>Subpattern name is too long (maximum 32 characters). Since 2.16
476
474
</td>
477
475
</tr>
478
476
<tr>
479
<td><p><span class="term"><a name="G-REGEX-ERROR-TOO-MANY-SUBPATTERNS:CAPS"></a><code class="literal">G_REGEX_ERROR_TOO_MANY_SUBPATTERNS</code></span></p></td>
477
<td><p><a name="G-REGEX-ERROR-TOO-MANY-SUBPATTERNS--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_TOO_MANY_SUBPATTERNS</code></span></p></td>
480
478
<td>Too many named subpatterns (maximum 10,000). Since 2.16
481
479
</td>
482
480
</tr>
483
481
<tr>
484
<td><p><span class="term"><a name="G-REGEX-ERROR-INVALID-OCTAL-VALUE:CAPS"></a><code class="literal">G_REGEX_ERROR_INVALID_OCTAL_VALUE</code></span></p></td>
482
<td><p><a name="G-REGEX-ERROR-INVALID-OCTAL-VALUE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_INVALID_OCTAL_VALUE</code></span></p></td>
485
483
<td>Octal value is greater than "\\377". Since 2.16
486
484
</td>
487
485
</tr>
488
486
<tr>
489
<td><p><span class="term"><a name="G-REGEX-ERROR-TOO-MANY-BRANCHES-IN-DEFINE:CAPS"></a><code class="literal">G_REGEX_ERROR_TOO_MANY_BRANCHES_IN_DEFINE</code></span></p></td>
487
<td><p><a name="G-REGEX-ERROR-TOO-MANY-BRANCHES-IN-DEFINE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_TOO_MANY_BRANCHES_IN_DEFINE</code></span></p></td>
490
488
<td>"DEFINE" group contains more than one branch. Since 2.16
491
489
</td>
492
490
</tr>
493
491
<tr>
494
<td><p><span class="term"><a name="G-REGEX-ERROR-DEFINE-REPETION:CAPS"></a><code class="literal">G_REGEX_ERROR_DEFINE_REPETION</code></span></p></td>
492
<td><p><a name="G-REGEX-ERROR-DEFINE-REPETION--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_DEFINE_REPETION</code></span></p></td>
495
493
<td>Repeating a "DEFINE" group is not allowed. Since 2.16
496
494
</td>
497
495
</tr>
498
496
<tr>
499
<td><p><span class="term"><a name="G-REGEX-ERROR-INCONSISTENT-NEWLINE-OPTIONS:CAPS"></a><code class="literal">G_REGEX_ERROR_INCONSISTENT_NEWLINE_OPTIONS</code></span></p></td>
497
<td><p><a name="G-REGEX-ERROR-INCONSISTENT-NEWLINE-OPTIONS--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_INCONSISTENT_NEWLINE_OPTIONS</code></span></p></td>
500
498
<td>Inconsistent newline options. Since 2.16
501
499
</td>
502
500
</tr>
503
501
<tr>
504
<td><p><span class="term"><a name="G-REGEX-ERROR-MISSING-BACK-REFERENCE:CAPS"></a><code class="literal">G_REGEX_ERROR_MISSING_BACK_REFERENCE</code></span></p></td>
502
<td><p><a name="G-REGEX-ERROR-MISSING-BACK-REFERENCE--CAPS"></a><span class="term"><code class="literal">G_REGEX_ERROR_MISSING_BACK_REFERENCE</code></span></p></td>
505
503
<td>"\\g" is not followed by a braced name or an
506
504
optionally braced non-zero number. Since 2.16
507
505
</td>
508
506
</tr>
509
507
</tbody>
510
508
</table></div>
511
<p class="since">Since 2.14
512
513
</p>
509
<p class="since">Since 2.14</p>
514
510
</div>
515
511
<hr>
516
512
<div class="refsect2" lang="en">
517
<a name="id3202529"></a><h3>
518
<a name="G-REGEX-ERROR:CAPS"></a>G_REGEX_ERROR</h3>
519
<a class="indexterm" name="id3202544"></a><pre class="programlisting">#define G_REGEX_ERROR g_regex_error_quark ()
513
<a name="G-REGEX-ERROR--CAPS"></a><h3>G_REGEX_ERROR</h3>
514
<pre class="programlisting">#define G_REGEX_ERROR g_regex_error_quark ()
520
515
</pre>
521
516
<p>
522
Error domain for regular expressions. Errors in this domain will be from the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexError"><span class="type">GRegexError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for information on error domains.
523
</p>
524
<p class="since">Since 2.14
525
526
527
</p>
517
Error domain for regular expressions. Errors in this domain will be from the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexError" title="enum GRegexError"><span class="type">GRegexError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> for information on error domains.
518
</p>
519
<p class="since">Since 2.14</p>
528
520
</div>
529
521
<hr>
530
522
<div class="refsect2" lang="en">
531
<a name="id3202584"></a><h3>
532
<a name="GRegexCompileFlags"></a>enum GRegexCompileFlags</h3>
533
<a class="indexterm" name="id3202600"></a><pre class="programlisting">typedef enum
523
<a name="GRegexCompileFlags"></a><h3>enum GRegexCompileFlags</h3>
524
<pre class="programlisting">typedef enum
534
525
{
535
526
G_REGEX_CASELESS = 1 << 0,
536
527
G_REGEX_MULTILINE = 1 << 1,
555
546
<col align="left" valign="top">
556
547
<tbody>
557
548
<tr>
558
<td><p><span class="term"><a name="G-REGEX-CASELESS:CAPS"></a><code class="literal">G_REGEX_CASELESS</code></span></p></td>
549
<td><p><a name="G-REGEX-CASELESS--CAPS"></a><span class="term"><code class="literal">G_REGEX_CASELESS</code></span></p></td>
559
550
<td>Letters in the pattern match both upper and lower case
560
551
letters. It be changed within a pattern by a "(?i)" option setting.
561
552
</td>
562
553
</tr>
563
554
<tr>
564
<td><p><span class="term"><a name="G-REGEX-MULTILINE:CAPS"></a><code class="literal">G_REGEX_MULTILINE</code></span></p></td>
555
<td><p><a name="G-REGEX-MULTILINE--CAPS"></a><span class="term"><code class="literal">G_REGEX_MULTILINE</code></span></p></td>
565
556
<td>By default, GRegex treats the strings as consisting
566
557
of a single line of characters (even if it actually contains newlines).
567
558
The "start of line" metacharacter ("^") matches only at the start of the
568
559
string, while the "end of line" metacharacter ("$") matches only at the
569
560
end of the string, or before a terminating newline (unless
570
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-DOLLAR-ENDONLY:CAPS"><span class="type">G_REGEX_DOLLAR_ENDONLY</span></a> is set). When <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MULTILINE:CAPS"><span class="type">G_REGEX_MULTILINE</span></a> is set,
561
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-DOLLAR-ENDONLY--CAPS"><span class="type">G_REGEX_DOLLAR_ENDONLY</span></a> is set). When <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MULTILINE--CAPS"><span class="type">G_REGEX_MULTILINE</span></a> is set,
571
562
the "start of line" and "end of line" constructs match immediately following
572
563
or immediately before any newline in the string, respectively, as well
573
564
as at the very start and end. This can be changed within a pattern by a
575
566
</td>
576
567
</tr>
577
568
<tr>
578
<td><p><span class="term"><a name="G-REGEX-DOTALL:CAPS"></a><code class="literal">G_REGEX_DOTALL</code></span></p></td>
569
<td><p><a name="G-REGEX-DOTALL--CAPS"></a><span class="term"><code class="literal">G_REGEX_DOTALL</code></span></p></td>
579
570
<td>A dot metacharater (".") in the pattern matches all
580
571
characters, including newlines. Without it, newlines are excluded. This
581
572
option can be changed within a pattern by a ("?s") option setting.
582
573
</td>
583
574
</tr>
584
575
<tr>
585
<td><p><span class="term"><a name="G-REGEX-EXTENDED:CAPS"></a><code class="literal">G_REGEX_EXTENDED</code></span></p></td>
576
<td><p><a name="G-REGEX-EXTENDED--CAPS"></a><span class="term"><code class="literal">G_REGEX_EXTENDED</code></span></p></td>
586
577
<td>Whitespace data characters in the pattern are
587
578
totally ignored except when escaped or inside a character class.
588
579
Whitespace does not include the VT character (code 11). In addition,
592
583
</td>
593
584
</tr>
594
585
<tr>
595
<td><p><span class="term"><a name="G-REGEX-ANCHORED:CAPS"></a><code class="literal">G_REGEX_ANCHORED</code></span></p></td>
586
<td><p><a name="G-REGEX-ANCHORED--CAPS"></a><span class="term"><code class="literal">G_REGEX_ANCHORED</code></span></p></td>
596
587
<td>The pattern is forced to be "anchored", that is,
597
588
it is constrained to match only at the first matching point in the string
598
589
that is being searched. This effect can also be achieved by appropriate
600
591
</td>
601
592
</tr>
602
593
<tr>
603
<td><p><span class="term"><a name="G-REGEX-DOLLAR-ENDONLY:CAPS"></a><code class="literal">G_REGEX_DOLLAR_ENDONLY</code></span></p></td>
594
<td><p><a name="G-REGEX-DOLLAR-ENDONLY--CAPS"></a><span class="term"><code class="literal">G_REGEX_DOLLAR_ENDONLY</code></span></p></td>
604
595
<td>A dollar metacharacter ("$") in the pattern
605
596
matches only at the end of the string. Without this option, a dollar also
606
597
matches immediately before the final character if it is a newline (but
607
598
not before any other newlines). This option is ignored if
608
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MULTILINE:CAPS"><span class="type">G_REGEX_MULTILINE</span></a> is set.
599
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MULTILINE--CAPS"><span class="type">G_REGEX_MULTILINE</span></a> is set.
609
600
</td>
610
601
</tr>
611
602
<tr>
612
<td><p><span class="term"><a name="G-REGEX-UNGREEDY:CAPS"></a><code class="literal">G_REGEX_UNGREEDY</code></span></p></td>
603
<td><p><a name="G-REGEX-UNGREEDY--CAPS"></a><span class="term"><code class="literal">G_REGEX_UNGREEDY</code></span></p></td>
613
604
<td>Inverts the "greediness" of the
614
605
quantifiers so that they are not greedy by default, but become greedy
615
606
if followed by "?". It can also be set by a "(?U)" option setting within
617
608
</td>
618
609
</tr>
619
610
<tr>
620
<td><p><span class="term"><a name="G-REGEX-RAW:CAPS"></a><code class="literal">G_REGEX_RAW</code></span></p></td>
611
<td><p><a name="G-REGEX-RAW--CAPS"></a><span class="term"><code class="literal">G_REGEX_RAW</code></span></p></td>
621
612
<td>Usually strings must be valid UTF-8 strings, using this
622
613
flag they are considered as a raw sequence of bytes.
623
614
</td>
624
615
</tr>
625
616
<tr>
626
<td><p><span class="term"><a name="G-REGEX-NO-AUTO-CAPTURE:CAPS"></a><code class="literal">G_REGEX_NO_AUTO_CAPTURE</code></span></p></td>
617
<td><p><a name="G-REGEX-NO-AUTO-CAPTURE--CAPS"></a><span class="term"><code class="literal">G_REGEX_NO_AUTO_CAPTURE</code></span></p></td>
627
618
<td>Disables the use of numbered capturing
628
619
parentheses in the pattern. Any opening parenthesis that is not followed
629
620
by "?" behaves as if it were followed by "?:" but named parentheses can
631
622
</td>
632
623
</tr>
633
624
<tr>
634
<td><p><span class="term"><a name="G-REGEX-OPTIMIZE:CAPS"></a><code class="literal">G_REGEX_OPTIMIZE</code></span></p></td>
625
<td><p><a name="G-REGEX-OPTIMIZE--CAPS"></a><span class="term"><code class="literal">G_REGEX_OPTIMIZE</code></span></p></td>
635
626
<td>Optimize the regular expression. If the pattern will
636
627
be used many times, then it may be worth the effort to optimize it to
637
628
improve the speed of matches.
638
629
</td>
639
630
</tr>
640
631
<tr>
641
<td><p><span class="term"><a name="G-REGEX-DUPNAMES:CAPS"></a><code class="literal">G_REGEX_DUPNAMES</code></span></p></td>
632
<td><p><a name="G-REGEX-DUPNAMES--CAPS"></a><span class="term"><code class="literal">G_REGEX_DUPNAMES</code></span></p></td>
642
633
<td>Names used to identify capturing subpatterns need not
643
634
be unique. This can be helpful for certain types of pattern when it is known
644
635
that only one instance of the named subpattern can ever be matched.
645
636
</td>
646
637
</tr>
647
638
<tr>
648
<td><p><span class="term"><a name="G-REGEX-NEWLINE-CR:CAPS"></a><code class="literal">G_REGEX_NEWLINE_CR</code></span></p></td>
639
<td><p><a name="G-REGEX-NEWLINE-CR--CAPS"></a><span class="term"><code class="literal">G_REGEX_NEWLINE_CR</code></span></p></td>
649
640
<td>Usually any newline character is recognized, if this
650
641
option is set, the only recognized newline character is '\r'.
651
642
</td>
652
643
</tr>
653
644
<tr>
654
<td><p><span class="term"><a name="G-REGEX-NEWLINE-LF:CAPS"></a><code class="literal">G_REGEX_NEWLINE_LF</code></span></p></td>
645
<td><p><a name="G-REGEX-NEWLINE-LF--CAPS"></a><span class="term"><code class="literal">G_REGEX_NEWLINE_LF</code></span></p></td>
655
646
<td>Usually any newline character is recognized, if this
656
647
option is set, the only recognized newline character is '\n'.
657
648
</td>
658
649
</tr>
659
650
<tr>
660
<td><p><span class="term"><a name="G-REGEX-NEWLINE-CRLF:CAPS"></a><code class="literal">G_REGEX_NEWLINE_CRLF</code></span></p></td>
651
<td><p><a name="G-REGEX-NEWLINE-CRLF--CAPS"></a><span class="term"><code class="literal">G_REGEX_NEWLINE_CRLF</code></span></p></td>
661
652
<td>Usually any newline character is recognized, if this
662
653
option is set, the only recognized newline character sequence is '\r\n'.
663
654
</td>
664
655
</tr>
665
656
</tbody>
666
657
</table></div>
667
<p class="since">Since 2.14
668
669
</p>
658
<p class="since">Since 2.14</p>
670
659
</div>
671
660
<hr>
672
661
<div class="refsect2" lang="en">
673
<a name="id3203024"></a><h3>
674
<a name="GRegexMatchFlags"></a>enum GRegexMatchFlags</h3>
675
<a class="indexterm" name="id3203040"></a><pre class="programlisting">typedef enum
662
<a name="GRegexMatchFlags"></a><h3>enum GRegexMatchFlags</h3>
663
<pre class="programlisting">typedef enum
676
664
{
677
665
G_REGEX_MATCH_ANCHORED = 1 << 4,
678
666
G_REGEX_MATCH_NOTBOL = 1 << 7,
692
680
<col align="left" valign="top">
693
681
<tbody>
694
682
<tr>
695
<td><p><span class="term"><a name="G-REGEX-MATCH-ANCHORED:CAPS"></a><code class="literal">G_REGEX_MATCH_ANCHORED</code></span></p></td>
683
<td><p><a name="G-REGEX-MATCH-ANCHORED--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_ANCHORED</code></span></p></td>
696
684
<td>The pattern is forced to be "anchored", that is,
697
685
it is constrained to match only at the first matching point in the string
698
686
that is being searched. This effect can also be achieved by appropriate
700
688
</td>
701
689
</tr>
702
690
<tr>
703
<td><p><span class="term"><a name="G-REGEX-MATCH-NOTBOL:CAPS"></a><code class="literal">G_REGEX_MATCH_NOTBOL</code></span></p></td>
691
<td><p><a name="G-REGEX-MATCH-NOTBOL--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_NOTBOL</code></span></p></td>
704
692
<td>Specifies that first character of the string is
705
693
not the beginning of a line, so the circumflex metacharacter should not
706
694
match before it. Setting this without G_REGEX_MULTILINE (at compile time)
709
697
</td>
710
698
</tr>
711
699
<tr>
712
<td><p><span class="term"><a name="G-REGEX-MATCH-NOTEOL:CAPS"></a><code class="literal">G_REGEX_MATCH_NOTEOL</code></span></p></td>
700
<td><p><a name="G-REGEX-MATCH-NOTEOL--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_NOTEOL</code></span></p></td>
713
701
<td>Specifies that the end of the subject string is
714
702
not the end of a line, so the dollar metacharacter should not match it nor
715
703
(except in multiline mode) a newline immediately before it. Setting this
719
707
</td>
720
708
</tr>
721
709
<tr>
722
<td><p><span class="term"><a name="G-REGEX-MATCH-NOTEMPTY:CAPS"></a><code class="literal">G_REGEX_MATCH_NOTEMPTY</code></span></p></td>
710
<td><p><a name="G-REGEX-MATCH-NOTEMPTY--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_NOTEMPTY</code></span></p></td>
723
711
<td>An empty string is not considered to be a valid
724
712
match if this option is set. If there are alternatives in the pattern, they
725
713
are tried. If all the alternatives match the empty string, the entire match
730
718
</td>
731
719
</tr>
732
720
<tr>
733
<td><p><span class="term"><a name="G-REGEX-MATCH-PARTIAL:CAPS"></a><code class="literal">G_REGEX_MATCH_PARTIAL</code></span></p></td>
721
<td><p><a name="G-REGEX-MATCH-PARTIAL--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_PARTIAL</code></span></p></td>
734
722
<td>Turns on the partial matching feature, for more
735
documentation on partial matching see <code class="function">g_regex_is_partial_match()</code>.
736
</td>
737
</tr>
738
<tr>
739
<td><p><span class="term"><a name="G-REGEX-MATCH-NEWLINE-CR:CAPS"></a><code class="literal">G_REGEX_MATCH_NEWLINE_CR</code></span></p></td>
740
<td>Overrides the newline definition set when creating
741
a new <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a>, setting the '\r' character as line terminator.
742
</td>
743
</tr>
744
<tr>
745
<td><p><span class="term"><a name="G-REGEX-MATCH-NEWLINE-LF:CAPS"></a><code class="literal">G_REGEX_MATCH_NEWLINE_LF</code></span></p></td>
746
<td>Overrides the newline definition set when creating
747
a new <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a>, setting the '\n' character as line terminator.
748
</td>
749
</tr>
750
<tr>
751
<td><p><span class="term"><a name="G-REGEX-MATCH-NEWLINE-CRLF:CAPS"></a><code class="literal">G_REGEX_MATCH_NEWLINE_CRLF</code></span></p></td>
752
<td>Overrides the newline definition set when creating
753
a new <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a>, setting the '\r\n' characters as line terminator.
754
</td>
755
</tr>
756
<tr>
757
<td><p><span class="term"><a name="G-REGEX-MATCH-NEWLINE-ANY:CAPS"></a><code class="literal">G_REGEX_MATCH_NEWLINE_ANY</code></span></p></td>
758
<td>Overrides the newline definition set when creating
759
a new <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a>, any newline character or character sequence is recognized.
723
documentation on partial matching see <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-is-partial-match" title="g_match_info_is_partial_match ()"><code class="function">g_match_info_is_partial_match()</code></a>.
724
</td>
725
</tr>
726
<tr>
727
<td><p><a name="G-REGEX-MATCH-NEWLINE-CR--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_NEWLINE_CR</code></span></p></td>
728
<td>Overrides the newline definition set when creating
729
a new <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a>, setting the '\r' character as line terminator.
730
</td>
731
</tr>
732
<tr>
733
<td><p><a name="G-REGEX-MATCH-NEWLINE-LF--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_NEWLINE_LF</code></span></p></td>
734
<td>Overrides the newline definition set when creating
735
a new <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a>, setting the '\n' character as line terminator.
736
</td>
737
</tr>
738
<tr>
739
<td><p><a name="G-REGEX-MATCH-NEWLINE-CRLF--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_NEWLINE_CRLF</code></span></p></td>
740
<td>Overrides the newline definition set when creating
741
a new <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a>, setting the '\r\n' characters as line terminator.
742
</td>
743
</tr>
744
<tr>
745
<td><p><a name="G-REGEX-MATCH-NEWLINE-ANY--CAPS"></a><span class="term"><code class="literal">G_REGEX_MATCH_NEWLINE_ANY</code></span></p></td>
746
<td>Overrides the newline definition set when creating
747
a new <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a>, any newline character or character sequence is recognized.
760
748
</td>
761
749
</tr>
762
750
</tbody>
763
751
</table></div>
764
<p class="since">Since 2.14
765
766
</p>
752
<p class="since">Since 2.14</p>
767
753
</div>
768
754
<hr>
769
755
<div class="refsect2" lang="en">
770
<a name="id3203353"></a><h3>
771
<a name="GRegex"></a>GRegex</h3>
772
<a class="indexterm" name="id3203367"></a><pre class="programlisting">typedef struct _GRegex GRegex;</pre>
756
<a name="GRegex"></a><h3>GRegex</h3>
757
<pre class="programlisting">typedef struct _GRegex GRegex;</pre>
773
758
<p>
774
759
A GRegex is the "compiled" form of a regular expression pattern. This
775
760
structure is opaque and its fields cannot be accessed directly.
776
761
</p>
777
<p class="since">Since 2.14
778
779
</p>
762
<p class="since">Since 2.14</p>
780
763
</div>
781
764
<hr>
782
765
<div class="refsect2" lang="en">
783
<a name="id3203391"></a><h3>
784
<a name="GRegexEvalCallback"></a>GRegexEvalCallback ()</h3>
785
<a class="indexterm" name="id3203407"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> (*GRegexEvalCallback) (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
786
<a class="link" href="glib-Strings.html#GString">GString</a> *result,
787
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
766
<a name="GRegexEvalCallback"></a><h3>GRegexEvalCallback ()</h3>
767
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> (*GRegexEvalCallback) (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
768
<a class="link" href="glib-Strings.html#GString" title="GString">GString</a> *result,
769
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);</pre>
788
770
<p>
789
Specifies the type of the function passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-eval"><code class="function">g_regex_replace_eval()</code></a>.
771
Specifies the type of the function passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-eval" title="g_regex_replace_eval ()"><code class="function">g_regex_replace_eval()</code></a>.
790
772
It is called for each occurance of the pattern in the string passed
791
to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-eval"><code class="function">g_regex_replace_eval()</code></a>, and it should append the replacement to
773
to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-eval" title="g_regex_replace_eval ()"><code class="function">g_regex_replace_eval()</code></a>, and it should append the replacement to
792
774
<em class="parameter"><code>result</code></em>.
793
775
</p>
794
776
<div class="variablelist"><table border="0">
795
777
<col align="left" valign="top">
796
778
<tbody>
797
779
<tr>
798
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
799
<td>the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> generated by the match.
800
Use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-regex"><code class="function">g_match_info_get_regex()</code></a> and <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-string"><code class="function">g_match_info_get_string()</code></a> if you
801
need the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> or the matched string.
802
</td>
803
</tr>
804
<tr>
805
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
806
<td>a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a> containing the new string
807
</td>
808
</tr>
809
<tr>
810
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
811
<td>user data passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-eval"><code class="function">g_regex_replace_eval()</code></a>
812
</td>
813
</tr>
814
<tr>
815
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
816
<td>
817
<a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to continue the replacement process, <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop it
780
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
781
<td>the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> generated by the match.
782
Use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-regex" title="g_match_info_get_regex ()"><code class="function">g_match_info_get_regex()</code></a> and <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-string" title="g_match_info_get_string ()"><code class="function">g_match_info_get_string()</code></a> if you
783
need the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> or the matched string.
784
</td>
785
</tr>
786
<tr>
787
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
788
<td>a <a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> containing the new string
789
</td>
790
</tr>
791
<tr>
792
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
793
<td>user data passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-eval" title="g_regex_replace_eval ()"><code class="function">g_regex_replace_eval()</code></a>
794
</td>
795
</tr>
796
<tr>
797
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
798
<td>%FALSE to continue the replacement process, <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> to stop it
818
799
</td>
819
800
</tr>
820
801
</tbody>
821
802
</table></div>
822
<p class="since">Since 2.14
823
824
825
</p>
803
<p class="since">Since 2.14</p>
826
804
</div>
827
805
<hr>
828
806
<div class="refsect2" lang="en">
829
<a name="id3203622"></a><h3>
830
<a name="g-regex-new"></a>g_regex_new ()</h3>
831
<a class="indexterm" name="id3203636"></a><pre class="programlisting"><a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a>* g_regex_new (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *pattern,
832
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
833
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
834
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
807
<a name="g-regex-new"></a><h3>g_regex_new ()</h3>
808
<pre class="programlisting"><a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> * g_regex_new (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *pattern,
809
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags" title="enum GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
810
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
811
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
835
812
<p>
836
813
Compiles the regular expression to an internal form, and does
837
the initial setup of the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure.</p>
814
the initial setup of the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure.</p>
838
815
<p>
839
840
816
</p>
841
817
<div class="variablelist"><table border="0">
842
818
<col align="left" valign="top">
843
819
<tbody>
844
820
<tr>
845
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
821
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
846
822
<td> the regular expression
847
823
</td>
848
824
</tr>
849
825
<tr>
850
<td><p><span class="term"><em class="parameter"><code>compile_options</code></em> :</span></p></td>
826
<td><p><span class="term"><em class="parameter"><code>compile_options</code></em> :</span></p></td>
851
827
<td> compile options for the regular expression
852
828
</td>
853
829
</tr>
854
830
<tr>
855
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
831
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
856
832
<td> match options for the regular expression
857
833
</td>
858
834
</tr>
859
835
<tr>
860
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
861
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
836
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
837
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
862
838
</td>
863
839
</tr>
864
840
<tr>
865
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
866
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure. Call <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-unref"><code class="function">g_regex_unref()</code></a> when you
841
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
842
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure. Call <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-unref" title="g_regex_unref ()"><code class="function">g_regex_unref()</code></a> when you
867
843
are done with it
868
844
869
845
</td>
870
846
</tr>
871
847
</tbody>
872
848
</table></div>
873
<p class="since">Since 2.14
874
</p>
849
<p class="since">Since 2.14</p>
875
850
</div>
876
851
<hr>
877
852
<div class="refsect2" lang="en">
878
<a name="id3203808"></a><h3>
879
<a name="g-regex-ref"></a>g_regex_ref ()</h3>
880
<a class="indexterm" name="id3203822"></a><pre class="programlisting"><a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a>* g_regex_ref (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);</pre>
853
<a name="g-regex-ref"></a><h3>g_regex_ref ()</h3>
854
<pre class="programlisting"><a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> * g_regex_ref (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);</pre>
881
855
<p>
882
856
Increases reference count of <em class="parameter"><code>regex</code></em> by 1.</p>
883
857
<p>
884
885
858
</p>
886
859
<div class="variablelist"><table border="0">
887
860
<col align="left" valign="top">
888
861
<tbody>
889
862
<tr>
890
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
891
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a>
863
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
864
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a>
892
865
</td>
893
866
</tr>
894
867
<tr>
895
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
868
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
896
869
<td> <em class="parameter"><code>regex</code></em>
897
870
898
871
</td>
899
872
</tr>
900
873
</tbody>
901
874
</table></div>
902
<p class="since">Since 2.14
903
</p>
875
<p class="since">Since 2.14</p>
904
876
</div>
905
877
<hr>
906
878
<div class="refsect2" lang="en">
907
<a name="id3203908"></a><h3>
908
<a name="g-regex-unref"></a>g_regex_unref ()</h3>
909
<a class="indexterm" name="id3203924"></a><pre class="programlisting">void g_regex_unref (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);</pre>
879
<a name="g-regex-unref"></a><h3>g_regex_unref ()</h3>
880
<pre class="programlisting">void g_regex_unref (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);</pre>
910
881
<p>
911
882
Decreases reference count of <em class="parameter"><code>regex</code></em> by 1. When reference count drops
912
883
to zero, it frees all the memory associated with the regex structure.</p>
913
884
<p>
914
915
885
</p>
916
886
<div class="variablelist"><table border="0">
917
887
<col align="left" valign="top">
918
888
<tbody><tr>
919
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
920
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a>
889
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
890
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a>
921
891
</td>
922
892
</tr></tbody>
923
893
</table></div>
924
<p class="since">Since 2.14
925
</p>
894
<p class="since">Since 2.14</p>
926
895
</div>
927
896
<hr>
928
897
<div class="refsect2" lang="en">
929
<a name="id3203996"></a><h3>
930
<a name="g-regex-get-pattern"></a>g_regex_get_pattern ()</h3>
931
<a class="indexterm" name="id3204012"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_regex_get_pattern (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);</pre>
898
<a name="g-regex-get-pattern"></a><h3>g_regex_get_pattern ()</h3>
899
<pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_regex_get_pattern (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);</pre>
932
900
<p>
933
901
Gets the pattern string associated with <em class="parameter"><code>regex</code></em>, i.e. a copy of
934
the string passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>.</p>
902
the string passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>.</p>
935
903
<p>
936
937
904
</p>
938
905
<div class="variablelist"><table border="0">
939
906
<col align="left" valign="top">
940
907
<tbody>
941
908
<tr>
942
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
943
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure
909
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
910
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure
944
911
</td>
945
912
</tr>
946
913
<tr>
947
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
914
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
948
915
<td> the pattern of <em class="parameter"><code>regex</code></em>
949
916
950
917
</td>
951
918
</tr>
952
919
</tbody>
953
920
</table></div>
954
<p class="since">Since 2.14
955
</p>
921
<p class="since">Since 2.14</p>
956
922
</div>
957
923
<hr>
958
924
<div class="refsect2" lang="en">
959
<a name="id3204111"></a><h3>
960
<a name="g-regex-get-max-backref"></a>g_regex_get_max_backref ()</h3>
961
<a class="indexterm" name="id3204126"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a> g_regex_get_max_backref (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);</pre>
925
<a name="g-regex-get-max-backref"></a><h3>g_regex_get_max_backref ()</h3>
926
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> g_regex_get_max_backref (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);</pre>
962
927
<p>
963
928
Returns the number of the highest back reference
964
929
in the pattern, or 0 if the pattern does not contain
965
930
back references.</p>
966
931
<p>
967
968
932
</p>
969
933
<div class="variablelist"><table border="0">
970
934
<col align="left" valign="top">
971
935
<tbody>
972
936
<tr>
973
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
974
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a>
937
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
938
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a>
975
939
</td>
976
940
</tr>
977
941
<tr>
978
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
942
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
979
943
<td> the number of the highest back reference
980
944
981
945
</td>
982
946
</tr>
983
947
</tbody>
984
948
</table></div>
985
<p class="since">Since 2.14
986
</p>
949
<p class="since">Since 2.14</p>
987
950
</div>
988
951
<hr>
989
952
<div class="refsect2" lang="en">
990
<a name="id3204204"></a><h3>
991
<a name="g-regex-get-capture-count"></a>g_regex_get_capture_count ()</h3>
992
<a class="indexterm" name="id3204220"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a> g_regex_get_capture_count (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex);</pre>
953
<a name="g-regex-get-capture-count"></a><h3>g_regex_get_capture_count ()</h3>
954
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> g_regex_get_capture_count (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex);</pre>
993
955
<p>
994
956
Returns the number of capturing subpatterns in the pattern.</p>
995
957
<p>
996
997
958
</p>
998
959
<div class="variablelist"><table border="0">
999
960
<col align="left" valign="top">
1000
961
<tbody>
1001
962
<tr>
1002
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1003
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a>
963
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
964
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a>
1004
965
</td>
1005
966
</tr>
1006
967
<tr>
1007
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
968
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1008
969
<td> the number of capturing subpatterns
1009
970
1010
971
</td>
1011
972
</tr>
1012
973
</tbody>
1013
974
</table></div>
1014
<p class="since">Since 2.14
1015
</p>
975
<p class="since">Since 2.14</p>
1016
976
</div>
1017
977
<hr>
1018
978
<div class="refsect2" lang="en">
1019
<a name="id3204295"></a><h3>
1020
<a name="g-regex-get-string-number"></a>g_regex_get_string_number ()</h3>
1021
<a class="indexterm" name="id3204311"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a> g_regex_get_string_number (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1022
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name);</pre>
979
<a name="g-regex-get-string-number"></a><h3>g_regex_get_string_number ()</h3>
980
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> g_regex_get_string_number (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
981
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *name);</pre>
1023
982
<p>
1024
983
Retrieves the number of the subexpression named <em class="parameter"><code>name</code></em>.</p>
1025
984
<p>
1026
1027
985
</p>
1028
986
<div class="variablelist"><table border="0">
1029
987
<col align="left" valign="top">
1030
988
<tbody>
1031
989
<tr>
1032
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1033
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure
990
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
991
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure
1034
992
</td>
1035
993
</tr>
1036
994
<tr>
1037
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
995
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1038
996
<td> name of the subexpression
1039
997
</td>
1040
998
</tr>
1041
999
<tr>
1042
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1000
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1043
1001
<td> The number of the subexpression or -1 if <em class="parameter"><code>name</code></em>
1044
1002
does not exists
1045
1003
1047
1005
</tr>
1048
1006
</tbody>
1049
1007
</table></div>
1050
<p class="since">Since 2.14
1051
</p>
1008
<p class="since">Since 2.14</p>
1052
1009
</div>
1053
1010
<hr>
1054
1011
<div class="refsect2" lang="en">
1055
<a name="id3204421"></a><h3>
1056
<a name="g-regex-escape-string"></a>g_regex_escape_string ()</h3>
1057
<a class="indexterm" name="id3204436"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_regex_escape_string (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1058
<a class="link" href="glib-Basic-Types.html#gint">gint</a> length);</pre>
1012
<a name="g-regex-escape-string"></a><h3>g_regex_escape_string ()</h3>
1013
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_regex_escape_string (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1014
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> length);</pre>
1059
1015
<p>
1060
1016
Escapes the special characters used for regular expressions
1061
1017
in <em class="parameter"><code>string</code></em>, for instance "a.b*c" becomes "a\.b\*c". This
1066
1022
in this case remember to specify the correct length of <em class="parameter"><code>string</code></em>
1067
1023
in <em class="parameter"><code>length</code></em>.</p>
1068
1024
<p>
1069
1070
1025
</p>
1071
1026
<div class="variablelist"><table border="0">
1072
1027
<col align="left" valign="top">
1073
1028
<tbody>
1074
1029
<tr>
1075
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1030
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1076
1031
<td> the string to escape
1077
1032
</td>
1078
1033
</tr>
1079
1034
<tr>
1080
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1035
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1081
1036
<td> the length of <em class="parameter"><code>string</code></em>, or -1 if <em class="parameter"><code>string</code></em> is nul-terminated
1082
1037
</td>
1083
1038
</tr>
1084
1039
<tr>
1085
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1040
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1086
1041
<td> a newly-allocated escaped string
1087
1042
1088
1043
</td>
1089
1044
</tr>
1090
1045
</tbody>
1091
1046
</table></div>
1092
<p class="since">Since 2.14
1093
</p>
1047
<p class="since">Since 2.14</p>
1094
1048
</div>
1095
1049
<hr>
1096
1050
<div class="refsect2" lang="en">
1097
<a name="id3204569"></a><h3>
1098
<a name="g-regex-match-simple"></a>g_regex_match_simple ()</h3>
1099
<a class="indexterm" name="id3204584"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_regex_match_simple (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *pattern,
1100
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1101
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
1102
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);</pre>
1051
<a name="g-regex-match-simple"></a><h3>g_regex_match_simple ()</h3>
1052
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_regex_match_simple (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *pattern,
1053
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1054
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags" title="enum GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
1055
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options);</pre>
1103
1056
<p>
1104
1057
Scans for a match in <em class="parameter"><code>string</code></em> for <em class="parameter"><code>pattern</code></em>.
1105
1058
</p>
1106
1059
<p>
1107
This function is equivalent to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match"><code class="function">g_regex_match()</code></a> but it does not
1108
require to compile the pattern with <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>, avoiding some
1060
This function is equivalent to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match" title="g_regex_match ()"><code class="function">g_regex_match()</code></a> but it does not
1061
require to compile the pattern with <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>, avoiding some
1109
1062
lines of code when you need just to do a match without extracting
1110
1063
substrings, capture counts, and so on.
1111
1064
</p>
1112
1065
<p>
1113
1066
If this function is to be called on the same <em class="parameter"><code>pattern</code></em> more than
1114
1067
once, it's more efficient to compile the pattern once with
1115
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a> and then use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match"><code class="function">g_regex_match()</code></a>.</p>
1068
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a> and then use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match" title="g_regex_match ()"><code class="function">g_regex_match()</code></a>.</p>
1116
1069
<p>
1117
1118
1070
</p>
1119
1071
<div class="variablelist"><table border="0">
1120
1072
<col align="left" valign="top">
1121
1073
<tbody>
1122
1074
<tr>
1123
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1075
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1124
1076
<td> the regular expression
1125
1077
</td>
1126
1078
</tr>
1127
1079
<tr>
1128
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1080
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1129
1081
<td> the string to scan for matches
1130
1082
</td>
1131
1083
</tr>
1132
1084
<tr>
1133
<td><p><span class="term"><em class="parameter"><code>compile_options</code></em> :</span></p></td>
1085
<td><p><span class="term"><em class="parameter"><code>compile_options</code></em> :</span></p></td>
1134
1086
<td> compile options for the regular expression
1135
1087
</td>
1136
1088
</tr>
1137
1089
<tr>
1138
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1090
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1139
1091
<td> match options
1140
1092
</td>
1141
1093
</tr>
1142
1094
<tr>
1143
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1144
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
1095
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1096
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
1145
1097
1146
1098
</td>
1147
1099
</tr>
1148
1100
</tbody>
1149
1101
</table></div>
1150
<p class="since">Since 2.14
1151
</p>
1102
<p class="since">Since 2.14</p>
1152
1103
</div>
1153
1104
<hr>
1154
1105
<div class="refsect2" lang="en">
1155
<a name="id3204812"></a><h3>
1156
<a name="g-regex-match"></a>g_regex_match ()</h3>
1157
<a class="indexterm" name="id3204827"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_regex_match (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1158
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1159
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1160
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info);</pre>
1106
<a name="g-regex-match"></a><h3>g_regex_match ()</h3>
1107
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_regex_match (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1108
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1109
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1110
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> **match_info);</pre>
1161
1111
<p>
1162
1112
Scans for a match in string for the pattern in <em class="parameter"><code>regex</code></em>.
1163
1113
The <em class="parameter"><code>match_options</code></em> are combined with the match options specified
1164
1114
when the <em class="parameter"><code>regex</code></em> structure was created, letting you have more
1165
flexibility in reusing <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structures.
1115
flexibility in reusing <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structures.
1166
1116
</p>
1167
1117
<p>
1168
A <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure, used to get information on the match,
1169
is stored in <em class="parameter"><code>match_info</code></em> if not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Note that if <em class="parameter"><code>match_info</code></em>
1170
is not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is created even if the function returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>,
1118
A <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure, used to get information on the match,
1119
is stored in <em class="parameter"><code>match_info</code></em> if not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>. Note that if <em class="parameter"><code>match_info</code></em>
1120
is not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> then it is created even if the function returns <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a>,
1171
1121
i.e. you must free it regardless if regular expression actually matched.
1172
1122
</p>
1173
1123
<p>
1174
1124
To retrieve all the non-overlapping matches of the pattern in
1175
string you can use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-next"><code class="function">g_match_info_next()</code></a>.
1125
string you can use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-next" title="g_match_info_next ()"><code class="function">g_match_info_next()</code></a>.
1176
1126
</p>
1177
1127
<p>
1178
1128
</p>
1183
1133
/* Print all uppercase-only words. */
1184
1134
GRegex *regex;
1185
1135
GMatchInfo *match_info;
1186
 
1136
1187
1137
regex = g_regex_new ("[A-Z]+", 0, 0, NULL);
1188
1138
g_regex_match (regex, string, 0, &match_info);
1189
1139
while (g_match_info_matches (match_info))
1198
1148
}
1199
1149
</pre></div>
1200
1150
<p>
1201
1202
1151
</p>
1203
1152
<div class="variablelist"><table border="0">
1204
1153
<col align="left" valign="top">
1205
1154
<tbody>
1206
1155
<tr>
1207
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1208
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>
1156
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1157
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>
1209
1158
</td>
1210
1159
</tr>
1211
1160
<tr>
1212
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1161
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1213
1162
<td> the string to scan for matches
1214
1163
</td>
1215
1164
</tr>
1216
1165
<tr>
1217
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1166
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1218
1167
<td> match options
1219
1168
</td>
1220
1169
</tr>
1221
1170
<tr>
1222
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
1223
<td> pointer to location where to store the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a>,
1224
or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you do not need it
1171
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
1172
<td> pointer to location where to store the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a>,
1173
or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if you do not need it
1225
1174
</td>
1226
1175
</tr>
1227
1176
<tr>
1228
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1229
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
1177
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1178
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
1230
1179
1231
1180
</td>
1232
1181
</tr>
1233
1182
</tbody>
1234
1183
</table></div>
1235
<p class="since">Since 2.14
1236
</p>
1184
<p class="since">Since 2.14</p>
1237
1185
</div>
1238
1186
<hr>
1239
1187
<div class="refsect2" lang="en">
1240
<a name="id3205154"></a><h3>
1241
<a name="g-regex-match-full"></a>g_regex_match_full ()</h3>
1242
<a class="indexterm" name="id3205170"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_regex_match_full (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1243
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1244
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
1245
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
1246
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1247
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info,
1248
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
1188
<a name="g-regex-match-full"></a><h3>g_regex_match_full ()</h3>
1189
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_regex_match_full (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1190
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1191
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
1192
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
1193
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1194
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> **match_info,
1195
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
1249
1196
<p>
1250
1197
Scans for a match in string for the pattern in <em class="parameter"><code>regex</code></em>.
1251
1198
The <em class="parameter"><code>match_options</code></em> are combined with the match options specified
1252
1199
when the <em class="parameter"><code>regex</code></em> structure was created, letting you have more
1253
flexibility in reusing <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structures.
1200
flexibility in reusing <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structures.
1254
1201
</p>
1255
1202
<p>
1256
1203
Setting <em class="parameter"><code>start_position</code></em> differs from just passing over a shortened
1257
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL:CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern
1204
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL--CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern
1258
1205
that begins with any kind of lookbehind assertion, such as "\b".
1259
1206
</p>
1260
1207
<p>
1261
A <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure, used to get information on the match, is
1262
stored in <em class="parameter"><code>match_info</code></em> if not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Note that if <em class="parameter"><code>match_info</code></em> is
1263
not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is created even if the function returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>,
1208
A <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure, used to get information on the match, is
1209
stored in <em class="parameter"><code>match_info</code></em> if not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>. Note that if <em class="parameter"><code>match_info</code></em> is
1210
not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> then it is created even if the function returns <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a>,
1264
1211
i.e. you must free it regardless if regular expression actually
1265
1212
matched.
1266
1213
</p>
1267
1214
<p>
1268
<em class="parameter"><code>string</code></em> is not copied and is used in <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> internally. If
1269
you use any <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> method (except <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-free"><code class="function">g_match_info_free()</code></a>) after
1215
<em class="parameter"><code>string</code></em> is not copied and is used in <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> internally. If
1216
you use any <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> method (except <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-free" title="g_match_info_free ()"><code class="function">g_match_info_free()</code></a>) after
1270
1217
freeing or modifying <em class="parameter"><code>string</code></em> then the behaviour is undefined.
1271
1218
</p>
1272
1219
<p>
1273
1220
To retrieve all the non-overlapping matches of the pattern in
1274
string you can use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-next"><code class="function">g_match_info_next()</code></a>.
1221
string you can use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-next" title="g_match_info_next ()"><code class="function">g_match_info_next()</code></a>.
1275
1222
</p>
1276
1223
<p>
1277
1224
</p>
1283
1230
GRegex *regex;
1284
1231
GMatchInfo *match_info;
1285
1232
GError *error = NULL;
1286
 
1233
1287
1234
regex = g_regex_new ("[A-Z]+", 0, 0, NULL);
1288
1235
g_regex_match_full (regex, string, -1, 0, 0, &match_info, &error);
1289
1236
while (g_match_info_matches (match_info))
1303
1250
}
1304
1251
</pre></div>
1305
1252
<p>
1306
1307
1253
</p>
1308
1254
<div class="variablelist"><table border="0">
1309
1255
<col align="left" valign="top">
1310
1256
<tbody>
1311
1257
<tr>
1312
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1313
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>
1258
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1259
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>
1314
1260
</td>
1315
1261
</tr>
1316
1262
<tr>
1317
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1263
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1318
1264
<td> the string to scan for matches
1319
1265
</td>
1320
1266
</tr>
1321
1267
<tr>
1322
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1268
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1323
1269
<td> the length of <em class="parameter"><code>string</code></em>, or -1 if <em class="parameter"><code>string</code></em> is nul-terminated
1324
1270
</td>
1325
1271
</tr>
1326
1272
<tr>
1327
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1273
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1328
1274
<td> starting index of the string to match
1329
1275
</td>
1330
1276
</tr>
1331
1277
<tr>
1332
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1278
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1333
1279
<td> match options
1334
1280
</td>
1335
1281
</tr>
1336
1282
<tr>
1337
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
1338
<td> pointer to location where to store the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a>,
1339
or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you do not need it
1340
</td>
1341
</tr>
1342
<tr>
1343
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1344
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors
1345
</td>
1346
</tr>
1347
<tr>
1348
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1349
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
1283
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
1284
<td> pointer to location where to store the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a>,
1285
or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if you do not need it
1286
</td>
1287
</tr>
1288
<tr>
1289
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1290
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors
1291
</td>
1292
</tr>
1293
<tr>
1294
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1295
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
1350
1296
1351
1297
</td>
1352
1298
</tr>
1353
1299
</tbody>
1354
1300
</table></div>
1355
<p class="since">Since 2.14
1356
</p>
1301
<p class="since">Since 2.14</p>
1357
1302
</div>
1358
1303
<hr>
1359
1304
<div class="refsect2" lang="en">
1360
<a name="id3205648"></a><h3>
1361
<a name="g-regex-match-all"></a>g_regex_match_all ()</h3>
1362
<a class="indexterm" name="id3205663"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_regex_match_all (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1363
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1364
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1365
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info);</pre>
1305
<a name="g-regex-match-all"></a><h3>g_regex_match_all ()</h3>
1306
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_regex_match_all (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1307
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1308
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1309
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> **match_info);</pre>
1366
1310
<p>
1367
1311
Using the standard algorithm for regular expression matching only
1368
1312
the longest match in the string is retrieved. This function uses
1369
1313
a different algorithm so it can retrieve all the possible matches.
1370
For more documentation see <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full"><code class="function">g_regex_match_all_full()</code></a>.
1314
For more documentation see <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full" title="g_regex_match_all_full ()"><code class="function">g_regex_match_all_full()</code></a>.
1371
1315
</p>
1372
1316
<p>
1373
A <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure, used to get information on the match, is
1374
stored in <em class="parameter"><code>match_info</code></em> if not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Note that if <em class="parameter"><code>match_info</code></em> is
1375
not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is created even if the function returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>,
1317
A <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure, used to get information on the match, is
1318
stored in <em class="parameter"><code>match_info</code></em> if not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>. Note that if <em class="parameter"><code>match_info</code></em> is
1319
not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> then it is created even if the function returns <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a>,
1376
1320
i.e. you must free it regardless if regular expression actually
1377
1321
matched.</p>
1378
1322
<p>
1379
1380
1323
</p>
1381
1324
<div class="variablelist"><table border="0">
1382
1325
<col align="left" valign="top">
1383
1326
<tbody>
1384
1327
<tr>
1385
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1386
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>
1328
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1329
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>
1387
1330
</td>
1388
1331
</tr>
1389
1332
<tr>
1390
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1333
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1391
1334
<td> the string to scan for matches
1392
1335
</td>
1393
1336
</tr>
1394
1337
<tr>
1395
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1338
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1396
1339
<td> match options
1397
1340
</td>
1398
1341
</tr>
1399
1342
<tr>
1400
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
1401
<td> pointer to location where to store the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a>,
1402
or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you do not need it
1343
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
1344
<td> pointer to location where to store the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a>,
1345
or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if you do not need it
1403
1346
</td>
1404
1347
</tr>
1405
1348
<tr>
1406
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1407
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
1349
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1350
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
1408
1351
1409
1352
</td>
1410
1353
</tr>
1411
1354
</tbody>
1412
1355
</table></div>
1413
<p class="since">Since 2.14
1414
</p>
1356
<p class="since">Since 2.14</p>
1415
1357
</div>
1416
1358
<hr>
1417
1359
<div class="refsect2" lang="en">
1418
<a name="id3205924"></a><h3>
1419
<a name="g-regex-match-all-full"></a>g_regex_match_all_full ()</h3>
1420
<a class="indexterm" name="id3205940"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_regex_match_all_full (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1421
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1422
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
1423
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
1424
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1425
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info,
1426
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
1360
<a name="g-regex-match-all-full"></a><h3>g_regex_match_all_full ()</h3>
1361
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_regex_match_all_full (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1362
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1363
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
1364
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
1365
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1366
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> **match_info,
1367
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
1427
1368
<p>
1428
1369
Using the standard algorithm for regular expression matching only
1429
1370
the longest match in the string is retrieved, it is not possibile
1441
1382
</p>
1442
1383
<p>
1443
1384
The number of matched strings is retrieved using
1444
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-match-count"><code class="function">g_match_info_get_match_count()</code></a>. To obtain the matched strings and
1445
their position you can use, respectively, <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch"><code class="function">g_match_info_fetch()</code></a> and
1446
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-pos"><code class="function">g_match_info_fetch_pos()</code></a>. Note that the strings are returned in
1385
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-get-match-count" title="g_match_info_get_match_count ()"><code class="function">g_match_info_get_match_count()</code></a>. To obtain the matched strings and
1386
their position you can use, respectively, <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch" title="g_match_info_fetch ()"><code class="function">g_match_info_fetch()</code></a> and
1387
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-fetch-pos" title="g_match_info_fetch_pos ()"><code class="function">g_match_info_fetch_pos()</code></a>. Note that the strings are returned in
1447
1388
reverse order of length; that is, the longest matching string is
1448
1389
given first.
1449
1390
</p>
1453
1394
</p>
1454
1395
<p>
1455
1396
Setting <em class="parameter"><code>start_position</code></em> differs from just passing over a shortened
1456
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL:CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern
1397
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL--CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern
1457
1398
that begins with any kind of lookbehind assertion, such as "\b".
1458
1399
</p>
1459
1400
<p>
1460
A <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure, used to get information on the match, is
1461
stored in <em class="parameter"><code>match_info</code></em> if not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Note that if <em class="parameter"><code>match_info</code></em> is
1462
not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it is created even if the function returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>,
1401
A <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure, used to get information on the match, is
1402
stored in <em class="parameter"><code>match_info</code></em> if not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>. Note that if <em class="parameter"><code>match_info</code></em> is
1403
not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> then it is created even if the function returns <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a>,
1463
1404
i.e. you must free it regardless if regular expression actually
1464
1405
matched.</p>
1465
1406
<p>
1466
1467
1407
</p>
1468
1408
<div class="variablelist"><table border="0">
1469
1409
<col align="left" valign="top">
1470
1410
<tbody>
1471
1411
<tr>
1472
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1473
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>
1412
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1413
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>
1474
1414
</td>
1475
1415
</tr>
1476
1416
<tr>
1477
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1417
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1478
1418
<td> the string to scan for matches
1479
1419
</td>
1480
1420
</tr>
1481
1421
<tr>
1482
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1422
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1483
1423
<td> the length of <em class="parameter"><code>string</code></em>, or -1 if <em class="parameter"><code>string</code></em> is nul-terminated
1484
1424
</td>
1485
1425
</tr>
1486
1426
<tr>
1487
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1427
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1488
1428
<td> starting index of the string to match
1489
1429
</td>
1490
1430
</tr>
1491
1431
<tr>
1492
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1432
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1493
1433
<td> match options
1494
1434
</td>
1495
1435
</tr>
1496
1436
<tr>
1497
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
1498
<td> pointer to location where to store the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a>,
1499
or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you do not need it
1500
</td>
1501
</tr>
1502
<tr>
1503
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1504
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors
1505
</td>
1506
</tr>
1507
<tr>
1508
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1509
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
1437
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
1438
<td> pointer to location where to store the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a>,
1439
or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if you do not need it
1440
</td>
1441
</tr>
1442
<tr>
1443
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1444
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors
1445
</td>
1446
</tr>
1447
<tr>
1448
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1449
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
1510
1450
1511
1451
</td>
1512
1452
</tr>
1513
1453
</tbody>
1514
1454
</table></div>
1515
<p class="since">Since 2.14
1516
</p>
1455
<p class="since">Since 2.14</p>
1517
1456
</div>
1518
1457
<hr>
1519
1458
<div class="refsect2" lang="en">
1520
<a name="id3206360"></a><h3>
1521
<a name="g-regex-split-simple"></a>g_regex_split_simple ()</h3>
1522
<a class="indexterm" name="id3206376"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>** g_regex_split_simple (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *pattern,
1523
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1524
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
1525
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);</pre>
1459
<a name="g-regex-split-simple"></a><h3>g_regex_split_simple ()</h3>
1460
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> ** g_regex_split_simple (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *pattern,
1461
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1462
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags" title="enum GRegexCompileFlags">GRegexCompileFlags</a> compile_options,
1463
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options);</pre>
1526
1464
<p>
1527
1465
Breaks the string on the pattern, and returns an array of
1528
1466
the tokens. If the pattern contains capturing parentheses,
1531
1469
whole string is returned as the first token.
1532
1470
</p>
1533
1471
<p>
1534
This function is equivalent to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split"><code class="function">g_regex_split()</code></a> but it does
1535
not require to compile the pattern with <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>, avoiding
1472
This function is equivalent to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split" title="g_regex_split ()"><code class="function">g_regex_split()</code></a> but it does
1473
not require to compile the pattern with <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>, avoiding
1536
1474
some lines of code when you need just to do a split without
1537
1475
extracting substrings, capture counts, and so on.
1538
1476
</p>
1539
1477
<p>
1540
1478
If this function is to be called on the same <em class="parameter"><code>pattern</code></em> more than
1541
1479
once, it's more efficient to compile the pattern once with
1542
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a> and then use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split"><code class="function">g_regex_split()</code></a>.
1480
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a> and then use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-split" title="g_regex_split ()"><code class="function">g_regex_split()</code></a>.
1543
1481
</p>
1544
1482
<p>
1545
1483
As a special case, the result of splitting the empty string ""
1556
1494
characters. For example splitting "ab c" using as a separator
1557
1495
"\s*", you will get "a", "b" and "c".</p>
1558
1496
<p>
1559
1560
1497
</p>
1561
1498
<div class="variablelist"><table border="0">
1562
1499
<col align="left" valign="top">
1563
1500
<tbody>
1564
1501
<tr>
1565
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1502
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
1566
1503
<td> the regular expression
1567
1504
</td>
1568
1505
</tr>
1569
1506
<tr>
1570
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1507
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1571
1508
<td> the string to scan for matches
1572
1509
</td>
1573
1510
</tr>
1574
1511
<tr>
1575
<td><p><span class="term"><em class="parameter"><code>compile_options</code></em> :</span></p></td>
1512
<td><p><span class="term"><em class="parameter"><code>compile_options</code></em> :</span></p></td>
1576
1513
<td> compile options for the regular expression
1577
1514
</td>
1578
1515
</tr>
1579
1516
<tr>
1580
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1517
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1581
1518
<td> match options
1582
1519
</td>
1583
1520
</tr>
1584
1521
<tr>
1585
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1586
<td> a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated gchar ** array. Free it using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>
1522
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1523
<td> a <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated gchar ** array. Free it using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>
1587
1524
1588
1525
</td>
1589
1526
</tr>
1590
1527
</tbody>
1591
1528
</table></div>
1592
<p class="since">Since 2.14
1593
</p>
1529
<p class="since">Since 2.14</p>
1594
1530
</div>
1595
1531
<hr>
1596
1532
<div class="refsect2" lang="en">
1597
<a name="id3206619"></a><h3>
1598
<a name="g-regex-split"></a>g_regex_split ()</h3>
1599
<a class="indexterm" name="id3206634"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>** g_regex_split (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1600
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1601
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);</pre>
1533
<a name="g-regex-split"></a><h3>g_regex_split ()</h3>
1534
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> ** g_regex_split (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1535
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1536
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options);</pre>
1602
1537
<p>
1603
1538
Breaks the string on the pattern, and returns an array of the tokens.
1604
1539
If the pattern contains capturing parentheses, then the text for each
1620
1555
For example splitting "ab c" using as a separator "\s*", you will get
1621
1556
"a", "b" and "c".</p>
1622
1557
<p>
1623
1624
1558
</p>
1625
1559
<div class="variablelist"><table border="0">
1626
1560
<col align="left" valign="top">
1627
1561
<tbody>
1628
1562
<tr>
1629
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1630
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure
1563
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1564
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure
1631
1565
</td>
1632
1566
</tr>
1633
1567
<tr>
1634
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1568
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1635
1569
<td> the string to split with the pattern
1636
1570
</td>
1637
1571
</tr>
1638
1572
<tr>
1639
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1573
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1640
1574
<td> match time option flags
1641
1575
</td>
1642
1576
</tr>
1643
1577
<tr>
1644
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1645
<td> a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated gchar ** array. Free it using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>
1578
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1579
<td> a <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated gchar ** array. Free it using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>
1646
1580
1647
1581
</td>
1648
1582
</tr>
1649
1583
</tbody>
1650
1584
</table></div>
1651
<p class="since">Since 2.14
1652
</p>
1585
<p class="since">Since 2.14</p>
1653
1586
</div>
1654
1587
<hr>
1655
1588
<div class="refsect2" lang="en">
1656
<a name="id3206802"></a><h3>
1657
<a name="g-regex-split-full"></a>g_regex_split_full ()</h3>
1658
<a class="indexterm" name="id3206817"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>** g_regex_split_full (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1659
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1660
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
1661
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
1662
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1663
<a class="link" href="glib-Basic-Types.html#gint">gint</a> max_tokens,
1664
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
1589
<a name="g-regex-split-full"></a><h3>g_regex_split_full ()</h3>
1590
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> ** g_regex_split_full (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1591
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1592
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
1593
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
1594
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1595
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> max_tokens,
1596
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
1665
1597
<p>
1666
1598
Breaks the string on the pattern, and returns an array of the tokens.
1667
1599
If the pattern contains capturing parentheses, then the text for each
1685
1617
</p>
1686
1618
<p>
1687
1619
Setting <em class="parameter"><code>start_position</code></em> differs from just passing over a shortened
1688
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL:CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern
1620
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL--CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern
1689
1621
that begins with any kind of lookbehind assertion, such as "\b".</p>
1690
1622
<p>
1691
1692
1623
</p>
1693
1624
<div class="variablelist"><table border="0">
1694
1625
<col align="left" valign="top">
1695
1626
<tbody>
1696
1627
<tr>
1697
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1698
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure
1628
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1629
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure
1699
1630
</td>
1700
1631
</tr>
1701
1632
<tr>
1702
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1633
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1703
1634
<td> the string to split with the pattern
1704
1635
</td>
1705
1636
</tr>
1706
1637
<tr>
1707
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1638
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1708
1639
<td> the length of <em class="parameter"><code>string</code></em>, or -1 if <em class="parameter"><code>string</code></em> is nul-terminated
1709
1640
</td>
1710
1641
</tr>
1711
1642
<tr>
1712
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1643
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1713
1644
<td> starting index of the string to match
1714
1645
</td>
1715
1646
</tr>
1716
1647
<tr>
1717
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1648
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1718
1649
<td> match time option flags
1719
1650
</td>
1720
1651
</tr>
1721
1652
<tr>
1722
<td><p><span class="term"><em class="parameter"><code>max_tokens</code></em> :</span></p></td>
1653
<td><p><span class="term"><em class="parameter"><code>max_tokens</code></em> :</span></p></td>
1723
1654
<td> the maximum number of tokens to split <em class="parameter"><code>string</code></em> into.
1724
1655
If this is less than 1, the string is split completely
1725
1656
</td>
1726
1657
</tr>
1727
1658
<tr>
1728
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1729
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
1659
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1660
<td> return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a>
1730
1661
</td>
1731
1662
</tr>
1732
1663
<tr>
1733
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1734
<td> a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated gchar ** array. Free it using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>
1664
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1665
<td> a <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated gchar ** array. Free it using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>
1735
1666
1736
1667
</td>
1737
1668
</tr>
1738
1669
</tbody>
1739
1670
</table></div>
1740
<p class="since">Since 2.14
1741
</p>
1671
<p class="since">Since 2.14</p>
1742
1672
</div>
1743
1673
<hr>
1744
1674
<div class="refsect2" lang="en">
1745
<a name="id3207257"></a><h3>
1746
<a name="g-regex-replace"></a>g_regex_replace ()</h3>
1747
<a class="indexterm" name="id3207272"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_regex_replace (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1748
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1749
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
1750
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
1751
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *replacement,
1752
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1753
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
1675
<a name="g-regex-replace"></a><h3>g_regex_replace ()</h3>
1676
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_regex_replace (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1677
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1678
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
1679
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
1680
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *replacement,
1681
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1682
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
1754
1683
<p>
1755
1684
Replaces all occurances of the pattern in <em class="parameter"><code>regex</code></em> with the
1756
1685
replacement text. Backreferences of the form '\number' or
1791
1720
<p>
1792
1721
</p>
1793
1722
<p>
1794
If you do not need to use backreferences use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-literal"><code class="function">g_regex_replace_literal()</code></a>.
1723
If you do not need to use backreferences use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-literal" title="g_regex_replace_literal ()"><code class="function">g_regex_replace_literal()</code></a>.
1795
1724
</p>
1796
1725
<p>
1797
The <em class="parameter"><code>replacement</code></em> string must be UTF-8 encoded even if <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-RAW:CAPS"><span class="type">G_REGEX_RAW</span></a> was
1798
passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>. If you want to use not UTF-8 encoded stings
1799
you can use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-literal"><code class="function">g_regex_replace_literal()</code></a>.
1726
The <em class="parameter"><code>replacement</code></em> string must be UTF-8 encoded even if <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-RAW--CAPS"><span class="type">G_REGEX_RAW</span></a> was
1727
passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>. If you want to use not UTF-8 encoded stings
1728
you can use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace-literal" title="g_regex_replace_literal ()"><code class="function">g_regex_replace_literal()</code></a>.
1800
1729
</p>
1801
1730
<p>
1802
1731
Setting <em class="parameter"><code>start_position</code></em> differs from just passing over a shortened
1803
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL:CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern that
1732
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL--CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern that
1804
1733
begins with any kind of lookbehind assertion, such as "\b".</p>
1805
1734
<p>
1806
1807
1735
</p>
1808
1736
<div class="variablelist"><table border="0">
1809
1737
<col align="left" valign="top">
1810
1738
<tbody>
1811
1739
<tr>
1812
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1813
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure
1740
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1741
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure
1814
1742
</td>
1815
1743
</tr>
1816
1744
<tr>
1817
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1745
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1818
1746
<td> the string to perform matches against
1819
1747
</td>
1820
1748
</tr>
1821
1749
<tr>
1822
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1750
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1823
1751
<td> the length of <em class="parameter"><code>string</code></em>, or -1 if <em class="parameter"><code>string</code></em> is nul-terminated
1824
1752
</td>
1825
1753
</tr>
1826
1754
<tr>
1827
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1755
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1828
1756
<td> starting index of the string to match
1829
1757
</td>
1830
1758
</tr>
1831
1759
<tr>
1832
<td><p><span class="term"><em class="parameter"><code>replacement</code></em> :</span></p></td>
1760
<td><p><span class="term"><em class="parameter"><code>replacement</code></em> :</span></p></td>
1833
1761
<td> text to replace each match with
1834
1762
</td>
1835
1763
</tr>
1836
1764
<tr>
1837
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1765
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1838
1766
<td> options for the match
1839
1767
</td>
1840
1768
</tr>
1841
1769
<tr>
1842
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1843
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors
1770
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1771
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors
1844
1772
</td>
1845
1773
</tr>
1846
1774
<tr>
1847
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1775
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1848
1776
<td> a newly allocated string containing the replacements
1849
1777
1850
1778
</td>
1851
1779
</tr>
1852
1780
</tbody>
1853
1781
</table></div>
1854
<p class="since">Since 2.14
1855
</p>
1782
<p class="since">Since 2.14</p>
1856
1783
</div>
1857
1784
<hr>
1858
1785
<div class="refsect2" lang="en">
1859
<a name="id3207665"></a><h3>
1860
<a name="g-regex-replace-literal"></a>g_regex_replace_literal ()</h3>
1861
<a class="indexterm" name="id3207680"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_regex_replace_literal (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1862
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1863
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
1864
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
1865
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *replacement,
1866
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1867
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
1786
<a name="g-regex-replace-literal"></a><h3>g_regex_replace_literal ()</h3>
1787
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_regex_replace_literal (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1788
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1789
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
1790
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
1791
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *replacement,
1792
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1793
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
1868
1794
<p>
1869
1795
Replaces all occurances of the pattern in <em class="parameter"><code>regex</code></em> with the
1870
1796
replacement text. <em class="parameter"><code>replacement</code></em> is replaced literally, to
1871
include backreferences use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace"><code class="function">g_regex_replace()</code></a>.
1797
include backreferences use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace" title="g_regex_replace ()"><code class="function">g_regex_replace()</code></a>.
1872
1798
</p>
1873
1799
<p>
1874
1800
Setting <em class="parameter"><code>start_position</code></em> differs from just passing over a
1875
shortened string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL:CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the
1801
shortened string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL--CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the
1876
1802
case of a pattern that begins with any kind of lookbehind
1877
1803
assertion, such as "\b".</p>
1878
1804
<p>
1879
1880
1805
</p>
1881
1806
<div class="variablelist"><table border="0">
1882
1807
<col align="left" valign="top">
1883
1808
<tbody>
1884
1809
<tr>
1885
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1886
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure
1810
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1811
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure
1887
1812
</td>
1888
1813
</tr>
1889
1814
<tr>
1890
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1815
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1891
1816
<td> the string to perform matches against
1892
1817
</td>
1893
1818
</tr>
1894
1819
<tr>
1895
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1820
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1896
1821
<td> the length of <em class="parameter"><code>string</code></em>, or -1 if <em class="parameter"><code>string</code></em> is nul-terminated
1897
1822
</td>
1898
1823
</tr>
1899
1824
<tr>
1900
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1825
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1901
1826
<td> starting index of the string to match
1902
1827
</td>
1903
1828
</tr>
1904
1829
<tr>
1905
<td><p><span class="term"><em class="parameter"><code>replacement</code></em> :</span></p></td>
1830
<td><p><span class="term"><em class="parameter"><code>replacement</code></em> :</span></p></td>
1906
1831
<td> text to replace each match with
1907
1832
</td>
1908
1833
</tr>
1909
1834
<tr>
1910
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1835
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1911
1836
<td> options for the match
1912
1837
</td>
1913
1838
</tr>
1914
1839
<tr>
1915
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1916
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors
1840
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1841
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors
1917
1842
</td>
1918
1843
</tr>
1919
1844
<tr>
1920
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1845
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1921
1846
<td> a newly allocated string containing the replacements
1922
1847
1923
1848
</td>
1924
1849
</tr>
1925
1850
</tbody>
1926
1851
</table></div>
1927
<p class="since">Since 2.14
1928
</p>
1852
<p class="since">Since 2.14</p>
1929
1853
</div>
1930
1854
<hr>
1931
1855
<div class="refsect2" lang="en">
1932
<a name="id3207957"></a><h3>
1933
<a name="g-regex-replace-eval"></a>g_regex_replace_eval ()</h3>
1934
<a class="indexterm" name="id3207972"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_regex_replace_eval (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a> *regex,
1935
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1936
<a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len,
1937
<a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position,
1938
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1939
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexEvalCallback">GRegexEvalCallback</a> eval,
1940
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data,
1941
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
1856
<a name="g-regex-replace-eval"></a><h3>g_regex_replace_eval ()</h3>
1857
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_regex_replace_eval (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> *regex,
1858
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
1859
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> string_len,
1860
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> start_position,
1861
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags" title="enum GRegexMatchFlags">GRegexMatchFlags</a> match_options,
1862
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexEvalCallback" title="GRegexEvalCallback ()">GRegexEvalCallback</a> eval,
1863
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data,
1864
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
1942
1865
<p>
1943
1866
Replaces occurances of the pattern in regex with the output of
1944
1867
<em class="parameter"><code>eval</code></em> for that occurance.
1945
1868
</p>
1946
1869
<p>
1947
1870
Setting <em class="parameter"><code>start_position</code></em> differs from just passing over a shortened
1948
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL:CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern
1871
string and setting <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-NOTBOL--CAPS"><span class="type">G_REGEX_MATCH_NOTBOL</span></a> in the case of a pattern
1949
1872
that begins with any kind of lookbehind assertion, such as "\b".</p>
1950
1873
<p>
1951
1952
1874
</p>
1953
1875
<div class="variablelist"><table border="0">
1954
1876
<col align="left" valign="top">
1955
1877
<tbody>
1956
1878
<tr>
1957
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1958
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>
1879
<td><p><span class="term"><em class="parameter"><code>regex</code></em> :</span></p></td>
1880
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> structure from <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>
1959
1881
</td>
1960
1882
</tr>
1961
1883
<tr>
1962
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1884
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1963
1885
<td> string to perform matches against
1964
1886
</td>
1965
1887
</tr>
1966
1888
<tr>
1967
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1889
<td><p><span class="term"><em class="parameter"><code>string_len</code></em> :</span></p></td>
1968
1890
<td> the length of <em class="parameter"><code>string</code></em>, or -1 if <em class="parameter"><code>string</code></em> is nul-terminated
1969
1891
</td>
1970
1892
</tr>
1971
1893
<tr>
1972
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1894
<td><p><span class="term"><em class="parameter"><code>start_position</code></em> :</span></p></td>
1973
1895
<td> starting index of the string to match
1974
1896
</td>
1975
1897
</tr>
1976
1898
<tr>
1977
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1899
<td><p><span class="term"><em class="parameter"><code>match_options</code></em> :</span></p></td>
1978
1900
<td> options for the match
1979
1901
</td>
1980
1902
</tr>
1981
1903
<tr>
1982
<td><p><span class="term"><em class="parameter"><code>eval</code></em> :</span></p></td>
1904
<td><p><span class="term"><em class="parameter"><code>eval</code></em> :</span></p></td>
1983
1905
<td> a function to call for each match
1984
1906
</td>
1985
1907
</tr>
1986
1908
<tr>
1987
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1909
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1988
1910
<td> user data to pass to the function
1989
1911
</td>
1990
1912
</tr>
1991
1913
<tr>
1992
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1993
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors
1914
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1915
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors
1994
1916
</td>
1995
1917
</tr>
1996
1918
<tr>
1997
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1919
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1998
1920
<td> a newly allocated string containing the replacements
1999
1921
2000
1922
</td>
2001
1923
</tr>
2002
1924
</tbody>
2003
1925
</table></div>
2004
<p class="since">Since 2.14
2005
</p>
1926
<p class="since">Since 2.14</p>
2006
1927
</div>
2007
1928
<hr>
2008
1929
<div class="refsect2" lang="en">
2009
<a name="id3208265"></a><h3>
2010
<a name="g-regex-check-replacement"></a>g_regex_check_replacement ()</h3>
2011
<a class="indexterm" name="id3208281"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_regex_check_replacement (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *replacement,
2012
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> *has_references,
2013
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
1930
<a name="g-regex-check-replacement"></a><h3>g_regex_check_replacement ()</h3>
1931
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_regex_check_replacement (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *replacement,
1932
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> *has_references,
1933
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
2014
1934
<p>
2015
1935
Checks whether <em class="parameter"><code>replacement</code></em> is a valid replacement string
2016
(see <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace"><code class="function">g_regex_replace()</code></a>), i.e. that all escape sequences in
1936
(see <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace" title="g_regex_replace ()"><code class="function">g_regex_replace()</code></a>), i.e. that all escape sequences in
2017
1937
it are valid.
2018
1938
</p>
2019
1939
<p>
2020
If <em class="parameter"><code>has_references</code></em> is not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then <em class="parameter"><code>replacement</code></em> is checked
1940
If <em class="parameter"><code>has_references</code></em> is not <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> then <em class="parameter"><code>replacement</code></em> is checked
2021
1941
for pattern references. For instance, replacement text 'foo\n'
2022
1942
does not contain references and may be evaluated without information
2023
1943
about actual match, but '\0\1' (whole match followed by first
2024
subpattern) requires valid <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> object.</p>
1944
subpattern) requires valid <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> object.</p>
2025
1945
<p>
2026
2027
1946
</p>
2028
1947
<div class="variablelist"><table border="0">
2029
1948
<col align="left" valign="top">
2030
1949
<tbody>
2031
1950
<tr>
2032
<td><p><span class="term"><em class="parameter"><code>replacement</code></em> :</span></p></td>
1951
<td><p><span class="term"><em class="parameter"><code>replacement</code></em> :</span></p></td>
2033
1952
<td> the replacement string
2034
1953
</td>
2035
1954
</tr>
2036
1955
<tr>
2037
<td><p><span class="term"><em class="parameter"><code>has_references</code></em> :</span></p></td>
1956
<td><p><span class="term"><em class="parameter"><code>has_references</code></em> :</span></p></td>
2038
1957
<td> location to store information about
2039
references in <em class="parameter"><code>replacement</code></em> or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1958
references in <em class="parameter"><code>replacement</code></em> or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
2040
1959
</td>
2041
1960
</tr>
2042
1961
<tr>
2043
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1962
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2044
1963
<td> location to store error
2045
1964
</td>
2046
1965
</tr>
2047
1966
<tr>
2048
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1967
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2049
1968
<td> whether <em class="parameter"><code>replacement</code></em> is a valid replacement string
2050
1969
2051
1970
</td>
2052
1971
</tr>
2053
1972
</tbody>
2054
1973
</table></div>
2055
<p class="since">Since 2.14
2056
</p>
1974
<p class="since">Since 2.14</p>
2057
1975
</div>
2058
1976
<hr>
2059
1977
<div class="refsect2" lang="en">
2060
<a name="id3208471"></a><h3>
2061
<a name="GMatchInfo"></a>GMatchInfo</h3>
2062
<a class="indexterm" name="id3208486"></a><pre class="programlisting">typedef struct _GMatchInfo GMatchInfo;</pre>
1978
<a name="GMatchInfo"></a><h3>GMatchInfo</h3>
1979
<pre class="programlisting">typedef struct _GMatchInfo GMatchInfo;</pre>
2063
1980
<p>
2064
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> is used to retrieve information about the regular expression match
1981
<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> is used to retrieve information about the regular expression match
2065
1982
which created it.
2066
1983
This structure is opaque and its fields cannot be accessed directly.
2067
1984
</p>
2068
<p class="since">Since 2.14
2069
2070
</p>
1985
<p class="since">Since 2.14</p>
2071
1986
</div>
2072
1987
<hr>
2073
1988
<div class="refsect2" lang="en">
2074
<a name="id3208519"></a><h3>
2075
<a name="g-match-info-get-regex"></a>g_match_info_get_regex ()</h3>
2076
<a class="indexterm" name="id3208534"></a><pre class="programlisting"><a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a>* g_match_info_get_regex (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);</pre>
1989
<a name="g-match-info-get-regex"></a><h3>g_match_info_get_regex ()</h3>
1990
<pre class="programlisting"><a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex">GRegex</a> * g_match_info_get_regex (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);</pre>
2077
1991
<p>
2078
Returns <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> object used in <em class="parameter"><code>match_info</code></em>. It belongs to Glib
2079
and must not be freed. Use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-ref"><code class="function">g_regex_ref()</code></a> if you need to keep it
1992
Returns <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> object used in <em class="parameter"><code>match_info</code></em>. It belongs to Glib
1993
and must not be freed. Use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-ref" title="g_regex_ref ()"><code class="function">g_regex_ref()</code></a> if you need to keep it
2080
1994
after you free <em class="parameter"><code>match_info</code></em> object.</p>
2081
1995
<p>
2082
2083
1996
</p>
2084
1997
<div class="variablelist"><table border="0">
2085
1998
<col align="left" valign="top">
2086
1999
<tbody>
2087
2000
<tr>
2088
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2089
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a>
2001
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2002
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a>
2090
2003
</td>
2091
2004
</tr>
2092
2005
<tr>
2093
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2094
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex"><span class="type">GRegex</span></a> object used in <em class="parameter"><code>match_info</code></em>
2006
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2007
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex" title="GRegex"><span class="type">GRegex</span></a> object used in <em class="parameter"><code>match_info</code></em>
2095
2008
2096
2009
</td>
2097
2010
</tr>
2098
2011
</tbody>
2099
2012
</table></div>
2100
<p class="since">Since 2.14
2101
</p>
2013
<p class="since">Since 2.14</p>
2102
2014
</div>
2103
2015
<hr>
2104
2016
<div class="refsect2" lang="en">
2105
<a name="id3208655"></a><h3>
2106
<a name="g-match-info-get-string"></a>g_match_info_get_string ()</h3>
2107
<a class="indexterm" name="id3208670"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_match_info_get_string (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);</pre>
2017
<a name="g-match-info-get-string"></a><h3>g_match_info_get_string ()</h3>
2018
<pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_match_info_get_string (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);</pre>
2108
2019
<p>
2109
2020
Returns the string searched with <em class="parameter"><code>match_info</code></em>. This is the
2110
string passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match"><code class="function">g_regex_match()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace"><code class="function">g_regex_replace()</code></a> so
2021
string passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match" title="g_regex_match ()"><code class="function">g_regex_match()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace" title="g_regex_replace ()"><code class="function">g_regex_replace()</code></a> so
2111
2022
you may not free it before calling this function.</p>
2112
2023
<p>
2113
2114
2024
</p>
2115
2025
<div class="variablelist"><table border="0">
2116
2026
<col align="left" valign="top">
2117
2027
<tbody>
2118
2028
<tr>
2119
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2120
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a>
2029
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2030
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a>
2121
2031
</td>
2122
2032
</tr>
2123
2033
<tr>
2124
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2034
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2125
2035
<td> the string searched with <em class="parameter"><code>match_info</code></em>
2126
2036
2127
2037
</td>
2128
2038
</tr>
2129
2039
</tbody>
2130
2040
</table></div>
2131
<p class="since">Since 2.14
2132
</p>
2041
<p class="since">Since 2.14</p>
2133
2042
</div>
2134
2043
<hr>
2135
2044
<div class="refsect2" lang="en">
2136
<a name="id3208781"></a><h3>
2137
<a name="g-match-info-free"></a>g_match_info_free ()</h3>
2138
<a class="indexterm" name="id3208796"></a><pre class="programlisting">void g_match_info_free (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);</pre>
2139
<p>
2140
Frees all the memory associated with the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure.</p>
2141
<p>
2142
2045
<a name="g-match-info-free"></a><h3>g_match_info_free ()</h3>
2046
<pre class="programlisting">void g_match_info_free (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);</pre>
2047
<p>
2048
Frees all the memory associated with the <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure.</p>
2049
<p>
2143
2050
</p>
2144
2051
<div class="variablelist"><table border="0">
2145
2052
<col align="left" valign="top">
2146
2053
<tbody><tr>
2147
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2148
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a>
2054
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2055
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a>
2149
2056
</td>
2150
2057
</tr></tbody>
2151
2058
</table></div>
2152
<p class="since">Since 2.14
2153
</p>
2059
<p class="since">Since 2.14</p>
2154
2060
</div>
2155
2061
<hr>
2156
2062
<div class="refsect2" lang="en">
2157
<a name="id3208869"></a><h3>
2158
<a name="g-match-info-matches"></a>g_match_info_matches ()</h3>
2159
<a class="indexterm" name="id3208884"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_match_info_matches (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);</pre>
2063
<a name="g-match-info-matches"></a><h3>g_match_info_matches ()</h3>
2064
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_match_info_matches (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);</pre>
2160
2065
<p>
2161
2066
Returns whether the previous match operation succeeded.</p>
2162
2067
<p>
2163
2164
2068
</p>
2165
2069
<div class="variablelist"><table border="0">
2166
2070
<col align="left" valign="top">
2167
2071
<tbody>
2168
2072
<tr>
2169
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2170
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2073
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2074
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2171
2075
</td>
2172
2076
</tr>
2173
2077
<tr>
2174
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2175
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the previous match operation succeeded,
2176
<a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
2078
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2079
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the previous match operation succeeded,
2080
<a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
2177
2081
2178
2082
</td>
2179
2083
</tr>
2180
2084
</tbody>
2181
2085
</table></div>
2182
<p class="since">Since 2.14
2183
</p>
2086
<p class="since">Since 2.14</p>
2184
2087
</div>
2185
2088
<hr>
2186
2089
<div class="refsect2" lang="en">
2187
<a name="id3208982"></a><h3>
2188
<a name="g-match-info-next"></a>g_match_info_next ()</h3>
2189
<a class="indexterm" name="id3208997"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_match_info_next (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
2190
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
2090
<a name="g-match-info-next"></a><h3>g_match_info_next ()</h3>
2091
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_match_info_next (<a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
2092
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
2191
2093
<p>
2192
2094
Scans for the next match using the same parameters of the previous
2193
call to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-full"><code class="function">g_regex_match_full()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match"><code class="function">g_regex_match()</code></a> that returned
2095
call to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-full" title="g_regex_match_full ()"><code class="function">g_regex_match_full()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match" title="g_regex_match ()"><code class="function">g_regex_match()</code></a> that returned
2194
2096
<em class="parameter"><code>match_info</code></em>.
2195
2097
</p>
2196
2098
<p>
2197
2099
The match is done on the string passed to the match function, so you
2198
2100
cannot free it before calling this function.</p>
2199
2101
<p>
2200
2201
2102
</p>
2202
2103
<div class="variablelist"><table border="0">
2203
2104
<col align="left" valign="top">
2204
2105
<tbody>
2205
2106
<tr>
2206
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2207
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2208
</td>
2209
</tr>
2210
<tr>
2211
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2212
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors
2213
</td>
2214
</tr>
2215
<tr>
2216
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2217
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
2107
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2108
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2109
</td>
2110
</tr>
2111
<tr>
2112
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2113
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors
2114
</td>
2115
</tr>
2116
<tr>
2117
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2118
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> is the string matched, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
2218
2119
2219
2120
</td>
2220
2121
</tr>
2221
2122
</tbody>
2222
2123
</table></div>
2223
<p class="since">Since 2.14
2224
</p>
2124
<p class="since">Since 2.14</p>
2225
2125
</div>
2226
2126
<hr>
2227
2127
<div class="refsect2" lang="en">
2228
<a name="id3209159"></a><h3>
2229
<a name="g-match-info-get-match-count"></a>g_match_info_get_match_count ()</h3>
2230
<a class="indexterm" name="id3209174"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a> g_match_info_get_match_count (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);</pre>
2128
<a name="g-match-info-get-match-count"></a><h3>g_match_info_get_match_count ()</h3>
2129
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> g_match_info_get_match_count (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);</pre>
2231
2130
<p>
2232
2131
Retrieves the number of matched substrings (including substring 0,
2233
2132
that is the whole matched text), so 1 is returned if the pattern
2235
2134
</p>
2236
2135
<p>
2237
2136
If the last match was obtained using the DFA algorithm, that is
2238
using <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all"><code class="function">g_regex_match_all()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full"><code class="function">g_regex_match_all_full()</code></a>, the retrieved
2137
using <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all" title="g_regex_match_all ()"><code class="function">g_regex_match_all()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full" title="g_regex_match_all_full ()"><code class="function">g_regex_match_all_full()</code></a>, the retrieved
2239
2138
count is not that of the number of capturing parentheses but that of
2240
2139
the number of matched substrings.</p>
2241
2140
<p>
2242
2243
2141
</p>
2244
2142
<div class="variablelist"><table border="0">
2245
2143
<col align="left" valign="top">
2246
2144
<tbody>
2247
2145
<tr>
2248
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2249
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2146
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2147
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2250
2148
</td>
2251
2149
</tr>
2252
2150
<tr>
2253
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2151
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2254
2152
<td> Number of matched substrings, or -1 if an error occurred
2255
2153
2256
2154
</td>
2257
2155
</tr>
2258
2156
</tbody>
2259
2157
</table></div>
2260
<p class="since">Since 2.14
2261
</p>
2158
<p class="since">Since 2.14</p>
2262
2159
</div>
2263
2160
<hr>
2264
2161
<div class="refsect2" lang="en">
2265
<a name="id3209282"></a><h3>
2266
<a name="g-match-info-is-partial-match"></a>g_match_info_is_partial_match ()</h3>
2267
<a class="indexterm" name="id3209298"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_match_info_is_partial_match (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);</pre>
2162
<a name="g-match-info-is-partial-match"></a><h3>g_match_info_is_partial_match ()</h3>
2163
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_match_info_is_partial_match (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);</pre>
2268
2164
<p>
2269
2165
Usually if the string passed to g_regex_match*() matches as far as
2270
it goes, but is too short to match the entire pattern, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is
2166
it goes, but is too short to match the entire pattern, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> is
2271
2167
returned. There are circumstances where it might be helpful to
2272
2168
distinguish this case from other cases in which there is no match.
2273
2169
</p>
2276
2172
type in data for a field with specific formatting requirements. An
2277
2173
example might be a date in the form ddmmmyy, defined by the pattern
2278
2174
"^\d?\d(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\d\d$".
2279
If the application sees the user’s keystrokes one by one, and can
2175
If the application sees the user’s keystrokes one by one, and can
2280
2176
check that what has been typed so far is potentially valid, it is
2281
2177
able to raise an error as soon as a mistake is made.
2282
2178
</p>
2283
2179
<p>
2284
2180
GRegex supports the concept of partial matching by means of the
2285
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-PARTIAL:CAPS"><span class="type">G_REGEX_MATCH_PARTIAL</span></a> flag. When this is set the return code for
2286
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match"><code class="function">g_regex_match()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-full"><code class="function">g_regex_match_full()</code></a> is, as usual, <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
2287
for a complete match, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise. But, when these functions
2288
return <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, you can check if the match was partial calling
2289
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-is-partial-match"><code class="function">g_match_info_is_partial_match()</code></a>.
2181
<a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-PARTIAL--CAPS"><span class="type">G_REGEX_MATCH_PARTIAL</span></a> flag. When this is set the return code for
2182
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match" title="g_regex_match ()"><code class="function">g_regex_match()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-full" title="g_regex_match_full ()"><code class="function">g_regex_match_full()</code></a> is, as usual, <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a>
2183
for a complete match, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise. But, when these functions
2184
return <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a>, you can check if the match was partial calling
2185
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-match-info-is-partial-match" title="g_match_info_is_partial_match ()"><code class="function">g_match_info_is_partial_match()</code></a>.
2290
2186
</p>
2291
2187
<p>
2292
2188
When using partial matching you cannot use g_match_info_fetch*().
2299
2195
of occurrences is greater than one. Optional items such as "\d?"
2300
2196
(where the maximum is one) are permitted. Quantifiers with any values
2301
2197
are permitted after parentheses, so the invalid examples above can be
2302
coded thus "(a){2,4}" and "(\d)+". If <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-PARTIAL:CAPS"><span class="type">G_REGEX_MATCH_PARTIAL</span></a> is set
2198
coded thus "(a){2,4}" and "(\d)+". If <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-MATCH-PARTIAL--CAPS"><span class="type">G_REGEX_MATCH_PARTIAL</span></a> is set
2303
2199
for a pattern that does not conform to the restrictions, matching
2304
2200
functions return an error.</p>
2305
2201
<p>
2306
2307
2202
</p>
2308
2203
<div class="variablelist"><table border="0">
2309
2204
<col align="left" valign="top">
2310
2205
<tbody>
2311
2206
<tr>
2312
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2313
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2207
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2208
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2314
2209
</td>
2315
2210
</tr>
2316
2211
<tr>
2317
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2318
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the match was partial, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
2212
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2213
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the match was partial, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
2319
2214
2320
2215
</td>
2321
2216
</tr>
2322
2217
</tbody>
2323
2218
</table></div>
2324
<p class="since">Since 2.14
2325
</p>
2219
<p class="since">Since 2.14</p>
2326
2220
</div>
2327
2221
<hr>
2328
2222
<div class="refsect2" lang="en">
2329
<a name="id3209534"></a><h3>
2330
<a name="g-match-info-expand-references"></a>g_match_info_expand_references ()</h3>
2331
<a class="indexterm" name="id3209549"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_match_info_expand_references (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
2332
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string_to_expand,
2333
<a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
2223
<a name="g-match-info-expand-references"></a><h3>g_match_info_expand_references ()</h3>
2224
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_match_info_expand_references (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
2225
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string_to_expand,
2226
<a class="link" href="glib-Error-Reporting.html#GError" title="GError">GError</a> **error);</pre>
2334
2227
<p>
2335
2228
Returns a new string containing the text in <em class="parameter"><code>string_to_expand</code></em> with
2336
2229
references and escape sequences expanded. References refer to the last
2337
2230
match done with <em class="parameter"><code>string</code></em> against <em class="parameter"><code>regex</code></em> and have the same syntax used by
2338
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace"><code class="function">g_regex_replace()</code></a>.
2231
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-replace" title="g_regex_replace ()"><code class="function">g_regex_replace()</code></a>.
2339
2232
</p>
2340
2233
<p>
2341
The <em class="parameter"><code>string_to_expand</code></em> must be UTF-8 encoded even if <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-RAW:CAPS"><span class="type">G_REGEX_RAW</span></a> was
2342
passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new"><code class="function">g_regex_new()</code></a>.
2234
The <em class="parameter"><code>string_to_expand</code></em> must be UTF-8 encoded even if <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-RAW--CAPS"><span class="type">G_REGEX_RAW</span></a> was
2235
passed to <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-new" title="g_regex_new ()"><code class="function">g_regex_new()</code></a>.
2343
2236
</p>
2344
2237
<p>
2345
2238
The backreferences are extracted from the string passed to the match
2346
2239
function, so you cannot call this function after freeing the string.
2347
2240
</p>
2348
2241
<p>
2349
<em class="parameter"><code>match_info</code></em> may be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in which case <em class="parameter"><code>string_to_expand</code></em> must not
2242
<em class="parameter"><code>match_info</code></em> may be <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> in which case <em class="parameter"><code>string_to_expand</code></em> must not
2350
2243
contain references. For instance "foo\n" does not refer to an actual
2351
2244
pattern and '\n' merely will be replaced with \n character,
2352
2245
while to expand "\0" (whole match) one needs the result of a match.
2353
Use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-check-replacement"><code class="function">g_regex_check_replacement()</code></a> to find out whether <em class="parameter"><code>string_to_expand</code></em>
2246
Use <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-check-replacement" title="g_regex_check_replacement ()"><code class="function">g_regex_check_replacement()</code></a> to find out whether <em class="parameter"><code>string_to_expand</code></em>
2354
2247
contains references.</p>
2355
2248
<p>
2356
2357
2249
</p>
2358
2250
<div class="variablelist"><table border="0">
2359
2251
<col align="left" valign="top">
2360
2252
<tbody>
2361
2253
<tr>
2362
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2363
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2254
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2255
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
2364
2256
</td>
2365
2257
</tr>
2366
2258
<tr>
2367
<td><p><span class="term"><em class="parameter"><code>string_to_expand</code></em> :</span></p></td>
2259
<td><p><span class="term"><em class="parameter"><code>string_to_expand</code></em> :</span></p></td>
2368
2260
<td> the string to expand
2369
2261
</td>
2370
2262
</tr>
2371
2263
<tr>
2372
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2373
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors
2264
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2265
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors
2374
2266
</td>
2375
2267
</tr>
2376
2268
<tr>
2377
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2378
<td> the expanded string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred
2269
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2270
<td> the expanded string, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred
2379
2271
2380
2272
</td>
2381
2273
</tr>
2382
2274
</tbody>
2383
2275
</table></div>
2384
<p class="since">Since 2.14
2385
</p>
2276
<p class="since">Since 2.14</p>
2386
2277
</div>
2387
2278
<hr>
2388
2279
<div class="refsect2" lang="en">
2389
<a name="id3209813"></a><h3>
2390
<a name="g-match-info-fetch"></a>g_match_info_fetch ()</h3>
2391
<a class="indexterm" name="id3209828"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_match_info_fetch (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
2392
<a class="link" href="glib-Basic-Types.html#gint">gint</a> match_num);</pre>
2280
<a name="g-match-info-fetch"></a><h3>g_match_info_fetch ()</h3>
2281
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_match_info_fetch (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
2282
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> match_num);</pre>
2393
2283
<p>
2394
2284
Retrieves the text matching the <em class="parameter"><code>match_num</code></em>'th capturing
2395
2285
parentheses. 0 is the full text of the match, 1 is the first paren
2402
2292
</p>
2403
2293
<p>
2404
2294
If the match was obtained using the DFA algorithm, that is using
2405
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all"><code class="function">g_regex_match_all()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full"><code class="function">g_regex_match_all_full()</code></a>, the retrieved
2295
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all" title="g_regex_match_all ()"><code class="function">g_regex_match_all()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full" title="g_regex_match_all_full ()"><code class="function">g_regex_match_all_full()</code></a>, the retrieved
2406
2296
string is not that of a set of parentheses but that of a matched
2407
2297
substring. Substrings are matched in reverse order of length, so
2408
2298
0 is the longest match.
2411
2301
The string is fetched from the string passed to the match function,
2412
2302
so you cannot call this function after freeing the string.</p>
2413
2303
<p>
2414
2415
2304
</p>
2416
2305
<div class="variablelist"><table border="0">
2417
2306
<col align="left" valign="top">
2418
2307
<tbody>
2419
2308
<tr>
2420
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2421
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2309
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2310
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2422
2311
</td>
2423
2312
</tr>
2424
2313
<tr>
2425
<td><p><span class="term"><em class="parameter"><code>match_num</code></em> :</span></p></td>
2314
<td><p><span class="term"><em class="parameter"><code>match_num</code></em> :</span></p></td>
2426
2315
<td> number of the sub expression
2427
2316
</td>
2428
2317
</tr>
2429
2318
<tr>
2430
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2431
<td> The matched substring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred.
2319
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2320
<td> The matched substring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred.
2432
2321
You have to free the string yourself
2433
2322
2434
2323
</td>
2435
2324
</tr>
2436
2325
</tbody>
2437
2326
</table></div>
2438
<p class="since">Since 2.14
2439
</p>
2327
<p class="since">Since 2.14</p>
2440
2328
</div>
2441
2329
<hr>
2442
2330
<div class="refsect2" lang="en">
2443
<a name="id3209992"></a><h3>
2444
<a name="g-match-info-fetch-pos"></a>g_match_info_fetch_pos ()</h3>
2445
<a class="indexterm" name="id3210007"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_match_info_fetch_pos (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
2446
<a class="link" href="glib-Basic-Types.html#gint">gint</a> match_num,
2447
<a class="link" href="glib-Basic-Types.html#gint">gint</a> *start_pos,
2448
<a class="link" href="glib-Basic-Types.html#gint">gint</a> *end_pos);</pre>
2331
<a name="g-match-info-fetch-pos"></a><h3>g_match_info_fetch_pos ()</h3>
2332
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_match_info_fetch_pos (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
2333
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> match_num,
2334
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> *start_pos,
2335
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> *end_pos);</pre>
2449
2336
<p>
2450
2337
Retrieves the position of the <em class="parameter"><code>match_num</code></em>'th capturing
2451
2338
parentheses. 0 is the full text of the match, 1 is the first
2454
2341
<p>
2455
2342
If <em class="parameter"><code>match_num</code></em> is a valid sub pattern but it didn't match anything
2456
2343
(e.g. sub pattern 1, matching "b" against "(a)?b") then <em class="parameter"><code>start_pos</code></em>
2457
and <em class="parameter"><code>end_pos</code></em> are set to -1 and <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned.
2344
and <em class="parameter"><code>end_pos</code></em> are set to -1 and <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> is returned.
2458
2345
</p>
2459
2346
<p>
2460
2347
If the match was obtained using the DFA algorithm, that is using
2461
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all"><code class="function">g_regex_match_all()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full"><code class="function">g_regex_match_all_full()</code></a>, the retrieved
2348
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all" title="g_regex_match_all ()"><code class="function">g_regex_match_all()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full" title="g_regex_match_all_full ()"><code class="function">g_regex_match_all_full()</code></a>, the retrieved
2462
2349
position is not that of a set of parentheses but that of a matched
2463
2350
substring. Substrings are matched in reverse order of length, so
2464
2351
0 is the longest match.</p>
2465
2352
<p>
2466
2467
2353
</p>
2468
2354
<div class="variablelist"><table border="0">
2469
2355
<col align="left" valign="top">
2470
2356
<tbody>
2471
2357
<tr>
2472
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2473
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2358
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2359
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2474
2360
</td>
2475
2361
</tr>
2476
2362
<tr>
2477
<td><p><span class="term"><em class="parameter"><code>match_num</code></em> :</span></p></td>
2363
<td><p><span class="term"><em class="parameter"><code>match_num</code></em> :</span></p></td>
2478
2364
<td> number of the sub expression
2479
2365
</td>
2480
2366
</tr>
2481
2367
<tr>
2482
<td><p><span class="term"><em class="parameter"><code>start_pos</code></em> :</span></p></td>
2368
<td><p><span class="term"><em class="parameter"><code>start_pos</code></em> :</span></p></td>
2483
2369
<td> pointer to location where to store the start position
2484
2370
</td>
2485
2371
</tr>
2486
2372
<tr>
2487
<td><p><span class="term"><em class="parameter"><code>end_pos</code></em> :</span></p></td>
2373
<td><p><span class="term"><em class="parameter"><code>end_pos</code></em> :</span></p></td>
2488
2374
<td> pointer to location where to store the end position
2489
2375
</td>
2490
2376
</tr>
2491
2377
<tr>
2492
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2493
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the position was fetched, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise. If
2378
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2379
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the position was fetched, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise. If
2494
2380
the position cannot be fetched, <em class="parameter"><code>start_pos</code></em> and <em class="parameter"><code>end_pos</code></em> are left
2495
2381
unchanged
2496
2382
2498
2384
</tr>
2499
2385
</tbody>
2500
2386
</table></div>
2501
<p class="since">Since 2.14
2502
</p>
2387
<p class="since">Since 2.14</p>
2503
2388
</div>
2504
2389
<hr>
2505
2390
<div class="refsect2" lang="en">
2506
<a name="id3210255"></a><h3>
2507
<a name="g-match-info-fetch-named"></a>g_match_info_fetch_named ()</h3>
2508
<a class="indexterm" name="id3210270"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>* g_match_info_fetch_named (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
2509
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name);</pre>
2391
<a name="g-match-info-fetch-named"></a><h3>g_match_info_fetch_named ()</h3>
2392
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> * g_match_info_fetch_named (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
2393
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *name);</pre>
2510
2394
<p>
2511
2395
Retrieves the text matching the capturing parentheses named <em class="parameter"><code>name</code></em>.
2512
2396
</p>
2519
2403
The string is fetched from the string passed to the match function,
2520
2404
so you cannot call this function after freeing the string.</p>
2521
2405
<p>
2522
2523
2406
</p>
2524
2407
<div class="variablelist"><table border="0">
2525
2408
<col align="left" valign="top">
2526
2409
<tbody>
2527
2410
<tr>
2528
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2529
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2411
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2412
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2530
2413
</td>
2531
2414
</tr>
2532
2415
<tr>
2533
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
2416
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
2534
2417
<td> name of the subexpression
2535
2418
</td>
2536
2419
</tr>
2537
2420
<tr>
2538
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2539
<td> The matched substring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred.
2421
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2422
<td> The matched substring, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if an error occurred.
2540
2423
You have to free the string yourself
2541
2424
2542
2425
</td>
2543
2426
</tr>
2544
2427
</tbody>
2545
2428
</table></div>
2546
<p class="since">Since 2.14
2547
</p>
2429
<p class="since">Since 2.14</p>
2548
2430
</div>
2549
2431
<hr>
2550
2432
<div class="refsect2" lang="en">
2551
<a name="id3210404"></a><h3>
2552
<a name="g-match-info-fetch-named-pos"></a>g_match_info_fetch_named_pos ()</h3>
2553
<a class="indexterm" name="id3210420"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_match_info_fetch_named_pos (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info,
2554
const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name,
2555
<a class="link" href="glib-Basic-Types.html#gint">gint</a> *start_pos,
2556
<a class="link" href="glib-Basic-Types.html#gint">gint</a> *end_pos);</pre>
2433
<a name="g-match-info-fetch-named-pos"></a><h3>g_match_info_fetch_named_pos ()</h3>
2434
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_match_info_fetch_named_pos (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info,
2435
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *name,
2436
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> *start_pos,
2437
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> *end_pos);</pre>
2557
2438
<p>
2558
2439
Retrieves the position of the capturing parentheses named <em class="parameter"><code>name</code></em>.
2559
2440
</p>
2560
2441
<p>
2561
2442
If <em class="parameter"><code>name</code></em> is a valid sub pattern name but it didn't match anything
2562
2443
(e.g. sub pattern "X", matching "b" against "(?P<X>a)?b")
2563
then <em class="parameter"><code>start_pos</code></em> and <em class="parameter"><code>end_pos</code></em> are set to -1 and <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned.</p>
2444
then <em class="parameter"><code>start_pos</code></em> and <em class="parameter"><code>end_pos</code></em> are set to -1 and <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> is returned.</p>
2564
2445
<p>
2565
2566
2446
</p>
2567
2447
<div class="variablelist"><table border="0">
2568
2448
<col align="left" valign="top">
2569
2449
<tbody>
2570
2450
<tr>
2571
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2572
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2451
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2452
<td> <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2573
2453
</td>
2574
2454
</tr>
2575
2455
<tr>
2576
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
2456
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
2577
2457
<td> name of the subexpression
2578
2458
</td>
2579
2459
</tr>
2580
2460
<tr>
2581
<td><p><span class="term"><em class="parameter"><code>start_pos</code></em> :</span></p></td>
2461
<td><p><span class="term"><em class="parameter"><code>start_pos</code></em> :</span></p></td>
2582
2462
<td> pointer to location where to store the start position
2583
2463
</td>
2584
2464
</tr>
2585
2465
<tr>
2586
<td><p><span class="term"><em class="parameter"><code>end_pos</code></em> :</span></p></td>
2466
<td><p><span class="term"><em class="parameter"><code>end_pos</code></em> :</span></p></td>
2587
2467
<td> pointer to location where to store the end position
2588
2468
</td>
2589
2469
</tr>
2590
2470
<tr>
2591
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2592
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the position was fetched, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise. If
2471
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2472
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the position was fetched, <a class="link" href="glib-Standard-Macros.html#FALSE--CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise. If
2593
2473
the position cannot be fetched, <em class="parameter"><code>start_pos</code></em> and <em class="parameter"><code>end_pos</code></em> are left
2594
2474
unchanged
2595
2475
2597
2477
</tr>
2598
2478
</tbody>
2599
2479
</table></div>
2600
<p class="since">Since 2.14
2601
</p>
2480
<p class="since">Since 2.14</p>
2602
2481
</div>
2603
2482
<hr>
2604
2483
<div class="refsect2" lang="en">
2605
<a name="id3210638"></a><h3>
2606
<a name="g-match-info-fetch-all"></a>g_match_info_fetch_all ()</h3>
2607
<a class="indexterm" name="id3210653"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>** g_match_info_fetch_all (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> *match_info);</pre>
2484
<a name="g-match-info-fetch-all"></a><h3>g_match_info_fetch_all ()</h3>
2485
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> ** g_match_info_fetch_all (const <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo">GMatchInfo</a> *match_info);</pre>
2608
2486
<p>
2609
2487
Bundles up pointers to each of the matching substrings from a match
2610
2488
and stores them in an array of gchar pointers. The first element in
2617
2495
</p>
2618
2496
<p>
2619
2497
If the last match was obtained using the DFA algorithm, that is using
2620
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all"><code class="function">g_regex_match_all()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full"><code class="function">g_regex_match_all_full()</code></a>, the retrieved
2498
<a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all" title="g_regex_match_all ()"><code class="function">g_regex_match_all()</code></a> or <a class="link" href="glib-Perl-compatible-regular-expressions.html#g-regex-match-all-full" title="g_regex_match_all_full ()"><code class="function">g_regex_match_all_full()</code></a>, the retrieved
2621
2499
strings are not that matched by sets of parentheses but that of the
2622
2500
matched substring. Substrings are matched in reverse order of length,
2623
2501
so the first one is the longest match.
2626
2504
The strings are fetched from the string passed to the match function,
2627
2505
so you cannot call this function after freeing the string.</p>
2628
2506
<p>
2629
2630
2507
</p>
2631
2508
<div class="variablelist"><table border="0">
2632
2509
<col align="left" valign="top">
2633
2510
<tbody>
2634
2511
<tr>
2635
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2636
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2512
<td><p><span class="term"><em class="parameter"><code>match_info</code></em> :</span></p></td>
2513
<td> a <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo" title="GMatchInfo"><span class="type">GMatchInfo</span></a> structure
2637
2514
</td>
2638
2515
</tr>
2639
2516
<tr>
2640
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2641
<td> a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of gchar * pointers. It must be
2642
freed using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>. If the previous match failed <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
2517
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2518
<td> a <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of gchar * pointers. It must be
2519
freed using <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>. If the previous match failed <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> is
2643
2520
returned
2644
2521
2645
2522
</td>
2646
2523
</tr>
2647
2524
</tbody>
2648
2525
</table></div>
2649
<p class="since">Since 2.14
2650
</p>
2651
</div>
2652
</div>
2653
<div class="refsect1" lang="en">
2654
<a name="id3210805"></a><div class="refsect2" lang="en"><a name="id3210806"></a></div>
2526
<p class="since">Since 2.14</p>
2527
</div>
2528
</div>
2529
</div>
2530
<div class="footer">
2655
2531
<hr>
2656
<div class="refsect2" lang="en"><a name="id3210807"></a></div>
2657
</div>
2658
</div>
2532
Generated by GTK-Doc V1.11</div>
2659
2533
</body>
2660
2534
</html>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1