Method

GtkSourceSnippetManagerlist_matching

Declaration [src]

GListModel*
gtk_source_snippet_manager_list_matching (
  GtkSourceSnippetManager* self,
  const gchar* group,
  const gchar* language_id,
  const gchar* trigger_prefix
)

Description [src]

Queries the known snippets for those matching group, language_id, and/or trigger_prefix.

If any of these are NULL, they will be ignored when filtering the available snippets.

The GListModel only contains information about the available snippets until g_list_model_get_item() is called for a specific snippet. This helps reduce the number of GObject‘s that are created at runtime to those needed by the calling application.

Parameters

group const gchar*
 

A group name or NULL.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
language_id const gchar*
 

A GtkSourceLanguage:id or NULL.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
trigger_prefix const gchar*
 

A prefix for a trigger to activate.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.

Return value

Returns: A list model of GObject
 

A GListModel of GtkSourceSnippet.

 The caller of the method takes ownership of the data, and is responsible for freeing it.