luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-09 19:06:15 +01:00
Code Issues Packages Projects Releases Wiki Activity

gio: Add missing documentation for G{Proxy,Socket}AddressEnumerator

Browse Source 
Signed-off-by: Philip Withnall <withnall@endlessm.com>
This commit is contained in:
Philip Withnall 2018-11-28 13:10:55 +00:00
parent 778132d54c
commit c3fbfbd2bd
4 changed files with 54 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
gio/gproxyaddressenumerator.c
View File

@ -37,6 +37,22 @@
#include "gsocketaddressenumerator.h"
#include "gsocketconnectable.h"
/**
* SECTION:gproxyaddressenumerator
* @short_description: Proxy wrapper enumerator for socket addresses
* @include: gio/gio.h
*
* #GProxyAddressEnumerator is a wrapper around #GSocketAddressEnumerator which
* takes the #GSocketAddress instances returned by the #GSocketAddressEnumerator
* and wraps them in #GProxyAddress instances, using the given
* #GProxyAddressEnumerator:proxy-resolver.
*
* This enumerator will be returned (for example, by
* g_socket_connectable_enumerate()) as appropriate when a proxy is configured;
* there should be no need to manually wrap a #GSocketAddressEnumerator instance
* with one.
*/
#define GET_PRIVATE(o) (G_PROXY_ADDRESS_ENUMERATOR (o)->priv)
enum

7
gio/gproxyaddressenumerator.h
View File

@ -49,12 +49,19 @@ typedef struct _GProxyAddressEnumeratorPrivate GProxyAddressEnumeratorPrivate;
struct _GProxyAddressEnumerator
{
/*< private >*/
GSocketAddressEnumerator parent_instance;
GProxyAddressEnumeratorPrivate *priv;
};
/**
* GProxyAddressEnumeratorClass:
*
* Class structure for #GProxyAddressEnumerator.
*/
struct _GProxyAddressEnumeratorClass
{
/*< private >*/
GSocketAddressEnumeratorClass parent_class;
void (*_g_reserved1) (void);

20
gio/gsocketaddressenumerator.c
View File

@ -22,6 +22,26 @@
#include "gtask.h"
/**
* SECTION:gsocketaddressenumerator
* @short_description: Enumerator for socket addresses
* @include: gio/gio.h
*
* #GSocketAddressEnumerator is an enumerator type for #GSocketAddress
* instances. It is returned by enumeration functions such as
* g_socket_connectable_enumerate(), which returns a #GSocketAddressEnumerator
* to list all the #GSocketAddresses which could be used to connect to that
* #GSocketConnectable.
*
* Enumeration is typically a blocking operation, so the asynchronous methods
* g_socket_address_enumerator_next_async() and
* g_socket_address_enumerator_next_finish() should be used where possible.
*
* Each #GSocketAddressEnumerator can only be enumerated once. Once
* g_socket_address_enumerator_next() has returned %NULL (and no error), further
* enumeration with that #GSocketAddressEnumerator is not possible, and it can
* be unreffed.
*/
G_DEFINE_ABSTRACT_TYPE (GSocketAddressEnumerator, g_socket_address_enumerator, G_TYPE_OBJECT)

12
gio/gsocketaddressenumerator.h
View File

@ -44,14 +44,24 @@ typedef struct _GSocketAddressEnumeratorClass GSocketAddressEnumeratorClass;
struct _GSocketAddressEnumerator
{
/*< private >*/
GObject parent_instance;
};
/**
* GSocketAddressEnumeratorClass:
* @next: Virtual method for g_socket_address_enumerator_next().
* @next_async: Virtual method for g_socket_address_enumerator_next_async().
* @next_finish: Virtual method for g_socket_address_enumerator_next_finish().
*
* Class structure for #GSocketAddressEnumerator.
*/
struct _GSocketAddressEnumeratorClass
{
/*< private >*/
GObjectClass parent_class;
/*< public >*/
/* Virtual Table */
GSocketAddress * (* next) (GSocketAddressEnumerator *enumerator,