Class PatternSpec

All Implemented Interfaces:
PointerInterface

public class PatternSpec extends Record
A GPatternSpec struct is the 'compiled' form of a pattern. This
structure is opaque and its fields cannot be accessed directly.

https://docs.gtk.org/glib/struct.PatternSpec.html

  • Constructor Details

    • PatternSpec

      public PatternSpec(PointerContainer pointer)
    • PatternSpec

      public PatternSpec(@Nonnull Str pattern)
      Compiles a pattern to a #GPatternSpec.
      Parameters:
      pattern - a zero-terminated UTF-8 encoded string
    • PatternSpec

      public PatternSpec(String pattern)
      Compiles a pattern to a #GPatternSpec.
      Parameters:
      pattern - a zero-terminated UTF-8 encoded string
  • Method Details

    • getClassHandler

      public static ClassHandler getClassHandler()
    • copy

      public PatternSpec copy()
      Copies @pspec in a new #GPatternSpec.
      Returns:
      a copy of @pspec.
    • equal

      public boolean equal(@Nonnull PatternSpec pspec2)
      Compares two compiled pattern specs and returns whether they will
      match the same set of strings.
      Parameters:
      pspec2 - another #GPatternSpec
      Returns:
      Whether the compiled patterns are equal
    • free

      public void free()
      Frees the memory allocated for the #GPatternSpec.
    • match

      public boolean match(long string_length, @Nonnull Str string, @Nullable Str string_reversed)
      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
      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 g_strreverse(). This works only if the string
      does not contain any multibyte characters. GLib offers the
      g_utf8_strreverse() function to reverse UTF-8 encoded strings.
      Parameters:
      string_length - the length of @string (in bytes, i.e. strlen(), not g_utf8_strlen())
      string - the UTF-8 encoded string to match
      string_reversed - the reverse of @string or %NULL
      Returns:
      %TRUE if @string matches @pspec
    • match

      public boolean match(long string_length, String string, String string_reversed)
      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
      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 g_strreverse(). This works only if the string
      does not contain any multibyte characters. GLib offers the
      g_utf8_strreverse() function to reverse UTF-8 encoded strings.
      Parameters:
      string_length - the length of @string (in bytes, i.e. strlen(), not g_utf8_strlen())
      string - the UTF-8 encoded string to match
      string_reversed - the reverse of @string or %NULL
      Returns:
      %TRUE if @string matches @pspec
    • matchString

      public boolean matchString(@Nonnull Str string)
      Matches a string against a compiled pattern. If the string is to be
      matched against more than one pattern, consider using
      g_pattern_match() instead while supplying the reversed string.
      Parameters:
      string - the UTF-8 encoded string to match
      Returns:
      %TRUE if @string matches @pspec
    • matchString

      public boolean matchString(String string)
      Matches a string against a compiled pattern. If the string is to be
      matched against more than one pattern, consider using
      g_pattern_match() instead while supplying the reversed string.
      Parameters:
      string - the UTF-8 encoded string to match
      Returns:
      %TRUE if @string matches @pspec
    • getTypeID

      public static long getTypeID()
    • getParentTypeID

      public static long getParentTypeID()
    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()
    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()
    • getInstanceSize

      public static int getInstanceSize()