glib-perl-compatible-regular-expressions.html
来自「最新gtk中文资料集」· HTML 代码 · 共 1,021 行 · 第 1/5 页
HTML
1,021 行
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>Perl-compatible regular expressions</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GLib Reference Manual"><link rel="up" href="glib-utilities.html" title="GLib Utilities"><link rel="prev" href="glib-Glob-style-pattern-matching.html" title="Glob-style pattern matching"><link rel="next" href="glib-Simple-XML-Subset-Parser.html" title="Simple XML Subset Parser"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="glib.html" title="GLib Overview"><link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals"><link rel="chapter" href="glib-core.html" title="GLib Core Application Support"><link rel="chapter" href="glib-utilities.html" title="GLib Utilities"><link rel="chapter" href="glib-data-types.html" title="GLib Data Types"><link rel="chapter" href="tools.html" title="GLib Tools"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"><link rel="index" href="ix09.html" title="Index of new symbols in 2.14"><link rel="index" href="ix10.html" title="Index of new symbols in 2.16"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="glib-Glob-style-pattern-matching.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="glib-utilities.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GLib Reference Manual</th><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></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id3142793" class="shortcut">Top</a>  |  <a href="#id3144206" class="shortcut">Description</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="glib-Perl-compatible-regular-expressions"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id3142793"></a><span class="refentrytitle">Perl-compatible regular expressions</span></h2><p>Perl-compatible regular expressions — matches strings against regular expressions</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <glib.h>enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexError">GRegexError</a>;#define <a class="link" href="glib-Perl-compatible-regular-expressions.html#G-REGEX-ERROR:CAPS">G_REGEX_ERROR</a>enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a>;enum <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a>; <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegex">GRegex</a>;<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, <a class="link" href="glib-Strings.html#GString">GString</a> *result, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);<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, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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);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);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);<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);<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);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name);<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, <a class="link" href="glib-Basic-Types.html#gint">gint</a> length);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len, <a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len, <a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a> **match_info, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexCompileFlags">GRegexCompileFlags</a> compile_options, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len, <a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Basic-Types.html#gint">gint</a> max_tokens, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len, <a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *replacement, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len, <a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *replacement, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string, <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> string_len, <a class="link" href="glib-Basic-Types.html#gint">gint</a> start_position, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexMatchFlags">GRegexMatchFlags</a> match_options, <a class="link" href="glib-Perl-compatible-regular-expressions.html#GRegexEvalCallback">GRegexEvalCallback</a> eval, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> *has_references, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error); <a class="link" href="glib-Perl-compatible-regular-expressions.html#GMatchInfo">GMatchInfo</a>;<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);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);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);<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);<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, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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);<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);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string_to_expand, <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);<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, <a class="link" href="glib-Basic-Types.html#gint">gint</a> match_num);<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, <a class="link" href="glib-Basic-Types.html#gint">gint</a> match_num, <a class="link" href="glib-Basic-Types.html#gint">gint</a> *start_pos, <a class="link" href="glib-Basic-Types.html#gint">gint</a> *end_pos);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name);<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, const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *name, <a class="link" href="glib-Basic-Types.html#gint">gint</a> *start_pos, <a class="link" href="glib-Basic-Types.html#gint">gint</a> *end_pos);<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);</pre></div><div class="refsect1" lang="en"><a name="id3144206"></a><h2>Description</h2><p>The <code class="function">g_regex_*()</code> functions implement regularexpression pattern matching using syntax and semantics similar toPerl regular expression.</p><p>Some functions accept a <em class="parameter"><code>start_position</code></em> argument,setting it differs from just passing over a 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 case of a pattern that begins with any kindof lookbehind assertion.For example, consider the pattern "\Biss\B" which finds occurrences of "iss"in the middle of words. ("\B" matches only if the current position in thesubject is not a word boundary.) When applied to the string "Mississipi"from the fourth byte, namely "issipi", it does not match, because "\B" isalways false at the start of the subject, which is deemed to be a wordboundary. However, if the entire string is passed , but with<em class="parameter"><code>start_position</code></em> set to 4, it finds the secondoccurrence of "iss" because it is able to look behind the starting pointto discover that it is preceded by a letter.</p><p>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 passedto these functions must be encoded in UTF-8. The lengths and the positionsinside the strings are in bytes and not in characters, so, for instance,"\xc3\xa0" (i.e. "à") is two bytes long but it is treated as a singlecharacter. 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-8strings and a byte is treated as a character, so "\xc3\xa0" is two bytesand two characters long.</p>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?