Method

GioListStoresplice

Declaration

void
g_list_store_splice (
  GListStore* store,
  guint position,
  guint n_removals,
  gpointer* additions,
  guint n_additions
)

Description

Changes store by removing n_removals items and adding n_additions items to it. additions must contain n_additions items of type GListStore:item-type. NULL is not permitted.

This function is more efficient than g_list_store_insert() and g_list_store_remove(), because it only emits GListModel::items-changed once for the change.

This function takes a ref on each item in additions.

The parameters position and n_removals must be correct (ie: position + n_removals must be less than or equal to the length of the list at the time this function is called).

Available since:2.44

Parameters

position guint
 

The position at which to make the change.

n_removals guint
 

The number of items to remove.

additions An array of GObject*
 

The items to add.

 The length of the array is specified in the n_additions argument.
 The data is owned by the caller of the function.
n_additions guint
 

The number of items to add.