source: orxonox.OLD/branches/bsp_model/src/lib/shell/shell_buffer.h @ 7914

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

#ifndef _SHELL_BUFFER_H
#define _SHELL_BUFFER_H

#include <stdarg.h>
#include <list>
#include "threading.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;

#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 std::list<std::string>& 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
    std::list<std::string>   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.

    static SDL_mutex*        bufferMutex;                        //!< Only one thread may write into the ShellBuffer at a time.
};

#endif /* _SHELL_BUFFER_H */