Cpl::TShell::Stdio Class Reference

This concrete class provides the 'threading wrapper' for running a TShell Command Processor. More...

Detailed Description

This concrete class provides the 'threading wrapper' for running a TShell Command Processor.

This requires that the Input/Output streams be provided when the Shell is launched.

NOTE: This class dynamically allocates memory and dynamically creates a Thread!

#include <Stdio.h>

Inheritance diagram for Cpl::TShell::Stdio:

Collaboration diagram for Cpl::TShell::Stdio:

Public Member Functions
	Stdio (ProcessorApi &shell, const char *threadName="TShell", int threadPriority=CPL_SYSTEM_THREAD_PRIORITY_NORMAL+CPL_SYSTEM_THREAD_PRIORITY_LOWER, bool thisIsAStaticInstance=true) noexcept
	Constructor.
	~Stdio ()
	Destructor.
void	launch (Cpl::Io::Input &infd, Cpl::Io::Output &outfd) noexcept
	This method starts the Processor.

Protected Attributes
ProcessorApi &	m_shell
	Command Processor to run.
Cpl::System::Thread *	m_threadPtr
	Thread that the shell runs in.
int	m_priority
	Thread priority to run the shell.
const char *	m_name
	Thread name for the shell.
Cpl::System::Runnable *	m_runnablePtr
	Runnable instance.
bool	m_staticInstance
	How I was created.

Constructor & Destructor Documentation

Stdio()

Cpl::TShell::Stdio::Stdio ( ProcessorApi &  shell, const char *  threadName = "TShell", int  threadPriority = CPL_SYSTEM_THREAD_PRIORITY_NORMAL+CPL_SYSTEM_THREAD_PRIORITY_LOWER, bool  thisIsAStaticInstance = true  )

noexcept

Constructor.

The 'thisIsAStaticInstance' argument is to inform the instance being create that it is being created statically (i.e. before main() is entered) - which is the intended typically behavior. This knowledge is used to inhibit delete/destroy-thread actions in the instance's destructor. This is necessary because there is no guaranteed order to when static destructor fire and as such the state of the CPL Libraries static resources (e.g. mutexes) are unknown which your application will crash/behavior poorly on exit.

~Stdio()

Cpl::TShell::Stdio::~Stdio

(

)

Destructor.

Member Function Documentation

launch()

void Cpl::TShell::Stdio::launch ( Cpl::Io::Input &  infd, Cpl::Io::Output &  outfd  )

noexcept

This method starts the Processor.

It is thread safe in that it runs in the context of the calling thread - and spawns a new thread for Shell/Command Processor to executing in.

Member Data Documentation

m_name

const char* Cpl::TShell::Stdio::m_name

protected

Thread name for the shell.

m_priority

int Cpl::TShell::Stdio::m_priority

protected

Thread priority to run the shell.

m_runnablePtr

Cpl::System::Runnable* Cpl::TShell::Stdio::m_runnablePtr

protected

Runnable instance.

m_shell

ProcessorApi& Cpl::TShell::Stdio::m_shell

protected

Command Processor to run.

m_staticInstance

bool Cpl::TShell::Stdio::m_staticInstance

protected

How I was created.

m_threadPtr

Cpl::System::Thread* Cpl::TShell::Stdio::m_threadPtr

protected

Thread that the shell runs in.

---

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

• Cpl/TShell/Stdio.h