GI.Gio.Objects.SocketAddressEnumerator

Enumerator type for objects that contain or generate SocketAddress<!-- -->es.

Exported types

newtype SocketAddressEnumerator

Constructors

SocketAddressEnumerator (ManagedPtr SocketAddressEnumerator)

Instances

GObject SocketAddressEnumerator

Methods

gobjectType :: SocketAddressEnumerator -> IO GType

IsObject SocketAddressEnumerator

IsSocketAddressEnumerator SocketAddressEnumerator

((~) * info (ResolveSocketAddressEnumeratorMethod t SocketAddressEnumerator), MethodInfo * info SocketAddressEnumerator p) => IsLabel t (SocketAddressEnumerator -> p)

Methods

fromLabel :: Proxy# Symbol t -> SocketAddressEnumerator -> p

((~) * info (ResolveSocketAddressEnumeratorMethod t SocketAddressEnumerator), MethodInfo * info SocketAddressEnumerator p) => IsLabelProxy t (SocketAddressEnumerator -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> SocketAddressEnumerator -> p

HasAttributeList * SocketAddressEnumerator

type AttributeList SocketAddressEnumerator

type AttributeList SocketAddressEnumerator

type SignalList SocketAddressEnumerator

type SignalList SocketAddressEnumerator

class GObject o => IsSocketAddressEnumerator o

Instances

(GObject a, UnknownAncestorError Constraint SocketAddressEnumerator a) => IsSocketAddressEnumerator a

IsSocketAddressEnumerator SocketAddressEnumerator

IsSocketAddressEnumerator ProxyAddressEnumerator

toSocketAddressEnumerator :: IsSocketAddressEnumerator o => o -> IO SocketAddressEnumerator

noSocketAddressEnumerator :: Maybe SocketAddressEnumerator

Methods

next

data SocketAddressEnumeratorNextMethodInfo

Instances

((~) * signature (Maybe b -> m SocketAddress), MonadIO m, IsSocketAddressEnumerator a, IsCancellable b) => MethodInfo * SocketAddressEnumeratorNextMethodInfo a signature

Methods

overloadedMethod :: MethodProxy SocketAddressEnumeratorNextMethodInfo a -> signature -> s

socketAddressEnumeratorNext

Arguments

:: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsCancellable b)

=> a

enumerator: a SocketAddressEnumerator

-> Maybe b

cancellable: optional Cancellable object, Nothing to ignore.

-> m SocketAddress

Returns: a SocketAddress (owned by the caller), or Nothing on error (in which case *error will be set) or if there are no more addresses. (Can throw GError)

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 socketAddressEnumeratorNextAsync 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 socketAddressEnumeratorNext will return an appropriate error in *error. However, if the first call to socketAddressEnumeratorNext succeeds, then any further internal errors (other than cancellable being triggered) will be ignored.

nextAsync

data SocketAddressEnumeratorNextAsyncMethodInfo

Instances

((~) * signature (Maybe b -> Maybe AsyncReadyCallback -> m ()), MonadIO m, IsSocketAddressEnumerator a, IsCancellable b) => MethodInfo * SocketAddressEnumeratorNextAsyncMethodInfo a signature

Methods

overloadedMethod :: MethodProxy SocketAddressEnumeratorNextAsyncMethodInfo a -> signature -> s

socketAddressEnumeratorNextAsync

Arguments

:: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsCancellable b)

=> a

enumerator: a SocketAddressEnumerator

-> Maybe b

cancellable: optional Cancellable object, Nothing to ignore.

-> Maybe AsyncReadyCallback

callback: a AsyncReadyCallback to call when the request is satisfied

-> m ()

Asynchronously retrieves the next SocketAddress from enumerator and then calls callback, which must call socketAddressEnumeratorNextFinish to get the result.

nextFinish

data SocketAddressEnumeratorNextFinishMethodInfo

Instances

((~) * signature (b -> m SocketAddress), MonadIO m, IsSocketAddressEnumerator a, IsAsyncResult b) => MethodInfo * SocketAddressEnumeratorNextFinishMethodInfo a signature

Methods

overloadedMethod :: MethodProxy SocketAddressEnumeratorNextFinishMethodInfo a -> signature -> s

socketAddressEnumeratorNextFinish

Arguments

:: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsAsyncResult b)

=> a

enumerator: a SocketAddressEnumerator

-> b

result: a AsyncResult

-> m SocketAddress

Returns: a SocketAddress (owned by the caller), or Nothing on error (in which case *error will be set) or if there are no more addresses. (Can throw GError)

Retrieves the result of a completed call to socketAddressEnumeratorNextAsync. See socketAddressEnumeratorNext for more information about error handling.