luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-12-06 16:44:51 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add advice on g_cancellable_reset

Browse Source 
Don't use it at home.
This commit is contained in:
Matthias Clasen
2014-10-06 22:41:06 -04:00
parent d6dc0de8bf
commit af0a8911bc
1 changed files with 7 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
gio/gcancellable.c
View File

@@ -244,6 +244,13 @@ g_cancellable_get_current (void)
* *
* If cancellable is currently in use by any cancellable operation * If cancellable is currently in use by any cancellable operation
* then the behavior of this function is undefined. * then the behavior of this function is undefined.
*
* Note that it is generally not a good idea to reuse an existing
* cancellable for more operations after it has been cancelled once,
* as this function might tempt you to do. The recommended practice
* is to drop the reference to a cancellable after cancelling it,
* and let it die with the outstanding async operations. You should
* create a fresh cancellable for further async operations.
**/ **/
void void
g_cancellable_reset (GCancellable *cancellable) g_cancellable_reset (GCancellable *cancellable)