o3 0.14.0

shared-nothing primitives
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

use std::mem;

/// Receives a resource when its owning [`Permit`] is dropped.
pub trait Return {
    type Item;

    fn return_item(&self, item: Self::Item);
}

/// Returns its item to the sink when dropped.
#[must_use]
pub struct Permit<R: Return> {
    item: mem::ManuallyDrop<R::Item>,
    sink: R,
}

impl<R: Return> Permit<R> {
    pub fn new(sink: R, item: R::Item) -> Self {
        Self {
            item: mem::ManuallyDrop::new(item),
            sink,
        }
    }
}

impl<R: Return> Drop for Permit<R> {
    fn drop(&mut self) {
        // SAFETY: new initializes item, this is its only extraction site, and
        // Drop runs at most once for a value.
        let item = unsafe { mem::ManuallyDrop::take(&mut self.item) };
        self.sink.return_item(item);
    }
}