GLib.pattern_match (original) (raw)

Function

GLibpattern_match

deprecated: 2.70

Declaration [src]

gboolean
g_pattern_match (
  GPatternSpec* pspec,
  guint string_length,
  const gchar* string,
  const gchar* string_reversed
)

Description [src]

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, asg_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 g_strreverse(). This works only if the string does not contain any multibyte characters. GLib offers theg_utf8_strreverse() function to reverse UTF-8 encoded strings.

This function is not directly available to language bindings.

Parameters

pspec

Type: GPatternSpec

A GPatternSpec.

The data is owned by the caller of the function.

string_length

Type: guint

The length of string (in bytes, i.e. strlen(), not g_utf8_strlen()).

string

Type: const gchar*

The UTF-8 encoded string to match.

string_reversed

Type: const gchar*

The reverse of string.

Return value

Type: gboolean

TRUE if string matches pspec.