garray.h File Reference

#include <glib/gtypes.h>

Go to the source code of this file.

Data Structures
struct	_GArray
struct	_GByteArray
struct	_GPtrArray

Macros
#define	g_array_append_val(a, v)   g_array_append_vals (a, &(v), 1)
#define	g_array_prepend_val(a, v)   g_array_prepend_vals (a, &(v), 1)
#define	g_array_insert_val(a, i, v)   g_array_insert_vals (a, i, &(v), 1)
#define	g_array_index(a, t, i)   (((t*) (void *) (a)->data) [(i)])
#define	g_ptr_array_index(array, index_)   ((array)->pdata)[index_]

Typedefs
typedef typedefG_BEGIN_DECLS struct _GBytes	GBytes
typedef struct _GArray	GArray
typedef struct _GByteArray	GByteArray
typedef struct _GPtrArray	GPtrArray

Functions
GLIB_AVAILABLE_IN_ALL GArray *	g_array_new (gboolean zero_terminated, gboolean clear_, guint element_size)
GLIB_AVAILABLE_IN_2_76 GArray *	g_array_new_take (gpointer data, gsize len, gboolean clear, gsize element_size)
GLIB_AVAILABLE_IN_2_76 GArray *	g_array_new_take_zero_terminated (gpointer data, gboolean clear, gsize element_size)
GLIB_AVAILABLE_IN_2_64 gpointer	g_array_steal (GArray *array, gsize *len)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_sized_new (gboolean zero_terminated, gboolean clear_, guint element_size, guint reserved_size)
GLIB_AVAILABLE_IN_2_62 GArray *	g_array_copy (GArray *array)
GLIB_AVAILABLE_IN_ALL gchar *	g_array_free (GArray *array, gboolean free_segment)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_ref (GArray *array)
GLIB_AVAILABLE_IN_ALL void	g_array_unref (GArray *array)
GLIB_AVAILABLE_IN_ALL guint	g_array_get_element_size (GArray *array)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_append_vals (GArray *array, gconstpointer data, guint len)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_prepend_vals (GArray *array, gconstpointer data, guint len)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_insert_vals (GArray *array, guint index_, gconstpointer data, guint len)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_set_size (GArray *array, guint length)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_remove_index (GArray *array, guint index_)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_remove_index_fast (GArray *array, guint index_)
GLIB_AVAILABLE_IN_ALL GArray *	g_array_remove_range (GArray *array, guint index_, guint length)
GLIB_AVAILABLE_IN_ALL void	g_array_sort (GArray *array, GCompareFunc compare_func)
GLIB_AVAILABLE_IN_ALL void	g_array_sort_with_data (GArray *array, GCompareDataFunc compare_func, gpointer user_data)
GLIB_AVAILABLE_IN_2_62 gboolean	g_array_binary_search (GArray *array, gconstpointer target, GCompareFunc compare_func, guint *out_match_index)
GLIB_AVAILABLE_IN_ALL void	g_array_set_clear_func (GArray *array, GDestroyNotify clear_func)
GLIB_AVAILABLE_IN_ALL GPtrArray *	g_ptr_array_new (void)
GLIB_AVAILABLE_IN_ALL GPtrArray *	g_ptr_array_new_with_free_func (GDestroyNotify element_free_func)
GLIB_AVAILABLE_IN_2_76 GPtrArray *	g_ptr_array_new_take (gpointer *data, gsize len, GDestroyNotify element_free_func)
GLIB_AVAILABLE_IN_2_76 GPtrArray *	g_ptr_array_new_from_array (gpointer *data, gsize len, GCopyFunc copy_func, gpointer copy_func_user_data, GDestroyNotify element_free_func)
GLIB_AVAILABLE_IN_2_64 gpointer *	g_ptr_array_steal (GPtrArray *array, gsize *len)
GLIB_AVAILABLE_IN_2_62 GPtrArray *	g_ptr_array_copy (GPtrArray *array, GCopyFunc func, gpointer user_data)
GLIB_AVAILABLE_IN_ALL GPtrArray *	g_ptr_array_sized_new (guint reserved_size)
GLIB_AVAILABLE_IN_ALL GPtrArray *	g_ptr_array_new_full (guint reserved_size, GDestroyNotify element_free_func)
GLIB_AVAILABLE_IN_2_74 GPtrArray *	g_ptr_array_new_null_terminated (guint reserved_size, GDestroyNotify element_free_func, gboolean null_terminated)
GLIB_AVAILABLE_IN_2_76 GPtrArray *	g_ptr_array_new_take_null_terminated (gpointer *data, GDestroyNotify element_free_func)
GLIB_AVAILABLE_IN_2_76 GPtrArray *	g_ptr_array_new_from_null_terminated_array (gpointer *data, GCopyFunc copy_func, gpointer copy_func_user_data, GDestroyNotify element_free_func)
GLIB_AVAILABLE_IN_ALL gpointer *	g_ptr_array_free (GPtrArray *array, gboolean free_seg)
GLIB_AVAILABLE_IN_ALL GPtrArray *	g_ptr_array_ref (GPtrArray *array)
GLIB_AVAILABLE_IN_ALL void	g_ptr_array_unref (GPtrArray *array)
GLIB_AVAILABLE_IN_ALL void	g_ptr_array_set_free_func (GPtrArray *array, GDestroyNotify element_free_func)
GLIB_AVAILABLE_IN_ALL void	g_ptr_array_set_size (GPtrArray *array, gint length)
GLIB_AVAILABLE_IN_ALL gpointer	g_ptr_array_remove_index (GPtrArray *array, guint index_)
GLIB_AVAILABLE_IN_ALL gpointer	g_ptr_array_remove_index_fast (GPtrArray *array, guint index_)
GLIB_AVAILABLE_IN_2_58 gpointer	g_ptr_array_steal_index (GPtrArray *array, guint index_)
GLIB_AVAILABLE_IN_2_58 gpointer	g_ptr_array_steal_index_fast (GPtrArray *array, guint index_)
GLIB_AVAILABLE_IN_ALL gboolean	g_ptr_array_remove (GPtrArray *array, gpointer data)
GLIB_AVAILABLE_IN_ALL gboolean	g_ptr_array_remove_fast (GPtrArray *array, gpointer data)
GLIB_AVAILABLE_IN_ALL GPtrArray *	g_ptr_array_remove_range (GPtrArray *array, guint index_, guint length)
GLIB_AVAILABLE_IN_ALL void	g_ptr_array_add (GPtrArray *array, gpointer data)
GLIB_AVAILABLE_IN_2_62 void	g_ptr_array_extend (GPtrArray *array_to_extend, GPtrArray *array, GCopyFunc func, gpointer user_data)
GLIB_AVAILABLE_IN_2_62 void	g_ptr_array_extend_and_steal (GPtrArray *array_to_extend, GPtrArray *array)
GLIB_AVAILABLE_IN_2_40 void	g_ptr_array_insert (GPtrArray *array, gint index_, gpointer data)
GLIB_AVAILABLE_IN_ALL void	g_ptr_array_sort (GPtrArray *array, GCompareFunc compare_func)
GLIB_AVAILABLE_IN_ALL void	g_ptr_array_sort_with_data (GPtrArray *array, GCompareDataFunc compare_func, gpointer user_data)
GLIB_AVAILABLE_IN_2_76 void	g_ptr_array_sort_values (GPtrArray *array, GCompareFunc compare_func)
GLIB_AVAILABLE_IN_2_76 void	g_ptr_array_sort_values_with_data (GPtrArray *array, GCompareDataFunc compare_func, gpointer user_data)
GLIB_AVAILABLE_IN_ALL void	g_ptr_array_foreach (GPtrArray *array, GFunc func, gpointer user_data)
GLIB_AVAILABLE_IN_2_54 gboolean	g_ptr_array_find (GPtrArray *haystack, gconstpointer needle, guint *index_)
GLIB_AVAILABLE_IN_2_54 gboolean	g_ptr_array_find_with_equal_func (GPtrArray *haystack, gconstpointer needle, GEqualFunc equal_func, guint *index_)
GLIB_AVAILABLE_IN_2_74 gboolean	g_ptr_array_is_null_terminated (GPtrArray *array)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_new (void)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_new_take (guint8 *data, gsize len)
GLIB_AVAILABLE_IN_2_64 guint8 *	g_byte_array_steal (GByteArray *array, gsize *len)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_sized_new (guint reserved_size)
GLIB_AVAILABLE_IN_ALL guint8 *	g_byte_array_free (GByteArray *array, gboolean free_segment)
GLIB_AVAILABLE_IN_ALL GBytes *	g_byte_array_free_to_bytes (GByteArray *array)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_ref (GByteArray *array)
GLIB_AVAILABLE_IN_ALL void	g_byte_array_unref (GByteArray *array)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_append (GByteArray *array, const guint8 *data, guint len)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_prepend (GByteArray *array, const guint8 *data, guint len)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_set_size (GByteArray *array, guint length)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_remove_index (GByteArray *array, guint index_)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_remove_index_fast (GByteArray *array, guint index_)
GLIB_AVAILABLE_IN_ALL GByteArray *	g_byte_array_remove_range (GByteArray *array, guint index_, guint length)
GLIB_AVAILABLE_IN_ALL void	g_byte_array_sort (GByteArray *array, GCompareFunc compare_func)
GLIB_AVAILABLE_IN_ALL void	g_byte_array_sort_with_data (GByteArray *array, GCompareDataFunc compare_func, gpointer user_data)

Macro Definition Documentation

g_array_append_val

#define g_array_append_val	(		a,
			v )   g_array_append_vals (a, &(v), 1)

Definition at line 66 of file garray.h.

g_array_index

#define g_array_index	(		a,
			t,
			i )   (((t*) (void *) (a)->data) [(i)])

Definition at line 69 of file garray.h.

g_array_insert_val

#define g_array_insert_val	(		a,
			i,
			v )   g_array_insert_vals (a, i, &(v), 1)

Definition at line 68 of file garray.h.

g_array_prepend_val

#define g_array_prepend_val	(		a,
			v )   g_array_prepend_vals (a, &(v), 1)

Definition at line 67 of file garray.h.

g_ptr_array_index

#define g_ptr_array_index	(		array,
			index_ )   ((array)->pdata)[index_]

Definition at line 149 of file garray.h.

Typedef Documentation

GArray

typedef struct _GArray GArray

Definition at line 39 of file garray.h.

GByteArray

typedef struct _GByteArray GByteArray

Definition at line 40 of file garray.h.

GBytes

typedef typedefG_BEGIN_DECLS struct _GBytes GBytes

Definition at line 38 of file garray.h.

GPtrArray

typedef struct _GPtrArray GPtrArray

Definition at line 41 of file garray.h.

Function Documentation

g_array_append_vals()

GLIB_AVAILABLE_IN_ALL GArray * g_array_append_vals	(	GArray *	array,
		gconstpointer	data,
		guint	len )

g_array_binary_search()

GLIB_AVAILABLE_IN_2_62 gboolean g_array_binary_search	(	GArray *	array,
		gconstpointer	target,
		GCompareFunc	compare_func,
		guint *	out_match_index )

g_array_copy()

GLIB_AVAILABLE_IN_2_62 GArray * g_array_copy

(

GArray *

array

)

g_array_free()

GLIB_AVAILABLE_IN_ALL gchar * g_array_free	(	GArray *	array,
		gboolean	free_segment )

g_array_get_element_size()

GLIB_AVAILABLE_IN_ALL guint g_array_get_element_size

(

GArray *

array

)

g_array_insert_vals()

GLIB_AVAILABLE_IN_ALL GArray * g_array_insert_vals	(	GArray *	array,
		guint	index_,
		gconstpointer	data,
		guint	len )

g_array_new()

GLIB_AVAILABLE_IN_ALL GArray * g_array_new	(	gboolean	zero_terminated,
		gboolean	clear_,
		guint	element_size )

g_array_new_take()

GLIB_AVAILABLE_IN_2_76 GArray * g_array_new_take	(	gpointer	data,
		gsize	len,
		gboolean	clear,
		gsize	element_size )

g_array_new_take_zero_terminated()

GLIB_AVAILABLE_IN_2_76 GArray * g_array_new_take_zero_terminated	(	gpointer	data,
		gboolean	clear,
		gsize	element_size )

g_array_prepend_vals()

GLIB_AVAILABLE_IN_ALL GArray * g_array_prepend_vals	(	GArray *	array,
		gconstpointer	data,
		guint	len )

g_array_ref()

GLIB_AVAILABLE_IN_ALL GArray * g_array_ref

(

GArray *

array

)

g_array_remove_index()

GLIB_AVAILABLE_IN_ALL GArray * g_array_remove_index	(	GArray *	array,
		guint	index_ )

g_array_remove_index_fast()

GLIB_AVAILABLE_IN_ALL GArray * g_array_remove_index_fast	(	GArray *	array,
		guint	index_ )

g_array_remove_range()

GLIB_AVAILABLE_IN_ALL GArray * g_array_remove_range	(	GArray *	array,
		guint	index_,
		guint	length )

g_array_set_clear_func()

GLIB_AVAILABLE_IN_ALL void g_array_set_clear_func	(	GArray *	array,
		GDestroyNotify	clear_func )

g_array_set_size()

GLIB_AVAILABLE_IN_ALL GArray * g_array_set_size	(	GArray *	array,
		guint	length )

g_array_sized_new()

GLIB_AVAILABLE_IN_ALL GArray * g_array_sized_new	(	gboolean	zero_terminated,
		gboolean	clear_,
		guint	element_size,
		guint	reserved_size )

g_array_sort()

GLIB_AVAILABLE_IN_ALL void g_array_sort	(	GArray *	array,
		GCompareFunc	compare_func )

g_array_sort_with_data()

GLIB_AVAILABLE_IN_ALL void g_array_sort_with_data	(	GArray *	array,
		GCompareDataFunc	compare_func,
		gpointer	user_data )

g_array_steal()

GLIB_AVAILABLE_IN_2_64 gpointer g_array_steal	(	GArray *	array,
		gsize *	len )

g_array_unref()

GLIB_AVAILABLE_IN_ALL void g_array_unref

(

GArray *

array

)

g_byte_array_append()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_append	(	GByteArray *	array,
		const guint8 *	data,
		guint	len )

g_byte_array_free()

GLIB_AVAILABLE_IN_ALL guint8 * g_byte_array_free	(	GByteArray *	array,
		gboolean	free_segment )

g_byte_array_free_to_bytes()

GLIB_AVAILABLE_IN_ALL GBytes * g_byte_array_free_to_bytes

(

GByteArray *

array

)

g_byte_array_new()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_new

(

void

)

g_byte_array_new_take()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_new_take	(	guint8 *	data,
		gsize	len )

g_byte_array_prepend()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_prepend	(	GByteArray *	array,
		const guint8 *	data,
		guint	len )

g_byte_array_ref()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_ref

(

GByteArray *

array

)

g_byte_array_remove_index()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_remove_index	(	GByteArray *	array,
		guint	index_ )

g_byte_array_remove_index_fast()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_remove_index_fast	(	GByteArray *	array,
		guint	index_ )

g_byte_array_remove_range()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_remove_range	(	GByteArray *	array,
		guint	index_,
		guint	length )

g_byte_array_set_size()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_set_size	(	GByteArray *	array,
		guint	length )

g_byte_array_sized_new()

GLIB_AVAILABLE_IN_ALL GByteArray * g_byte_array_sized_new

(

guint

reserved_size

)

g_byte_array_sort()

GLIB_AVAILABLE_IN_ALL void g_byte_array_sort	(	GByteArray *	array,
		GCompareFunc	compare_func )

g_byte_array_sort_with_data()

GLIB_AVAILABLE_IN_ALL void g_byte_array_sort_with_data	(	GByteArray *	array,
		GCompareDataFunc	compare_func,
		gpointer	user_data )

g_byte_array_steal()

GLIB_AVAILABLE_IN_2_64 guint8 * g_byte_array_steal	(	GByteArray *	array,
		gsize *	len )

g_byte_array_unref()

GLIB_AVAILABLE_IN_ALL void g_byte_array_unref

(

GByteArray *

array

)

g_ptr_array_add()

GLIB_AVAILABLE_IN_ALL void g_ptr_array_add	(	GPtrArray *	array,
		gpointer	data )

g_ptr_array_copy()

GLIB_AVAILABLE_IN_2_62 GPtrArray * g_ptr_array_copy	(	GPtrArray *	array,
		GCopyFunc	func,
		gpointer	user_data )

g_ptr_array_extend()

GLIB_AVAILABLE_IN_2_62 void g_ptr_array_extend	(	GPtrArray *	array_to_extend,
		GPtrArray *	array,
		GCopyFunc	func,
		gpointer	user_data )

g_ptr_array_extend_and_steal()

GLIB_AVAILABLE_IN_2_62 void g_ptr_array_extend_and_steal	(	GPtrArray *	array_to_extend,
		GPtrArray *	array )

g_ptr_array_find()

GLIB_AVAILABLE_IN_2_54 gboolean g_ptr_array_find	(	GPtrArray *	haystack,
		gconstpointer	needle,
		guint *	index_ )

g_ptr_array_find_with_equal_func()

GLIB_AVAILABLE_IN_2_54 gboolean g_ptr_array_find_with_equal_func	(	GPtrArray *	haystack,
		gconstpointer	needle,
		GEqualFunc	equal_func,
		guint *	index_ )

g_ptr_array_foreach()

GLIB_AVAILABLE_IN_ALL void g_ptr_array_foreach	(	GPtrArray *	array,
		GFunc	func,
		gpointer	user_data )

g_ptr_array_free()

GLIB_AVAILABLE_IN_ALL gpointer * g_ptr_array_free	(	GPtrArray *	array,
		gboolean	free_seg )

g_ptr_array_insert()

GLIB_AVAILABLE_IN_2_40 void g_ptr_array_insert	(	GPtrArray *	array,
		gint	index_,
		gpointer	data )

g_ptr_array_is_null_terminated()

GLIB_AVAILABLE_IN_2_74 gboolean g_ptr_array_is_null_terminated

(

GPtrArray *

array

)

g_ptr_array_new()

GLIB_AVAILABLE_IN_ALL GPtrArray * g_ptr_array_new

(

void

)

g_ptr_array_new_from_array()

GLIB_AVAILABLE_IN_2_76 GPtrArray * g_ptr_array_new_from_array	(	gpointer *	data,
		gsize	len,
		GCopyFunc	copy_func,
		gpointer	copy_func_user_data,
		GDestroyNotify	element_free_func )

g_ptr_array_new_from_null_terminated_array()

GLIB_AVAILABLE_IN_2_76 GPtrArray * g_ptr_array_new_from_null_terminated_array	(	gpointer *	data,
		GCopyFunc	copy_func,
		gpointer	copy_func_user_data,
		GDestroyNotify	element_free_func )

g_ptr_array_new_full()

GLIB_AVAILABLE_IN_ALL GPtrArray * g_ptr_array_new_full	(	guint	reserved_size,
		GDestroyNotify	element_free_func )

g_ptr_array_new_null_terminated()

GLIB_AVAILABLE_IN_2_74 GPtrArray * g_ptr_array_new_null_terminated	(	guint	reserved_size,
		GDestroyNotify	element_free_func,
		gboolean	null_terminated )

g_ptr_array_new_take()

GLIB_AVAILABLE_IN_2_76 GPtrArray * g_ptr_array_new_take	(	gpointer *	data,
		gsize	len,
		GDestroyNotify	element_free_func )

g_ptr_array_new_take_null_terminated()

GLIB_AVAILABLE_IN_2_76 GPtrArray * g_ptr_array_new_take_null_terminated	(	gpointer *	data,
		GDestroyNotify	element_free_func )

g_ptr_array_new_with_free_func()

GLIB_AVAILABLE_IN_ALL GPtrArray * g_ptr_array_new_with_free_func

(

GDestroyNotify

element_free_func

)

g_ptr_array_ref()

GLIB_AVAILABLE_IN_ALL GPtrArray * g_ptr_array_ref

(

GPtrArray *

array

)

g_ptr_array_remove()

GLIB_AVAILABLE_IN_ALL gboolean g_ptr_array_remove	(	GPtrArray *	array,
		gpointer	data )

g_ptr_array_remove_fast()

GLIB_AVAILABLE_IN_ALL gboolean g_ptr_array_remove_fast	(	GPtrArray *	array,
		gpointer	data )

g_ptr_array_remove_index()

GLIB_AVAILABLE_IN_ALL gpointer g_ptr_array_remove_index	(	GPtrArray *	array,
		guint	index_ )

g_ptr_array_remove_index_fast()

GLIB_AVAILABLE_IN_ALL gpointer g_ptr_array_remove_index_fast	(	GPtrArray *	array,
		guint	index_ )

g_ptr_array_remove_range()

GLIB_AVAILABLE_IN_ALL GPtrArray * g_ptr_array_remove_range	(	GPtrArray *	array,
		guint	index_,
		guint	length )

g_ptr_array_set_free_func()

GLIB_AVAILABLE_IN_ALL void g_ptr_array_set_free_func	(	GPtrArray *	array,
		GDestroyNotify	element_free_func )

g_ptr_array_set_size()

GLIB_AVAILABLE_IN_ALL void g_ptr_array_set_size	(	GPtrArray *	array,
		gint	length )

g_ptr_array_sized_new()

GLIB_AVAILABLE_IN_ALL GPtrArray * g_ptr_array_sized_new

(

guint

reserved_size

)

g_ptr_array_sort()

GLIB_AVAILABLE_IN_ALL void g_ptr_array_sort	(	GPtrArray *	array,
		GCompareFunc	compare_func )

g_ptr_array_sort_values()

GLIB_AVAILABLE_IN_2_76 void g_ptr_array_sort_values	(	GPtrArray *	array,
		GCompareFunc	compare_func )

g_ptr_array_sort_values_with_data()

GLIB_AVAILABLE_IN_2_76 void g_ptr_array_sort_values_with_data	(	GPtrArray *	array,
		GCompareDataFunc	compare_func,
		gpointer	user_data )

g_ptr_array_sort_with_data()

GLIB_AVAILABLE_IN_ALL void g_ptr_array_sort_with_data	(	GPtrArray *	array,
		GCompareDataFunc	compare_func,
		gpointer	user_data )

g_ptr_array_steal()

GLIB_AVAILABLE_IN_2_64 gpointer * g_ptr_array_steal	(	GPtrArray *	array,
		gsize *	len )

g_ptr_array_steal_index()

GLIB_AVAILABLE_IN_2_58 gpointer g_ptr_array_steal_index	(	GPtrArray *	array,
		guint	index_ )

g_ptr_array_steal_index_fast()

GLIB_AVAILABLE_IN_2_58 gpointer g_ptr_array_steal_index_fast	(	GPtrArray *	array,
		guint	index_ )

g_ptr_array_unref()

GLIB_AVAILABLE_IN_ALL void g_ptr_array_unref

(

GPtrArray *

array

)