1.0.0[−][src]Struct std::sync::mpsc::Sender
The sending-half of Rust's asynchronous channel
type. This half can only be
owned by one thread, but it can be cloned to send to other threads.
Messages can be sent through this channel with send
.
Examples
use std::sync::mpsc::channel; use std::thread; let (sender, receiver) = channel(); let sender2 = sender.clone(); // First thread owns sender thread::spawn(move || { sender.send(1).unwrap(); }); // Second thread owns sender2 thread::spawn(move || { sender2.send(2).unwrap(); }); let msg = receiver.recv().unwrap(); let msg2 = receiver.recv().unwrap(); assert_eq!(3, msg + msg2);Run
Methods
impl<T> Sender<T>
[src]
impl<T> Sender<T>
pub fn send(&self, t: T) -> Result<(), SendError<T>>
[src]
pub fn send(&self, t: T) -> Result<(), SendError<T>>
Attempts to send a value on this channel, returning it back if it could not be sent.
A successful send occurs when it is determined that the other end of
the channel has not hung up already. An unsuccessful send would be one
where the corresponding receiver has already been deallocated. Note
that a return value of Err
means that the data will never be
received, but a return value of Ok
does not mean that the data
will be received. It is possible for the corresponding receiver to
hang up immediately after this function returns Ok
.
This method will never block the current thread.
Examples
use std::sync::mpsc::channel; let (tx, rx) = channel(); // This send is always successful tx.send(1).unwrap(); // This send will fail because the receiver is gone drop(rx); assert_eq!(tx.send(1).unwrap_err().0, 1);Run
Trait Implementations
impl<T> Clone for Sender<T>
[src]
impl<T> Clone for Sender<T>
fn clone(&self) -> Sender<T>
[src]
fn clone(&self) -> Sender<T>
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
[src]
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
impl<T> Debug for Sender<T>
1.8.0[src]
impl<T> Debug for Sender<T>
fn fmt(&self, f: &mut Formatter) -> Result
[src]
fn fmt(&self, f: &mut Formatter) -> Result
Formats the value using the given formatter. Read more
impl<T: Send> Send for Sender<T>
[src]
impl<T: Send> Send for Sender<T>
impl<T> !Sync for Sender<T>
[src]
impl<T> !Sync for Sender<T>
impl<T> Drop for Sender<T>
[src]
impl<T> Drop for Sender<T>
Blanket Implementations
impl<T> From for T
[src]
impl<T> From for T
impl<T, U> TryFrom for T where
T: From<U>,
[src]
impl<T, U> TryFrom for T where
T: From<U>,
type Error = !
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
Performs the conversion.
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
impl<T> Borrow for T where
T: ?Sized,
[src]
impl<T> Borrow for T where
T: ?Sized,
ⓘImportant traits for &'_ mut Ifn borrow(&self) -> &T
[src]
fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
impl<T> BorrowMut for T where
T: ?Sized,
[src]
impl<T> BorrowMut for T where
T: ?Sized,
ⓘImportant traits for &'_ mut Ifn borrow_mut(&mut self) -> &mut T
[src]
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Any for T where
T: 'static + ?Sized,
fn get_type_id(&self) -> TypeId
[src]
fn get_type_id(&self) -> TypeId
🔬 This is a nightly-only experimental API. (get_type_id
#27745)
this method will likely be replaced by an associated static
Gets the TypeId
of self
. Read more
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
type Owned = T
fn to_owned(&self) -> T
[src]
fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
fn clone_into(&self, target: &mut T)
[src]
fn clone_into(&self, target: &mut T)
🔬 This is a nightly-only experimental API. (toowned_clone_into
#41263)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more