| Copyright | Will Thompson and Iñaki García Etxebarria |
|---|---|
| License | LGPL-2.1 |
| Maintainer | Iñaki García Etxebarria |
| Safe Haskell | None |
| Language | Haskell2010 |
GI.Gio.Objects.SocketAddressEnumerator
Description
GSocketAddressEnumerator is an enumerator type for
SocketAddress instances. It is returned by enumeration functions
such as socketConnectableEnumerate, which returns a
GSocketAddressEnumerator to list each SocketAddress which could
be used to connect to that SocketConnectable.
Enumeration is typically a blocking operation, so the asynchronous methods
socketAddressEnumeratorNextAsync and
socketAddressEnumeratorNextFinish should be used where
possible.
Each GSocketAddressEnumerator can only be enumerated once. Once
socketAddressEnumeratorNext has returned NULL, further
enumeration with that GSocketAddressEnumerator is not possible, and it can
be unreffed.
Synopsis
- newtype SocketAddressEnumerator = SocketAddressEnumerator (ManagedPtr SocketAddressEnumerator)
- class (GObject o, IsDescendantOf SocketAddressEnumerator o) => IsSocketAddressEnumerator o
- toSocketAddressEnumerator :: (MonadIO m, IsSocketAddressEnumerator o) => o -> m SocketAddressEnumerator
- type family ResolveSocketAddressEnumeratorMethod (t :: Symbol) o where ...
- data SocketAddressEnumeratorNextMethodInfo
- socketAddressEnumeratorNext :: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsCancellable b) => a -> Maybe b -> m (Maybe SocketAddress)
- data SocketAddressEnumeratorNextAsyncMethodInfo
- socketAddressEnumeratorNextAsync :: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsCancellable b) => a -> Maybe b -> Maybe AsyncReadyCallback -> m ()
- data SocketAddressEnumeratorNextFinishMethodInfo
- socketAddressEnumeratorNextFinish :: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsAsyncResult b) => a -> b -> m (Maybe SocketAddress)
Exported types
newtype SocketAddressEnumerator Source #
Memory-managed wrapper type.
Constructors
| SocketAddressEnumerator (ManagedPtr SocketAddressEnumerator) |
Instances
class (GObject o, IsDescendantOf SocketAddressEnumerator o) => IsSocketAddressEnumerator o Source #
Type class for types which can be safely cast to SocketAddressEnumerator, for instance with toSocketAddressEnumerator.
Instances
| (GObject o, IsDescendantOf SocketAddressEnumerator o) => IsSocketAddressEnumerator o Source # | |
Defined in GI.Gio.Objects.SocketAddressEnumerator | |
toSocketAddressEnumerator :: (MonadIO m, IsSocketAddressEnumerator o) => o -> m SocketAddressEnumerator Source #
Cast to SocketAddressEnumerator, for types for which this is known to be safe. For general casts, use castTo.
Methods
Click to display all available methods, including inherited ones
Methods
bindProperty, bindPropertyFull, forceFloating, freezeNotify, getv, isFloating, next, nextAsync, nextFinish, notify, notifyByPspec, ref, refSink, runDispose, stealData, stealQdata, thawNotify, unref, watchClosure.
Getters
getData, getProperty, getQdata.
Setters
type family ResolveSocketAddressEnumeratorMethod (t :: Symbol) o where ... Source #
Equations
next
data SocketAddressEnumeratorNextMethodInfo Source #
Instances
| (signature ~ (Maybe b -> m (Maybe SocketAddress)), MonadIO m, IsSocketAddressEnumerator a, IsCancellable b) => OverloadedMethod SocketAddressEnumeratorNextMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.SocketAddressEnumerator Methods overloadedMethod :: a -> signature # | |
| OverloadedMethodInfo SocketAddressEnumeratorNextMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.SocketAddressEnumerator Methods | |
socketAddressEnumeratorNext Source #
Arguments
| :: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsCancellable b) | |
| => a |
|
| -> Maybe b |
|
| -> m (Maybe SocketAddress) | Returns: a |
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 Source #
Instances
| (signature ~ (Maybe b -> Maybe AsyncReadyCallback -> m ()), MonadIO m, IsSocketAddressEnumerator a, IsCancellable b) => OverloadedMethod SocketAddressEnumeratorNextAsyncMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.SocketAddressEnumerator Methods overloadedMethod :: a -> signature # | |
| OverloadedMethodInfo SocketAddressEnumeratorNextAsyncMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.SocketAddressEnumerator Methods | |
socketAddressEnumeratorNextAsync Source #
Arguments
| :: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsCancellable b) | |
| => a |
|
| -> Maybe b |
|
| -> Maybe AsyncReadyCallback |
|
| -> m () |
Asynchronously retrieves the next SocketAddress from enumerator
and then calls callback, which must call
socketAddressEnumeratorNextFinish to get the result.
It is an error to call this multiple times before the previous callback has finished.
nextFinish
data SocketAddressEnumeratorNextFinishMethodInfo Source #
Instances
| (signature ~ (b -> m (Maybe SocketAddress)), MonadIO m, IsSocketAddressEnumerator a, IsAsyncResult b) => OverloadedMethod SocketAddressEnumeratorNextFinishMethodInfo a signature Source # | |
Defined in GI.Gio.Objects.SocketAddressEnumerator Methods overloadedMethod :: a -> signature # | |
| OverloadedMethodInfo SocketAddressEnumeratorNextFinishMethodInfo (a :: Type) Source # | |
Defined in GI.Gio.Objects.SocketAddressEnumerator Methods | |
socketAddressEnumeratorNextFinish Source #
Arguments
| :: (HasCallStack, MonadIO m, IsSocketAddressEnumerator a, IsAsyncResult b) | |
| => a |
|
| -> b |
|
| -> m (Maybe SocketAddress) | Returns: a |
Retrieves the result of a completed call to
socketAddressEnumeratorNextAsync. See
socketAddressEnumeratorNext for more information about
error handling.