Struct event_listener::EventListener
source · [−]pub struct EventListener { /* private fields */ }
Expand description
A guard waiting for a notification from an Event
.
There are two ways for a listener to wait for a notification:
- In an asynchronous manner using
.await
. - In a blocking manner by calling
EventListener::wait()
on it.
If a notified listener is dropped without receiving a notification, dropping will notify another active listener. Whether one additional listener will be notified depends on what kind of notification was delivered.
Implementations
sourceimpl EventListener
impl EventListener
sourcepub fn wait(self)
pub fn wait(self)
Blocks until a notification is received.
Examples
use event_listener::Event;
let event = Event::new();
let listener = event.listen();
// Notify `listener`.
event.notify(1);
// Receive the notification.
listener.wait();
sourcepub fn wait_timeout(self, timeout: Duration) -> bool
pub fn wait_timeout(self, timeout: Duration) -> bool
Blocks until a notification is received or a timeout is reached.
Returns true
if a notification was received.
Examples
use std::time::Duration;
use event_listener::Event;
let event = Event::new();
let listener = event.listen();
// There are no notification so this times out.
assert!(!listener.wait_timeout(Duration::from_secs(1)));
sourcepub fn wait_deadline(self, deadline: Instant) -> bool
pub fn wait_deadline(self, deadline: Instant) -> bool
Blocks until a notification is received or a deadline is reached.
Returns true
if a notification was received.
Examples
use std::time::{Duration, Instant};
use event_listener::Event;
let event = Event::new();
let listener = event.listen();
// There are no notification so this times out.
assert!(!listener.wait_deadline(Instant::now() + Duration::from_secs(1)));
sourcepub fn discard(self) -> bool
pub fn discard(self) -> bool
Drops this listener and discards its notification (if any) without notifying another active listener.
Returns true
if a notification was discarded.
Examples
use event_listener::Event;
let event = Event::new();
let listener1 = event.listen();
let listener2 = event.listen();
event.notify(1);
assert!(listener1.discard());
assert!(!listener2.discard());
sourcepub fn listens_to(&self, event: &Event) -> bool
pub fn listens_to(&self, event: &Event) -> bool
Returns true
if this listener listens to the given Event
.
Examples
use event_listener::Event;
let event = Event::new();
let listener = event.listen();
assert!(listener.listens_to(&event));
sourcepub fn same_event(&self, other: &EventListener) -> bool
pub fn same_event(&self, other: &EventListener) -> bool
Returns true
if both listeners listen to the same Event
.
Examples
use event_listener::Event;
let event = Event::new();
let listener1 = event.listen();
let listener2 = event.listen();
assert!(listener1.same_event(&listener2));
Trait Implementations
sourceimpl Debug for EventListener
impl Debug for EventListener
sourceimpl Drop for EventListener
impl Drop for EventListener
sourceimpl Future for EventListener
impl Future for EventListener
impl RefUnwindSafe for EventListener
impl Send for EventListener
impl Sync for EventListener
impl UnwindSafe for EventListener
Auto Trait Implementations
impl Unpin for EventListener
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<F> IntoFuture for F where
F: Future,
impl<F> IntoFuture for F where
F: Future,
type Output = <F as Future>::Output
type Output = <F as Future>::Output
into_future
)The output that the future will produce on completion.
type IntoFuture = F
type IntoFuture = F
into_future
)Which kind of future are we turning this into?
sourcefn into_future(self) -> <F as IntoFuture>::IntoFuture
fn into_future(self) -> <F as IntoFuture>::IntoFuture
into_future
)Creates a future from a value.