pub struct Thread { /* fields omitted */ }
A handle to a thread.
Threads are represented via the Thread
type, which you can get in one of two ways:
thread::spawn
function, and calling thread
on the JoinHandle
.thread::current
function.The thread::current
function is available even for threads not spawned by the APIs of this module.
There is usually no need to create a Thread
struct yourself, one should instead use a function like spawn
to create new threads, see the docs of Builder
and spawn
for more details.
impl Thread
[src]
pub fn unpark(&self)
[src]
Atomically makes the handle's token available if it is not already.
Every thread is equipped with some basic low-level blocking support, via the park
function and the unpark()
method. These can be used as a more CPU-efficient implementation of a spinlock.
See the park documentation for more details.
use std::thread; use std::time::Duration; let parked_thread = thread::Builder::new() .spawn(|| { println!("Parking thread"); thread::park(); println!("Thread unparked"); }) .unwrap(); // Let some time pass for the thread to be spawned. thread::sleep(Duration::from_millis(10)); println!("Unpark the thread"); parked_thread.thread().unpark(); parked_thread.join().unwrap();
pub fn id(&self) -> ThreadId
[src]1.19.0
Gets the thread's unique identifier.
use std::thread; let other_thread = thread::spawn(|| { thread::current().id() }); let other_thread_id = other_thread.join().unwrap(); assert!(thread::current().id() != other_thread_id);
pub fn name(&self) -> Option<&str>
[src]
Gets the thread's name.
For more information about named threads, see this module-level documentation.
Threads by default have no name specified:
use std::thread; let builder = thread::Builder::new(); let handler = builder.spawn(|| { assert!(thread::current().name().is_none()); }).unwrap(); handler.join().unwrap();
Thread with a specified name:
use std::thread; let builder = thread::Builder::new() .name("foo".into()); let handler = builder.spawn(|| { assert_eq!(thread::current().name(), Some("foo")) }).unwrap(); handler.join().unwrap();
impl !RefUnwindSafe for Thread
impl Send for Thread
impl Sync for Thread
impl Unpin for Thread
impl !UnwindSafe for Thread
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
fn borrow(&self) -> &TⓘNotable traits for &'_ mut F
impl<'_, F> Future for &'_ mut F where
F: Unpin + Future + ?Sized,
type Output = <F as Future>::Output;
impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized,
type Item = <I as Iterator>::Item;
impl<R: Read + ?Sized, '_> Read for &'_ mut R
impl<W: Write + ?Sized, '_> Write for &'_ mut W
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
fn borrow_mut(&mut self) -> &mut TⓘNotable traits for &'_ mut F
impl<'_, F> Future for &'_ mut F where
F: Unpin + Future + ?Sized,
type Output = <F as Future>::Output;
impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized,
type Item = <I as Iterator>::Item;
impl<R: Read + ?Sized, '_> Read for &'_ mut R
impl<W: Write + ?Sized, '_> Write for &'_ mut W
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/thread/struct.Thread.html