Coverage Report

Created: 2026-06-01 06:40

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/rust/registry/src/index.crates.io-1949cf8c6b5b557f/futures-util-0.3.32/src/sink/flush.rs
Line
Count
Source
1
use core::marker::PhantomData;
2
use core::pin::Pin;
3
use futures_core::future::Future;
4
use futures_core::task::{Context, Poll};
5
use futures_sink::Sink;
6
7
/// Future for the [`flush`](super::SinkExt::flush) method.
8
#[derive(Debug)]
9
#[must_use = "futures do nothing unless you `.await` or poll them"]
10
pub struct Flush<'a, Si: ?Sized, Item> {
11
    sink: &'a mut Si,
12
    _phantom: PhantomData<fn(Item)>,
13
}
14
15
// Pin is never projected to a field.
16
impl<Si: Unpin + ?Sized, Item> Unpin for Flush<'_, Si, Item> {}
17
18
/// A future that completes when the sink has finished processing all
19
/// pending requests.
20
///
21
/// The sink itself is returned after flushing is complete; this adapter is
22
/// intended to be used when you want to stop sending to the sink until
23
/// all current requests are processed.
24
impl<'a, Si: Sink<Item> + Unpin + ?Sized, Item> Flush<'a, Si, Item> {
25
0
    pub(super) fn new(sink: &'a mut Si) -> Self {
26
0
        Self { sink, _phantom: PhantomData }
27
0
    }
28
}
29
30
impl<Si: Sink<Item> + Unpin + ?Sized, Item> Future for Flush<'_, Si, Item> {
31
    type Output = Result<(), Si::Error>;
32
33
0
    fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> {
34
0
        Pin::new(&mut self.sink).poll_flush(cx)
35
0
    }
36
}