Struct

GLibSequence

Description [src]

struct GSequence {
  /* No available fields */
}

The GSequence struct is an opaque data type representing a [sequence][glib-Sequences] data type.

Functions

g_sequence_foreach_range

Calls func for each item in the range (begin, end) passing user_data to the function. func must not modify the sequence itself.

Available since: 2.14

g_sequence_get

Returns the data that iter points to.

Available since: 2.14

g_sequence_insert_before

Inserts a new item just before the item pointed to by iter.

Available since: 2.14

g_sequence_move

Moves the item pointed to by src to the position indicated by dest. After calling this function dest will point to the position immediately after src. It is allowed for src and dest to point into different sequences.

Available since: 2.14

g_sequence_move_range

Inserts the (begin, end) range at the destination pointed to by dest. The begin and end iters must point into the same sequence. It is allowed for dest to point to a different sequence than the one pointed into by begin and end.

Available since: 2.14

g_sequence_new

Creates a new GSequence. The data_destroy function, if non-NULL will be called on all items when the sequence is destroyed and on items that are removed from the sequence.

Available since: 2.14

g_sequence_range_get_midpoint

Finds an iterator somewhere in the range (begin, end). This iterator will be close to the middle of the range, but is not guaranteed to be exactly in the middle.

Available since: 2.14

g_sequence_remove

Removes the item pointed to by iter. It is an error to pass the end iterator to this function.

Available since: 2.14

g_sequence_remove_range

Removes all items in the (begin, end) range.

Available since: 2.14

g_sequence_set

Changes the data for the item pointed to by iter to be data. If the sequence has a data destroy function associated with it, that function is called on the existing data that iter pointed to.

Available since: 2.14

g_sequence_sort_changed

Moves the data pointed to by iter to a new position as indicated by cmp_func. This function should be called for items in a sequence already sorted according to cmp_func whenever some aspect of an item changes so that cmp_func may return different values for that item.

Available since: 2.14

g_sequence_sort_changed_iter

Like g_sequence_sort_changed(), but uses a GSequenceIterCompareFunc instead of a GCompareDataFunc as the compare function.

Available since: 2.14

g_sequence_swap

Swaps the items pointed to by a and b. It is allowed for a and b to point into difference sequences.

Available since: 2.14

Instance methods

g_sequence_append

Adds a new item to the end of seq.

Available since: 2.14

g_sequence_foreach

Calls func for each item in the sequence passing user_data to the function. func must not modify the sequence itself.

Available since: 2.14

g_sequence_free

Frees the memory allocated for seq. If seq has a data destroy function associated with it, that function is called on all items in seq.

Available since: 2.14

g_sequence_get_begin_iter

Returns the begin iterator for seq.

Available since: 2.14

g_sequence_get_end_iter

Returns the end iterator for seg.

Available since: 2.14

g_sequence_get_iter_at_pos

Returns the iterator at position pos. If pos is negative or larger than the number of items in seq, the end iterator is returned.

Available since: 2.14

g_sequence_get_length

Returns the positive length (>= 0) of seq. Note that this method is O(h) where h' is the height of the tree. It is thus more efficient to useg_sequence_is_empty()` when comparing the length to zero.

Available since: 2.14

g_sequence_insert_sorted

Inserts data into seq using cmp_func to determine the new position. The sequence must already be sorted according to cmp_func; otherwise the new position of data is undefined.

Available since: 2.14

g_sequence_insert_sorted_iter

Like g_sequence_insert_sorted(), but uses a GSequenceIterCompareFunc instead of a GCompareDataFunc as the compare function.

Available since: 2.14

g_sequence_is_empty

Returns TRUE if the sequence contains zero items.

Available since: 2.48

g_sequence_lookup

Returns an iterator pointing to the position of the first item found equal to data according to cmp_func and cmp_data. If more than one item is equal, it is not guaranteed that it is the first which is returned. In that case, you can use g_sequence_iter_next() and g_sequence_iter_prev() to get others.

Available since: 2.28

g_sequence_lookup_iter

Like g_sequence_lookup(), but uses a GSequenceIterCompareFunc instead of a GCompareDataFunc as the compare function.

Available since: 2.28

g_sequence_prepend

Adds a new item to the front of seq.

Available since: 2.14

g_sequence_search

Returns an iterator pointing to the position where data would be inserted according to cmp_func and cmp_data.

Available since: 2.14

g_sequence_search_iter

Like g_sequence_search(), but uses a GSequenceIterCompareFunc instead of a GCompareDataFunc as the compare function.

Available since: 2.14

g_sequence_sort

Sorts seq using cmp_func.

Available since: 2.14

g_sequence_sort_iter

Like g_sequence_sort(), but uses a GSequenceIterCompareFunc instead of a GCompareDataFunc as the compare function.

Available since: 2.14