EXT Win Library - thread

The win::thread template encapsulates a thread into object created over specified function.

---

Interface:

template <int (*P) (void *), unsigned int stack = 0>
class win::thread {
    public:
        explicit thread (void * = 0);

    private:
        thread (const thread &);
        thread & operator = (const thread &);

    public:
        bool running () const throw ();
        bool failed () const throw ();

        int  result () const throw ();
        void wait () const throw ();
};

• int (*P) (void *)
  P is a pointer to the first-class function that is to be executed in separate thread.
• unsigned int stack
  The stack parameter specifies the initial stack size for newly created thread. Default value of zero tells the operating system to allocate default amount of memory. See MSDN for details.
• win::thread::thread (void *)
  The constructor parameter is passed as a parameter to the function executed in newly-created thread. The default value is NULL.
• win::thread::running ()
  Returns true if the thread is still running or false if the thread already exited.
• win::thread::failed ()
  Returns true if the thread finished due to an uncaught exception. The value of result member function is set to -1.
• win::thread::result ()
  Returns the return value of the thread procedure. The result is undefined if the thread hasn't finished yet.
• win::thread::wait ()
  The wait member function suspends calling thread until the thread finishes. If the thread has already finished, the function returns immediately. This is called also internally in destructor of the win::thread. No return value.

Details:

The thread is considered an object. It is created when the object is constructed and finishes along with destruction of the object or sooner. The destructor waits until the thread procedure ends. The thread object cannot be copied.

You will need to include "ext/win_bits/thread.cpp" into your project in order to use win::thread.

Examples:

#include <ext/win>

int procedure (void *) {
    // ...
    return 0;
};

int main () {
    win::thread <procedure> thread;
    win::thread <procedure> thread (ptr);
    // ...
    return 0;
};

Remarks

Use win::threadc template to create threads on member functions.

---

[index]