GimpContainer-filter

GimpContainer-filter

Synopsis

GimpContainer *     gimp_container_filter               (const GimpContainer *container,
                                                         GimpObjectFilterFunc filter,
                                                         gpointer user_data);
GimpContainer *     gimp_container_filter_by_name       (const GimpContainer *container,
                                                         const gchar *regexp,
                                                         GError **error);
gchar **            gimp_container_get_filtered_name_array
                                                        (const GimpContainer *container,
                                                         const gchar *regexp,
                                                         gint *length);

Description

Details

gimp_container_filter ()

GimpContainer *     gimp_container_filter               (const GimpContainer *container,
                                                         GimpObjectFilterFunc filter,
                                                         gpointer user_data);

Calls the supplied filter function on each object in container. A return value of TRUE is interpreted as a match.

container :

a GimpContainer to filter

filter :

a GimpObjectFilterFunc

user_data :

a pointer passed to filter

Returns :

a weak GimpContainer filled with matching objects.

gimp_container_filter_by_name ()

GimpContainer *     gimp_container_filter_by_name       (const GimpContainer *container,
                                                         const gchar *regexp,
                                                         GError **error);

This function performs a case-insensitive regular expression search on the names of the GimpObjects in container.

container :

a GimpContainer to filter

regexp :

a regular expression (as a NULL-terminated string)

error :

error location to report errors or NULL

Returns :

a weak GimpContainer filled with matching objects.

gimp_container_get_filtered_name_array ()

gchar **            gimp_container_get_filtered_name_array
                                                        (const GimpContainer *container,
                                                         const gchar *regexp,
                                                         gint *length);