Struct event_listener::EventListener

pub struct EventListener { /* fields omitted */ }

A guard waiting for a notification from an Event.

There are two ways for a listener to wait for a notification:

1. In an asynchronous manner using .await.
2. 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

impl EventListener

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();

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)));

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)));

Trait Implementations

impl Debug for EventListener

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Drop for EventListener

fn drop(&mut self)

Executes the destructor for this type.

impl Future for EventListener

type Output = ()

The type of value produced on completion.

fn poll(self: Pin<&mut Self>, cx: &mut Context) -> Poll<Self::Output>

Attempt to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.

impl Send for EventListener

impl Sync for EventListener