RGtk2 (version 2.20.31)

GSocketConnectable: GSocketConnectable

Description

Interface for potential socket endpoints

Arguments

Methods and Functions

gSocketConnectableEnumerate(object) gSocketAddressEnumeratorNext(object, cancellable = NULL, .errwarn = TRUE) gSocketAddressEnumeratorNextAsync(object, cancellable = NULL, callback, user.data = NULL) gSocketAddressEnumeratorNextFinish(object, result, .errwarn = TRUE)

Hierarchy

GInterface
   +----GSocketConnectable
GObject
   +----GSocketAddressEnumerator

Implementations

GSocketConnectable is implemented by GInetSocketAddress, GNetworkAddress, GNetworkService, GSocketAddress and GUnixSocketAddress.

Detailed Description

Objects that describe one or more potential socket endpoints implement GSocketConnectable. Callers can then use gSocketConnectableEnumerate to get a GSocketAddressEnumerator to try out each socket address in turn until one succeeds, as shown in the sample code below.
connect_to_host <- function(hostname, port, cancellable)
{
  addr <- gNetworkAddress(hostname, port)
  enumerator <- addr$enumerate() ## Try each sockaddr until we succeed. conn <- NULL
  while (is.null(conn) && (!is.null(sockaddr <- enumerator$next(cancellable))))
    conn <- connect_to_sockaddr(sockaddr$retval) conn
}

Structures

GSocketConnectable
Interface for objects that contain or generate GSocketAddresses.
GSocketAddressEnumerator
Enumerator type for objects that contain or generate GSocketAddresses.

References

http://library.gnome.org/devel//gio/GSocketConnectable.html