std::thread::join - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::thread::join

From cppreference.com
< cpp‎ | thread‎ | thread

void join(); |  | (since C++11)

Blocks the current thread until the thread identified by *this finishes its execution.

The completion of the thread identified by *this synchronizes with the corresponding successful return from join().

### [edit] Parameters

(none)

### [edit] Return value

(none)

### [edit] Postconditions

joinable is false

### [edit] Exceptions

std::system_error if an error occurs.

### [edit] Error Conditions

- resource_deadlock_would_occur if this->get_id() == std::this_thread::get_id() (deadlock detected)
- no_such_process if the thread is not valid
- invalid_argument if joinable is false

### [edit] Example

Run this code

    #include <iostream>
    #include <thread>
    #include <chrono>

    void foo()
    {
        // simulate expensive operation
        std::this_thread::sleep_for(std::chrono::seconds(1));
    }

    void bar()
    {
        // simulate expensive operation
        std::this_thread::sleep_for(std::chrono::seconds(1));
    }

    int main()
    {
        std::cout << "starting first helper...\n";
        std::thread helper1(foo);

        std::cout << "starting second helper...\n";
        std::thread helper2(bar);

        std::cout << "waiting for helpers to finish..." << std::endl;
        helper1.join();
        helper2.join();

        std::cout << "done!\n";
    }

Output:

    starting first helper...
    starting second helper...
    waiting for helpers to finish...
    done!

### [edit] References

- C++11 standard (ISO/IEC 14882:2011):

  - 30.3.1.5 thread members [thread.thread.member]

### [edit] See also

detach | permits the thread to execute independently from the thread handle (public member function) [edit]
joinable | checks whether the thread is joinable, i.e. potentially running in parallel context (public member function) [edit]
C documentation for thrd_join

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/thread/thread/join&oldid=90287"