pthread_.h

Go to the documentation of this file.

/*
 *   P::Classes - Portable C++ Application Framework
 *   Copyright (C) 2000-2003  Christian Prochnow <cproch@seculogix.de>
 *
 *   This library is free software; you can redistribute it and/or
 *   modify it under the terms of the GNU Lesser General Public
 *   License as published by the Free Software Foundation; either
 *   version 2 of the License, or (at your option) any later version.
 *
 *   This library is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *   Lesser General Public License for more details.
 *
 *   You should have received a copy of the GNU Lesser General Public
 *   License along with this library; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

#ifndef _pthread_h_
#define _pthread_h_

#include <pclasses/pexport.h>
#include <pclasses/pexception.h>
#include <pclasses/psemaphore.h>

namespace P {


class ThreadError: public SystemError {
  public:
    inline ThreadError(oserr_t errnum, const char* _what, const SourceInfo& _si) throw()
      : SystemError(errnum, _what, _si) {}

    inline BaseError* clone() const
    { return new ThreadError(*this); }

};


class PCORE_EXPORT Thread {
  public:
    enum state_t {
      Stopped,    
      Running,    
      Suspended   
    };

    Thread() throw();
    virtual ~Thread();

    void start(Semaphore* sem = 0, int prio = 0) throw(LogicError, ThreadError);

    bool stop(unsigned int timeout) throw(LogicError, SyncError);

    void kill() throw(LogicError, SystemError);

    bool suspend(unsigned int timeout) throw(LogicError, SyncError);

    void resume() throw(LogicError, SyncError);

    state_t state() const throw();

    static void yield() throw();


    static void sleep(unsigned int timeout) throw();

    static void exit() throw();

    static Thread* current() throw();

  protected:
    virtual bool initial() = 0;
    virtual void main() = 0;
    virtual void suspended() {};
    virtual void resumed() {};
    virtual void final() {};

    bool testCancel() throw(LogicError, SyncError);

    class Private;
    friend class Private;

    struct thread_handle_t;
    friend struct thread_handle_t;

    thread_handle_t* handle() const throw();

    static thread_handle_t* createHandle();
    static void destroyHandle(thread_handle_t* handle);

  private:
    thread_handle_t* m_handle;
};

}

#endif

---