pub struct Injector<T> { /* fields omitted */ }
An injector queue.
This is a FIFO queue that can be shared among multiple threads. Task schedulers typically have
a single injector queue, which is the entry point for new tasks.
use crossbeam_deque::{Injector, Steal};
let q = Injector::new();
q.push(1);
q.push(2);
assert_eq!(q.steal(), Steal::Success(1));
assert_eq!(q.steal(), Steal::Success(2));
assert_eq!(q.steal(), Steal::Empty);
Creates a new injector queue.
use crossbeam_deque::Injector;
let q = Injector::<i32>::new();
Pushes a task into the queue.
use crossbeam_deque::Injector;
let w = Injector::new();
w.push(1);
w.push(2);
Steals a task from the queue.
use crossbeam_deque::{Injector, Steal};
let q = Injector::new();
q.push(1);
q.push(2);
assert_eq!(q.steal(), Steal::Success(1));
assert_eq!(q.steal(), Steal::Success(2));
assert_eq!(q.steal(), Steal::Empty);
Steals a batch of tasks and pushes them into a worker.
How many tasks exactly will be stolen is not specified. That said, this method will try to
steal around half of the tasks in the queue, but also not more than some constant limit.
use crossbeam_deque::{Injector, Worker};
let q = Injector::new();
q.push(1);
q.push(2);
q.push(3);
q.push(4);
let w = Worker::new_fifo();
q.steal_batch(&w);
assert_eq!(w.pop(), Some(1));
assert_eq!(w.pop(), Some(2));
Steals a batch of tasks, pushes them into a worker, and pops a task from that worker.
How many tasks exactly will be stolen is not specified. That said, this method will try to
steal around half of the tasks in the queue, but also not more than some constant limit.
use crossbeam_deque::{Injector, Steal, Worker};
let q = Injector::new();
q.push(1);
q.push(2);
q.push(3);
q.push(4);
let w = Worker::new_fifo();
assert_eq!(q.steal_batch_and_pop(&w), Steal::Success(1));
assert_eq!(w.pop(), Some(2));
Returns true
if the queue is empty.
use crossbeam_deque::Injector;
let q = Injector::new();
assert!(q.is_empty());
q.push(1);
assert!(!q.is_empty());
Executes the destructor for this type. Read more
Formats the value using the given formatter. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static
Mutably borrows from an owned value. Read more
type Error = <U as TryFrom<T>>::Error
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)