Home

C-Bits Package Documentation

Main Page Namespace List Class Hierarchy Compound List File List Compound Members File Members

cbits::Thread_WIN32 Class Reference

Win32 implementation of the cbits::Thread class. More...

#include <Thread_WIN32.h>

Inheritance diagram for cbits::Thread_WIN32:

[legend]Collaboration diagram for cbits::Thread_WIN32:[legend]List of all members.

Public Types
enum	State { READY = 1, ALIVE = 2, DEAD = 3 }
	Thread states. More...
enum	Priority { PRIORITY_1 = 1, PRIORITY_2 = 2, PRIORITY_3 = 3, PRIORITY_4 = 4, PRIORITY_5 = 5, PRIORITY_6 = 6, PRIORITY_7 = 7, PRIORITY_8 = 8, PRIORITY_9 = 9, MIN_PRIORITY = PRIORITY_1, DEFAULT_PRIORITY = PRIORITY_5, MAX_PRIORITY = PRIORITY_9 }
	Thread scheduling priorities. More...
Public Methods
	Thread_WIN32 (Runnable *r, const Priority p=DEFAULT_PRIORITY)
virtual	~Thread_WIN32 ()
void	start ()
	Start the thread. More...
const long	getThreadID () const
	Get Thread's ID. More...
void	interrupt ()
	Send a event to the thread. More...
const bool	join (const long msec=0)
	Wait for this thread to terminate. More...
const State	getState (const bool lockit=true) const
	Get this thread's run state. More...
void	setData (void *) const
	Associate user data with this thread. More...
void *	getData () const
	Retrieve user data that has been associated with this thread (if any). More...
Static Public Methods
Thread *	get_current_thread ()
void	yield ()
	Give up the processor. More...
Thread *	create (Runnable *r, const Priority p=DEFAULT_PRIORITY)
	Factory method for creating thread objects. More...
Thread *	getCurrent ()
	Get reference to the current thread of execution. More...
const bool	isInterrupted ()
	Check the interrupt status of the current thread. More...
void	sleep (const long msec)
	Put current thread to sleep. More...
Protected Methods
virtual const bool	impl_create_thread (const Priority)
	Create a platform-specific thread. More...
virtual const bool	impl_start_thread ()
	Start the platform-specific thread. More...
virtual const long	impl_get_threadid () const
	Get thread's ID. More...
virtual void	impl_lock_obj () const
	Lock this thread object. More...
virtual void	impl_unlock_obj () const
	Unlock this thread object. More...
virtual void	impl_interrupt ()
	Send an 'interrupt' event to the platform-specific thread implementation. More...
virtual const bool	impl_join (const long msec)
	Wait for the platform thread to terminate. More...
virtual void	impl_sleep (const long msec)
	Put the current thread to sleep. More...
Runnable *	getTarget () const
	Get a reference to the user-supplied execution object. More...
const State	setState (State, const bool lockit=true)
	Set the state of the thread. More...
void	setError (const char *e) const
	Set the error string that describes the most recent error. More...
const std::string &	getError () const
	Get the an explanation of the last error that occurred (if any). More...
const Priority	getPriority () const
	Get the thread's scheduling priority. More...
Static Protected Methods
void *	run_thread (void *)
Private Methods
const long	getTid () const

Detailed Description

Win32 implementation of the cbits::Thread class.

Member Enumeration Documentation

enum cbits::Thread::Priority [inherited]

Thread scheduling priorities.

Enumeration values:

PRIORITY_1

PRIORITY_2

PRIORITY_3

PRIORITY_4

PRIORITY_5

PRIORITY_6

PRIORITY_7

PRIORITY_8

PRIORITY_9

MIN_PRIORITY

DEFAULT_PRIORITY

MAX_PRIORITY

enum cbits::Thread::State [inherited]

Thread states.

Enumeration values:

READY

ALIVE Thread is read to execute.

DEAD Thread is executing.

Constructor & Destructor Documentation

cbits::Thread_WIN32::Thread_WIN32 ( Runnable * r,

const Priority p = DEFAULT_PRIORITY

)

Thread_WIN32::~Thread_WIN32 ( ) [virtual]

Member Function Documentation

Thread * Thread::create ( Runnable * r,

const Priority p = DEFAULT_PRIORITY

) [static, inherited]

Factory method for creating thread objects.

Returns:
pointer to new thread object in the READY state.
Parameters:

p User supplied object to execute Thread priority

Thread * Thread_WIN32::get_current_thread ( ) [static]

Thread * Thread::getCurrent ( ) [static, inherited]

Get reference to the current thread of execution.

Returns:
pointer to current thread, or 0 if the current thread was not created as an instance of Thread.

void * Thread::getData ( ) const [inherited]

Retrieve user data that has been associated with this thread (if any).

Returns:
pointer to opaque user supplied data object.

const std::string& cbits::Thread::getError ( ) const [inline, protected, inherited]

Get the an explanation of the last error that occurred (if any).
This method is only available to the implementation-specific derived class.

Returns:
reference to a string that contains a message that describes the last error that occurred. If no errors have occurred, then the string may be empty.

const Priority cbits::Thread::getPriority ( ) const [inline, protected, inherited]

Get the thread's scheduling priority.
This method is only available to the implementation-specific derived class.

Returns:
a element of the Priority ennumeration.

const Thread::State Thread::getState ( const bool lockit = true ) const [inherited]

Get this thread's run state.

Runnable* cbits::Thread::getTarget ( ) const [inline, protected, inherited]

Get a reference to the user-supplied execution object.

Returns:
pointer to user-supplied Runnable instance.

const long Thread::getThreadID ( ) const [inherited]

Get Thread's ID.

Returns:
long integer representing thread's ID.

const long Thread_WIN32::getTid ( ) const [private]

virtual const bool cbits::Thread_WIN32::impl_create_thread ( const Priority ) [protected, virtual]

Create a platform-specific thread.
This method must be implemented by the platform-specific derived class.

Returns:
true if successful; otherwise false is returned and getError() must return a description of the error that occured.

Implements cbits::Thread.

const long Thread_WIN32::impl_get_threadid ( ) const [protected, virtual]

Get thread's ID.
This method is called internally to prevent access to the thread object while it is modifying its internal state.

Returns:
long

Implements cbits::Thread.

void Thread_WIN32::impl_interrupt ( ) [protected, virtual]

Send an 'interrupt' event to the platform-specific thread implementation.
This method must be implemented by the platform-specific derived class.
Implements cbits::Thread.

const bool Thread_WIN32::impl_join ( const long msec ) [protected, virtual]

Wait for the platform thread to terminate.
This method must be implemented by the platform-specific derived class.

Returns:
true if the platform thread has exited. If an error occurs during the 'join', false is returned and getError() must return a description of the error that occured.

Implements cbits::Thread.

void Thread_WIN32::impl_lock_obj ( ) const [protected, virtual]

Lock this thread object.
This method is called internally to prevent access to the thread object while it is modifying its internal state.
This method must be implemented by the platform-specific derived class.
Implements cbits::Thread.

void Thread_WIN32::impl_sleep ( const long msec ) [protected, virtual]

Put the current thread to sleep.
This method must be implemented by the platform-specific derived class.
Implements cbits::Thread.

const bool Thread_WIN32::impl_start_thread ( ) [protected, virtual]

Start the platform-specific thread.
This method must be implemented by the platform-specific derived class.

Returns:
true if successful; otherwise false is returned and getError() must return a description of the error that occured.

Implements cbits::Thread.

void Thread_WIN32::impl_unlock_obj ( ) const [protected, virtual]

Unlock this thread object.
This method is called internally to release the lock that may have been set to prevent access to the thread object while it is modifying its internal state.
This method must be implemented by the platform-specific derived class.
Implements cbits::Thread.

void Thread::interrupt ( ) [inherited]

Send a event to the thread.
It is intended that the Runnable code must be written in such a way that it is sensitive to the interrupt status of the thread. It may check the interrupt status by calling the 'isInterrupted' method.

const bool Thread::isInterrupted ( ) [static, inherited]

Check the interrupt status of the current thread.
The interrupt state is reset after every call to this method.

Returns:
'true' if another thread has previously called the 'interrupt' method on this thread instance. otherwise, false is returned.

const bool Thread::join ( const long msec = 0 ) [inherited]

Wait for this thread to terminate.
FIXME Thread.h 'msec' argument is ignored by 'join' method.
Parameters:

msec maximum number of milliseconds to wait for the thread to end. 'msec' <= 0 is interpreted as 'wait forever'.

void * Thread_WIN32::run_thread ( void * ) [static, protected]

void Thread::setData ( void * ) const [inherited]

Associate user data with this thread.

Parameters:

d pointer to opaque user-supplied data object

void cbits::Thread::setError ( const char * e ) const [inline, protected, inherited]

Set the error string that describes the most recent error.
This method is only available to the implementation-specific derived class.
Parameters:

e An explanation of the last error

const Thread::State Thread::setState ( State ,

const bool lockit = true

) [protected, inherited]

Set the state of the thread.
This method is only available to the implementation specific derived class.

Returns:
the old state.
Parameters:

lockit true if object should be locked before changing state.

void Thread::sleep ( const long msec ) [static, inherited]

Put current thread to sleep.

Parameters:

msec Number of milliseconds to sleep. The process may wake up before the full interval has elapsed.

void Thread::start ( ) [inherited]

Start the thread.
The Thread object's state changes from READY to ALIVE.
@raises ThreadException if :

the thread is in the DEAD state.
The platform thread cannot be started.

void Thread_WIN32::yield ( ) [static]

Give up the processor.
If no other threads are eligible to execute, the thread that yielded will be immediately rescheduled.
Reimplemented from cbits::Thread.

The documentation for this class was generated from the following files:

Generated by

Hosted by

cbits::Thread_WIN32 Class Reference

Public Types

Public Methods

Static Public Methods

Protected Methods

Static Protected Methods

Private Methods

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation