match


Description:

[ Version ( deprecated_since = "2.70" ) ]
[ CCode ( cname = "g_pattern_match" ) ]
public bool match (uint string_length, string str, string? str_reversed)

Warning: match is deprecated since 2.70.

Matches a string against a compiled pattern.

Note:

Use [method@GLib.PatternSpec.match] instead

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 `g_pattern_match()` will only construct it if the compiled pattern requires reverse matches.

Note that, if the user code will (possibly) match a string against a multitude of patterns containing wildcards, chances are high that some patterns will require a reversed string. In this case, it’s more efficient to provide the reversed string to avoid multiple constructions thereof in the various calls to `g_pattern_match()`.

Note also that the reverse of a UTF-8 encoded string can in general not be obtained by [func@GLib.strreverse]. This works only if the string does not contain any multibyte characters. GLib offers the [func@GLib.utf8_strreverse] function to reverse UTF-8 encoded strings.

Parameters:

string_length

the length of string (in bytes, i.e. `strlen()`, not [func@GLib.utf8_strlen])

pspec

a PatternSpec

string

the UTF-8 encoded string to match

string_reversed

the reverse of string

Returns:

true if string matches pspec