tokio 1.51.1

An event-driven, non-blocking I/O platform for writing asynchronous I/O backed applications.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

use super::{Entry, EntryHandle, WakeQueueEntry};
use crate::util::linked_list;

type EntryList = linked_list::LinkedList<WakeQueueEntry, Entry>;

/// A queue of entries that need to be woken up.
#[derive(Debug)]
pub(crate) struct WakeQueue {
    list: EntryList,
}

impl Drop for WakeQueue {
    fn drop(&mut self) {
        // drain all entries without waking them up
        while let Some(hdl) = self.list.pop_front() {
            drop(hdl);
        }
    }
}

impl WakeQueue {
    pub(crate) fn new() -> Self {
        Self {
            list: EntryList::new(),
        }
    }

    pub(crate) fn is_empty(&self) -> bool {
        self.list.is_empty()
    }

    /// # Safety
    ///
    /// Behavior is undefined if any of the following conditions are violated:
    ///
    /// - [`Entry::extra_pointers`] of `hdl` must not being used.
    pub(crate) unsafe fn push_front(&mut self, hdl: EntryHandle) {
        self.list.push_front(hdl);
    }

    /// Wakes all entries in the wake queue.
    pub(crate) fn wake_all(mut self) {
        while let Some(hdl) = self.list.pop_front() {
            hdl.wake();
        }
    }
}

#[cfg(test)]
mod tests;