# Struct std::thread::Builder [−] [src]

    pub struct Builder {
        // some fields omitted
    }

Thread configuration. Provides detailed control over the properties and behavior of new threads.

## Methods

### `impl Builder`

#### `fn new() -> Builder`

Generates the base configuration for spawning a thread, from which configuration methods can be chained.

#### `fn name(self, name: String) -> Builder`

Names the thread-to-be. Currently the name is used for identification only in panic messages.

#### `fn stack_size(self, size: usize) -> Builder`

Sets the size of the stack for the new thread.

#### `fn spawn<F, T>(self, f: F) -> Result<JoinHandle<T>> where F: FnOnce() -> T, F: Send + 'static, T: Send + 'static`

Spawns a new thread, and returns a join handle for it.

The child thread may outlive the parent (unless the parent thread is the main thread; the whole process is terminated when the main thread finishes). The join handle can be used to block on termination of the child thread, including recovering its panics.

# Errors

Unlike the `spawn` free function, this method yields an `io::Result` to capture any failure to create the thread at the OS level.

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result

## 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`)