Method

GioListStorefind_with_equal_func

since: 2.64

Declaration

gboolean
g_list_store_find_with_equal_func (
  GListStore* store,
  GObject* item,
  GEqualFunc equal_func,
  guint* position
)

Description

Looks up the given item in the list store by looping over the items and comparing them with equal_func until the first occurrence of item which matches. If item was not found, then position will not be set, and this method will return FALSE.

item is always passed as second parameter to equal_func.

Since GLib 2.76 it is possible to pass NULL for item.

Available since: 2.64

Parameters

item

Type: GObject

An item.

The argument can be NULL.
The data is owned by the caller of the function.
equal_func

Type: GEqualFunc

A custom equality check function.

position

Type: guint*

The first position of item, if it was found.

The argument will be set by the function.
The argument can be NULL.

Return value

Type: gboolean

Whether store contains item. If it was found, position will be set to the position where item occurred for the first time.