mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-09-27 17:52:58 +02:00
gsocket: Document that g_socket_create_source() holds a socket ref
This is quite important, as it means you can safely let the GSocket drop out of scope while maintaining a reference to the GSource, and the socket will remain open. That means fewer closure structures, simpler code, and fewer allocations. https://bugzilla.gnome.org/show_bug.cgi?id=732081
This commit is contained in:
@@ -3385,8 +3385,9 @@ socket_source_new (GSocket *socket,
|
|||||||
* @condition: a #GIOCondition mask to monitor
|
* @condition: a #GIOCondition mask to monitor
|
||||||
* @cancellable: (allow-none): a %GCancellable or %NULL
|
* @cancellable: (allow-none): a %GCancellable or %NULL
|
||||||
*
|
*
|
||||||
* Creates a %GSource that can be attached to a %GMainContext to monitor
|
* Creates a #GSource that can be attached to a %GMainContext to monitor
|
||||||
* for the availability of the specified @condition on the socket.
|
* for the availability of the specified @condition on the socket. The #GSource
|
||||||
|
* keeps a reference to the @socket.
|
||||||
*
|
*
|
||||||
* The callback on the source is of the #GSocketSourceFunc type.
|
* The callback on the source is of the #GSocketSourceFunc type.
|
||||||
*
|
*
|
||||||
|
Reference in New Issue
Block a user