AtomicSubscription

Struct AtomicSubscription 

Source
pub struct AtomicSubscription<T> { /* private fields */ }
Expand description

A Sync subscription that can be shared between threads, where each message will be delivered exactly once.

§Clone

Cloning an AtomicSubscription will create a new subscription at an identical position to the original. In other words, if there are 10 pending events to consume and the subscription is cloned, the cloned subscription will also have 10 pending events.

Note: This behavior means that cloning an AtomicSubscription results in different behavior than cloning an Arc<AtomicSubscription>. The former will create a new subscription at the same point in the data stream, while the latter will poll from the same subscription to share the load.

§Performance

The performance will be slightly worse than MutSubscription, but allows for multiple workers to share the load from multiple threads by taking messages from a shared subscription as they are available.

Implementations§

Source§

impl<T> AtomicSubscription<T>

Source

pub fn poll(&self) -> Option<Arc<T>>

Poll the next message for this subscription, returning immediately with None if no new messages were available.

Trait Implementations§

Source§

impl<T> Clone for AtomicSubscription<T>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Auto Trait Implementations§

§

impl<T> Freeze for AtomicSubscription<T>

§

impl<T> RefUnwindSafe for AtomicSubscription<T>
where T: RefUnwindSafe,

§

impl<T> Send for AtomicSubscription<T>
where T: Sync + Send,

§

impl<T> Sync for AtomicSubscription<T>
where T: Sync + Send,

§

impl<T> Unpin for AtomicSubscription<T>

§

impl<T> UnwindSafe for AtomicSubscription<T>
where T: RefUnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.