luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-27 18:10:03 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: Clarify lack of threading guarantees in GArray

Browse Source 
Signed-off-by: Philip Withnall <withnall@endlessm.com>

https://bugzilla.gnome.org/show_bug.cgi?id=786555
This commit is contained in:
Philip Withnall 2017-08-22 15:58:18 +01:00
parent 8cac6797d7
commit 2586eb9921
1 changed files with 11 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
glib/garray.c
View File

@ -244,7 +244,7 @@ g_array_set_clear_func (GArray *array,
* @array: A #GArray
*
* Atomically increments the reference count of @array by one.
* This function is MT-safe and may be called from any thread.
* This function is thread-safe and may be called from any thread.
*
* Returns: The passed in #GArray
*
@ -275,7 +275,7 @@ static gchar *array_free (GRealArray *, ArrayFreeFlags);
*
* Atomically decrements the reference count of @array by one. If the
* reference count drops to 0, all memory allocated by the array is
* released. This function is MT-safe and may be called from any
* released. This function is thread-safe and may be called from any
* thread.
*
* Since: 2.22
@ -326,6 +326,10 @@ g_array_get_element_size (GArray *array)
* If array elements contain dynamically-allocated memory, they should
* be freed separately.
*
* This function is not thread-safe. If using a #GArray from multiple
* threads, use only the atomic g_array_ref() and g_array_unref()
* functions.
*
* Returns: the element data if @free_segment is %FALSE, otherwise
* %NULL. The element data should be freed using g_free().
*/
@ -1031,7 +1035,7 @@ static gpointer *ptr_array_free (GPtrArray *, ArrayFreeFlags);
* Atomically decrements the reference count of @array by one. If the
* reference count drops to 0, the effect is the same as calling
* g_ptr_array_free() with @free_segment set to %TRUE. This function
* is MT-safe and may be called from any thread.
* is thread-safe and may be called from any thread.
*
* Since: 2.22
*/
@ -1062,6 +1066,10 @@ g_ptr_array_unref (GPtrArray *array)
* be freed separately if @free_seg is %TRUE and no #GDestroyNotify
* function has been set for @array.
*
* This function is not thread-safe. If using a #GPtrArray from multiple
* threads, use only the atomic g_ptr_array_ref() and g_ptr_array_unref()
* functions.
*
* Returns: the pointer array if @free_seg is %FALSE, otherwise %NULL.
* The pointer array should be freed using g_free().
*/