Enumerator type for objects that contain or generate SocketAddresses. More...
#include <giomm/socketaddressenumerator.h>

Public Member Functions | |
| virtual | ~SocketAddressEnumerator () |
| GSocketAddressEnumerator* | gobj () |
| Provides access to the underlying C GObject. | |
| const GSocketAddressEnumerator* | gobj () const |
| Provides access to the underlying C GObject. | |
| GSocketAddressEnumerator* | gobj_copy () |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
| Glib::RefPtr< SocketAddress > | next (const Glib::RefPtr< Cancellable >& cancellable) |
| Retrieves the next SocketAddress from enumerator. | |
| Glib::RefPtr< SocketAddress > | next () |
| void | next_async (const Glib::RefPtr< Cancellable >& cancellable, const SlotAsyncReady& slot) |
| void | next_async (const SlotAsyncReady& slot) |
| Glib::RefPtr< SocketAddress > | next_finish (const Glib::RefPtr< AsyncResult >& result) |
| Retrieves the result of a completed call to g_socket_address_enumerator_next_async(). | |
Related Functions | |
(Note that these are not member functions.) | |
| Glib::RefPtr < Gio::SocketAddressEnumerator > | wrap (GSocketAddressEnumerator* object, bool take_copy=false) |
| A Glib::wrap() method for this object. | |
Enumerator type for objects that contain or generate SocketAddresses.
| virtual Gio::SocketAddressEnumerator::~SocketAddressEnumerator | ( | ) | [virtual] |
| const GSocketAddressEnumerator* Gio::SocketAddressEnumerator::gobj | ( | ) | const [inline] |
Provides access to the underlying C GObject.
Reimplemented from Glib::ObjectBase.
| GSocketAddressEnumerator* Gio::SocketAddressEnumerator::gobj | ( | ) | [inline] |
Provides access to the underlying C GObject.
Reimplemented from Glib::ObjectBase.
| GSocketAddressEnumerator* Gio::SocketAddressEnumerator::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
| Glib::RefPtr<SocketAddress> Gio::SocketAddressEnumerator::next | ( | ) |
| Glib::RefPtr<SocketAddress> Gio::SocketAddressEnumerator::next | ( | const Glib::RefPtr< Cancellable >& | cancellable | ) |
Retrieves the next SocketAddress from enumerator.
Note that this may block for some amount of time. (Eg, a NetworkAddress may need to do a DNS lookup before it can return an address.) Use g_socket_address_enumerator_next_async() if you need to avoid blocking.
If enumerator is expected to yield addresses, but for some reason is unable to (eg, because of a DNS error), then the first call to g_socket_address_enumerator_next() will return an appropriate error in * error. However, if the first call to g_socket_address_enumerator_next() succeeds, then any further internal errors (other than cancellable being triggered) will be ignored.
| cancellable | Optional Cancellable object, 0 to ignore. |
0 on error (in which case* error will be set) or if there are no more addresses. | void Gio::SocketAddressEnumerator::next_async | ( | const SlotAsyncReady & | slot | ) |
| void Gio::SocketAddressEnumerator::next_async | ( | const Glib::RefPtr< Cancellable >& | cancellable, | |
| const SlotAsyncReady & | slot | |||
| ) |
| Glib::RefPtr<SocketAddress> Gio::SocketAddressEnumerator::next_finish | ( | const Glib::RefPtr< AsyncResult >& | result | ) |
Retrieves the result of a completed call to g_socket_address_enumerator_next_async().
See g_socket_address_enumerator_next() for more information about error handling.
| result | A AsyncResult. |
0 on error (in which case* error will be set) or if there are no more addresses. | Glib::RefPtr< Gio::SocketAddressEnumerator > wrap | ( | GSocketAddressEnumerator * | object, | |
| bool | take_copy = false | |||
| ) | [related] |
A Glib::wrap() method for this object.
| object | The C instance. | |
| take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |
1.6.1