futures_util/stream/
skip.rs

1use futures_core::{Poll, Async, Stream};
2use futures_core::task;
3use futures_sink::{ Sink};
4
5/// A stream combinator which skips a number of elements before continuing.
6///
7/// This structure is produced by the `Stream::skip` method.
8#[derive(Debug)]
9#[must_use = "streams do nothing unless polled"]
10pub struct Skip<S> {
11    stream: S,
12    remaining: u64,
13}
14
15pub fn new<S>(s: S, amt: u64) -> Skip<S>
16    where S: Stream,
17{
18    Skip {
19        stream: s,
20        remaining: amt,
21    }
22}
23
24impl<S> Skip<S> {
25    /// Acquires a reference to the underlying stream that this combinator is
26    /// pulling from.
27    pub fn get_ref(&self) -> &S {
28        &self.stream
29    }
30
31    /// Acquires a mutable reference to the underlying stream that this
32    /// combinator is pulling from.
33    ///
34    /// Note that care must be taken to avoid tampering with the state of the
35    /// stream which may otherwise confuse this combinator.
36    pub fn get_mut(&mut self) -> &mut S {
37        &mut self.stream
38    }
39
40    /// Consumes this combinator, returning the underlying stream.
41    ///
42    /// Note that this may discard intermediate state of this combinator, so
43    /// care should be taken to avoid losing resources when this is called.
44    pub fn into_inner(self) -> S {
45        self.stream
46    }
47}
48
49// Forwarding impl of Sink from the underlying stream
50impl<S> Sink for Skip<S>
51    where S: Sink
52{
53    type SinkItem = S::SinkItem;
54    type SinkError = S::SinkError;
55
56    delegate_sink!(stream);
57}
58
59impl<S> Stream for Skip<S>
60    where S: Stream,
61{
62    type Item = S::Item;
63    type Error = S::Error;
64
65    fn poll_next(&mut self, cx: &mut task::Context) -> Poll<Option<S::Item>, S::Error> {
66        while self.remaining > 0 {
67            match try_ready!(self.stream.poll_next(cx)) {
68                Some(_) => self.remaining -= 1,
69                None => return Ok(Async::Ready(None)),
70            }
71        }
72
73        self.stream.poll_next(cx)
74    }
75}
futures_util/stream/skip.rs

futures_util/stream/
skip.rs
