PatternSpec

A glib.pattern_spec.PatternSpec struct is the 'compiled' form of a glob-style pattern.

The func@GLib.pattern_match_simple and glib.pattern_spec.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(), 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 glib.pattern_spec.PatternSpec using glib.pattern_spec.PatternSpec.new_ and use glib.pattern_spec.PatternSpec.matchString instead of func@GLib.pattern_match_simple. This avoids the overhead of repeated pattern compilation.

class PatternSpec : Boxed {

this(string pattern);

glib.pattern_spec.PatternSpec copy();

bool equal(glib.pattern_spec.PatternSpec pspec2);

bool match(size_t stringLength, string string_, string stringReversed);

bool matchString(string string_);

}

Constructors

this this(string pattern): Compiles a pattern to a #GPatternSpec.

Members

Functions

copy glib.pattern_spec.PatternSpec copy(): Copies pspec in a new #GPatternSpec.
equal bool equal(glib.pattern_spec.PatternSpec pspec2): Compares two compiled pattern specs and returns whether they will match the same set of strings.
match bool match(size_t stringLength, string string_, string stringReversed): Matches a string against a compiled pattern. Passing the correct length of the string given is mandatory. The reversed string can be omitted by passing null, this is more efficient if the reversed version of the string to be matched is not at hand, as glib.global.patternMatch will only construct it if the compiled pattern requires reverse matches.
matchString bool matchString(string string_): Matches a string against a compiled pattern. If the string is to be matched against more than one pattern, consider using glib.global.patternMatch instead while supplying the reversed string.

Inherited Members

From Boxed

cInstancePtr void* cInstancePtr;: Pointer to the C boxed value
getType GType getType(): Get the GType of this boxed type.
gType GType gType [@property getter]: Boxed GType property.
self Boxed self(): Convenience method to return this cast to a type. For use in D with statements.
copy_ void* copy_(): Make a copy of the wrapped C boxed data.
boxedCopy void* boxedCopy(void* cBoxed): Copy a C boxed value using g_boxed_copy.
boxedFree void boxedFree(void* cBoxed): Free a C boxed value using g_boxed_free.

glib pattern_spec classes

PatternSpec