# Struct std::thread::ThreadId

1.19.0 · source ·

    pub struct ThreadId(/* private fields */);

Expand description

A unique identifier for a running thread.

A `ThreadId` is an opaque object that uniquely identifies each thread created during the lifetime of a process. `ThreadId`s are guaranteed not to be reused, even when a thread terminates. `ThreadId`s are under the control of Rust’s standard library and there may not be any relationship between `ThreadId` and the underlying platform’s notion of a thread identifier – the two concepts cannot, therefore, be used interchangeably. A `ThreadId` can be retrieved from the `id` method on a `Thread`.

## Examples

    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);

Run

## Implementations§

source§

### impl ThreadId

source

#### pub fn as_u64(&self) -> NonZeroU64

🔬This is a nightly-only experimental API. (`thread_id_value` #67939)

This returns a numeric identifier for the thread identified by this `ThreadId`.

As noted in the documentation for the type itself, it is essentially an opaque ID, but is guaranteed to be unique for each thread. The returned value is entirely opaque – only equality testing is stable. Note that it is not guaranteed which values new threads will return, and this may change across Rust versions.

## Trait Implementations§

source§

### impl Clone for ThreadId

source§

#### fn clone(&self) -> ThreadId

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from `source`. Read more
source§

### impl Debug for ThreadId

source§

#### fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

### impl Hash for ThreadId

source§

#### fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given `Hasher`. Read more
1.3.0 · source§

#### fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given `Hasher`. Read more
source§

### impl PartialEq for ThreadId

source§

#### fn eq(&self, other: &ThreadId) -> bool

This method tests for `self` and `other` values to be equal, and is used by `==`.
1.0.0 · source§

#### fn ne(&self, other: &Rhs) -> bool

This method tests for `!=`. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

### impl Copy for ThreadId

source§

### impl Eq for ThreadId

source§

### impl StructuralEq for ThreadId

source§

### impl StructuralPartialEq for ThreadId

## Auto Trait Implementations§

§

### impl RefUnwindSafe for ThreadId

§

### impl Send for ThreadId

§

### impl Sync for ThreadId

§

### impl Unpin for ThreadId

§

### impl UnwindSafe for ThreadId

## Blanket Implementations§

source§

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

source§

#### fn type_id(&self) -> TypeId

Gets the `TypeId` of `self`. Read more
source§

### impl<T> Borrow<T> for Twhere T: ?Sized,

source§

#### fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

### impl<T> BorrowMut<T> for Twhere 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 Twhere 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 Twhere T: Clone,

§

#### 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 Twhere U: Into<T>,

§

#### 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 Twhere U: TryFrom<T>,

§

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