     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
    51
    52
    53

    use core::marker;

    use stream::Stream;

    use {Async, Poll};

    /// Stream that produces the same element repeatedly.
    ///
    /// This structure is created by the `stream::repeat` function.
    #[derive(Debug)]
    #[must_use = "streams do nothing unless polled"]
    pub struct Repeat<T, E>
        where T: Clone
    {
        item: T,
        error: marker::PhantomData<E>,
    }

    /// Create a stream which produces the same item repeatedly.
    ///
    /// Stream never produces an error or EOF. Note that you likely want to avoid
    /// usage of `collect` or such on the returned stream as it will exhaust
    /// available memory as it tries to just fill up all RAM.
    ///
    /// ```rust
    /// use futures::*;
    ///
    /// let mut stream = stream::repeat::<_, bool>(10);
    /// assert_eq!(Ok(Async::Ready(Some(10))), stream.poll());
    /// assert_eq!(Ok(Async::Ready(Some(10))), stream.poll());
    /// assert_eq!(Ok(Async::Ready(Some(10))), stream.poll());
    /// ```
    pub fn repeat<T, E>(item: T) -> Repeat<T, E>
        where T: Clone
    {
        Repeat {
            item: item,
            error: marker::PhantomData,
        }
    }

    impl<T, E> Stream for Repeat<T, E>
        where T: Clone
    {
        type Item = T;
        type Error = E;

        fn poll(&mut self) -> Poll<Option<Self::Item>, Self::Error> {
            Ok(Async::Ready(Some(self.item.clone())))
        }
    }

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)