Thread.h

Go to the documentation of this file.

/* ES40 emulator.
 * Copyright (C) 2007-2008 by the ES40 Emulator Project
 *
 * WWW    : http://sourceforge.net/projects/es40
 * E-mail : camiel@camicom.com
 * 
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 * 
 * This program 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 General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 * 
 * Although this is not required, the author would appreciate being notified of, 
 * and receiving any modifications you may make to the source code that might serve
 * the general public.
 */

//
// Thread.h
//
// $Id: Thread.h,v 1.1 2008/03/31 19:13:34 iamcamiel Exp $
//
// Library: Foundation
// Package: Threading
// Module:  Thread
//
// Definition of the Thread class.
//
// Copyright (c) 2004-2006, Applied Informatics Software Engineering GmbH.
// and Contributors.
//
// Permission is hereby granted, free of charge, to any person or organization
// obtaining a copy of the software and accompanying documentation covered by
// this license (the "Software") to use, reproduce, display, distribute,
// execute, and transmit the Software, and to prepare derivative works of the
// Software, and to permit third-parties to whom the Software is furnished to
// do so, all subject to the following:
// 
// The copyright notices in the Software and this entire statement, including
// the above license grant, this restriction and the following disclaimer,
// must be included in all copies of the Software, in whole or in part, and
// all derivative works of the Software, unless such copies or derivative
// works are solely in the form of machine-executable object code generated by
// a source language processor.
// 
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
// SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
// FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
//


#ifndef Foundation_Thread_INCLUDED
#define Foundation_Thread_INCLUDED


#include "VMS/Foundation.h"
#include "VMS/Mutex.h"

#include "VMS/Thread_POSIX.h"


namespace Poco {


class Runnable;
class ThreadLocalStorage;


class Foundation_API Thread: private ThreadImpl
{
public: 
        enum Priority
        {
                PRIO_LOWEST  = PRIO_LOWEST_IMPL, 
                PRIO_LOW     = PRIO_LOW_IMPL,    
                PRIO_NORMAL  = PRIO_NORMAL_IMPL, 
                PRIO_HIGH    = PRIO_HIGH_IMPL,   
                PRIO_HIGHEST = PRIO_HIGHEST_IMPL 
        };

        Thread();
                
        Thread(const std::string& name);
                
        ~Thread();

        int id() const;

        std::string name() const;

        std::string getName() const;

        void setName(const std::string& name);

        void setPriority(Priority prio);

        Priority getPriority() const;

        void start(Runnable& target);

        void join();
                
        void join(long milliseconds);
                
        bool tryJoin(long milliseconds);

        bool isRunning() const;

        static void sleep(long milliseconds);

        static void yield();

        static Thread* current();

protected:
        ThreadLocalStorage& tls();

        void clearTLS();

        std::string makeName();
                
        static int uniqueId();
                
private:
        Thread(const Thread&);
        Thread& operator = (const Thread&);

        int                 _id;
        std::string         _name;
        ThreadLocalStorage* _pTLS;
        mutable FastMutex   _mutex;

        friend class ThreadLocalStorage;
        friend class PooledThread;
};


//
// inlines
//
inline int Thread::id() const
{
        return _id;
}


inline std::string Thread::name() const
{
        FastMutex::ScopedLock lock(_mutex);
        
        return _name;
}


inline std::string Thread::getName() const
{
        FastMutex::ScopedLock lock(_mutex);
        
        return _name;
}


inline bool Thread::isRunning() const
{
        return isRunningImpl();
}


inline void Thread::sleep(long milliseconds)
{
        sleepImpl(milliseconds);
}


inline void Thread::yield()
{
        yieldImpl();
}


inline Thread* Thread::current()
{
        return static_cast<Thread*>(currentImpl());
}


} // namespace Poco


#endif // Foundation_Thread_INCLUDED

Project space on SourceForge.net