Skip to main content

KeyStream

Struct KeyStream 

Source
pub struct KeyStream<K: Key, V: Value> { /* private fields */ }
Expand description

The main entry point for key-based async message streaming.

Use KeyStream::new to create, then call KeyStream::sender to get a sender handle.

§Example

use key_stream::KeyStream;
use tokio;
let key_stream = KeyStream::<i32, String>::new(10);
let sender = key_stream.sender();
let mut receiver = sender.subscribe(1).await;
sender.send(&1, "value".to_string()).await.unwrap();
assert_eq!(receiver.recv().await.unwrap(), "value".to_string());

Implementations§

Source§

impl<K: Key, V: Value> KeyStream<K, V>

Source

pub fn new(broadcast_capacity: usize) -> Self

Create a new KeyStream with the given broadcast channel capacity per key.

Source

pub fn sender(&self) -> KeySender<K, V>

Get a sender handle for publishing and subscribing to keys.

Source

pub async fn n_keys(&self) -> usize

Get the number of keys currently tracked.

Source

pub async fn key_capacity(&self) -> usize

Get the current capacity of the keys map.

Trait Implementations§

Source§

impl<K: Key, V: Value> Drop for KeyStream<K, V>

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more

Auto Trait Implementations§

§

impl<K, V> !RefUnwindSafe for KeyStream<K, V>

§

impl<K, V> !UnwindSafe for KeyStream<K, V>

§

impl<K, V> Freeze for KeyStream<K, V>

§

impl<K, V> Send for KeyStream<K, V>

§

impl<K, V> Sync for KeyStream<K, V>

§

impl<K, V> Unpin for KeyStream<K, V>

§

impl<K, V> UnsafeUnpin for KeyStream<K, V>

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> 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, 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.