PatternSpec

PatternSpec

Object Hierarchy:

Description:

[ Compact ]
[ CCode ( free_function = "g_pattern_spec_free" ) ]
public class PatternSpec

A `GPatternSpec` struct is the ‘compiled’ form of a glob-style pattern.

The [func@GLib.pattern_match_simple] and [method@GLib.PatternSpec.match] functions match a string against a pattern containing `*` and `?` wildcards with similar semantics as the standard `glob()` function: `*` matches an arbitrary, possibly empty, string, `?` matches an arbitrary character.

Note that in contrast to [`glob()`](man:glob(3)), the `/` character can be matched by the wildcards, there are no `[…]` character ranges and `*` and `?` can not be escaped to include them literally in a pattern.

When multiple strings must be matched against the same pattern, it is better to compile the pattern to a [struct@GLib.PatternSpec] using [ctor@GLib.PatternSpec.new] and use [method@GLib.PatternSpec.match_string] instead of [func@GLib.pattern_match_simple]. This avoids the overhead of repeated pattern compilation.

Namespace: GLib

Package: glib-2.0

Content:

Static methods:

public static bool match_simple (string pattern, string str)
Matches a string against a pattern given as a string.

Creation methods:

public PatternSpec (string pattern)
Compiles a pattern to a [type@GLib.

Methods:

public bool equal (PatternSpec pspec)
Compares two compiled pattern specs and returns whether they will match the same set of strings.
public bool match (uint string_length, string str, string? str_reversed)
Matches a string against a compiled pattern.
public bool match_string (string str)
Matches a string against a compiled pattern.