# Function std::thread::park 1.0.0[−][src]

    pub fn park()

Blocks unless or until the current thread's token is made available.

A call to `park` does not guarantee that the thread will remain parked forever, and callers should be prepared for this possibility.

# park and unpark

Every thread is equipped with some basic low-level blocking support, via the `thread::park` function and `thread::Thread::unpark` method. `park` blocks the current thread, which can then be resumed from another thread by calling the `unpark` method on the blocked thread's handle.

Conceptually, each `Thread` handle has an associated token, which is initially not present:

- The `thread::park` function blocks the current thread unless or until the token is available for its thread handle, at which point it atomically consumes the token. It may also return spuriously, without consuming the token. `thread::park_timeout` does the same, but allows specifying a maximum time to block the thread for.

- The `unpark` method on a `Thread` atomically makes the token available if it wasn't already.

In other words, each `Thread` acts a bit like a spinlock that can be locked and unlocked using `park` and `unpark`.

The API is typically used by acquiring a handle to the current thread, placing that handle in a shared data structure so that other threads can find it, and then `park`ing. When some desired condition is met, another thread calls `unpark` on the handle.

The motivation for this design is twofold:

- It avoids the need to allocate mutexes and condvars when building new synchronization primitives; the threads already provide basic blocking/signaling.

- It can be implemented very efficiently on many platforms.

# Examples

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

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g. `str,u8` or `String,struct:Vec,test`)