# [−][src]Function rayon::iter::once

    pub fn once<T: Send>(item: T) -> Once<T>

Creates a parallel iterator that produces an element exactly once.

This admits no parallelism on its own, but it could be chained to existing parallel iterators to extend their contents, or otherwise used for any code that deals with generic parallel iterators.

# Examples

    use rayon::prelude::*;
    use rayon::iter::once;

    let pi = (0..1234).into_par_iter()
        .chain(once(-1))
        .chain(1234..10_000);

    assert_eq!(pi.clone().count(), 10_001);
    assert_eq!(pi.clone().filter(|&x| x < 0).count(), 1);
    assert_eq!(pi.position_any(|x| x < 0), Some(1234));

# 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`)

Search multiple things at once by splitting your query with comma (e.g., `str,u8` or `String,struct:Vec,test`)