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

Document clearly async functions not copying its args

Browse Source 
Usually async methods copy/ref its arguments so caller can
forget about them. g_file_replace_contents_async() and
g_output_stream_write_async() are exceptions.

https://bugzilla.gnome.org/show_bug.cgi?id=690525
This commit is contained in:
Xavier Claessens 2013-12-02 14:37:23 -05:00
parent c4e9135352
commit 0f800cd1a8
2 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gio/gfile.c
View File

@ -7311,6 +7311,11 @@ replace_contents_open_callback (GObject *obj,
*
* If @make_backup is %TRUE, this function will attempt to
* make a backup of @file.
*
* <warning><para>No copy of @content will be made, so it must stay valid until
* @callback is called. See g_file_replace_contents_bytes_async() for a #GBytes
* version that will automatically hold a reference to the contents (without
* copying) for the duration of the call.</para></warning>
*/
void
g_file_replace_contents_async (GFile *file,

5
gio/goutputstream.c
View File

@ -787,6 +787,11 @@ async_ready_write_callback_wrapper (GObject *source_object,
*
* For the synchronous, blocking version of this function, see
* g_output_stream_write().
*
* <warning><para>No copy of @buffer will be made, so it must stay valid until
* @callback is called. See g_output_stream_write_bytes_async() for a #GBytes
* version that will automatically hold a reference to the contents (without
* copying) for the duration of the call.</para></warning>
**/
void
g_output_stream_write_async (GOutputStream *stream,