source: orxonox.OLD/branches/world_entities/src/lib/shell/shell_buffer.h @ 5739

/*!
 * @file shell_buffer.h
 * @brief The Shell buffer Tasks
 * @see debug.h
*/

#ifndef _SHELL_BUFFER_H
#define _SHELL_BUFFER_H

#include <stdarg.h>

#define      SHELL_BUFFER_SIZE       16384         //!< The Size of the input-buffers (should be large enough to carry any kind of input)

// FORWARD DECLARATION
class Shell;
template<class T> class tList;
#ifndef NULL
#define NULL 0            //!< a pointer to NULL
#endif

//! A class handling output from orxonox via debug.h
class ShellBuffer {

 public:
  virtual ~ShellBuffer();
  /** @returns a Pointer to the only object of this Class */
  inline static ShellBuffer* getInstance() { if (!ShellBuffer::singletonRef) ShellBuffer::singletonRef = new ShellBuffer();  return ShellBuffer::singletonRef; };
  /** @returns true if this class is instanciated, false otherwise */
  inline static bool isInstanciated() { return (ShellBuffer::singletonRef == NULL)?false:true; };

  void registerShell(Shell* shell);
  void unregisterShell(Shell* shell);

  // BUFFER //
  /** @param bufferSize the new Buffer-Size */
  void setBufferSize(unsigned int bufferSize) { this->bufferSize = bufferSize; };
  void flush();
  static bool addBufferLineStatic(const char* line, ...);
  void addBufferLine(const char* line, va_list arg);
  /** @returns the List of stings from the Buffer */
  const tList<char>* getBuffer() const { return this->buffer; };
 /** @returns the Count of lines processed by the Shell. */
  inline long getLineCount() const { return this->lineCount; };

  void debug() const;

  private:
    ShellBuffer();

  private:
   static ShellBuffer*      singletonRef;                       //!< The singleton-reference to the only memeber of this class.
   unsigned int             bufferSize;                         //!< The Size of the buffer
   tList<char>*             buffer;                             //!< A list of stored char-arrays(strings) to store the history

   Shell*                   shell;                              //!< the Registered Shell.
   char                     bufferArray[SHELL_BUFFER_SIZE];     //!< a BUFFER for fast writing
   char                     keepBufferArray[SHELL_BUFFER_SIZE]; //!< a BUFFER to have multi-non-newLine commands be copied into the shell.
   bool                     keepBuffer;                         //!< if the keepbuffer contains unfinished lines.

   unsigned long            lineCount;                          //!< how many Lines have been written out so far.
};

#endif /* _SHELL_BUFFER_H */