CommandsRegisterStructure.h

Go to the documentation of this file.

#ifndef __COMMANDS_REGISTER_STRUCTURE__
#define __COMMANDS_REGISTER_STRUCTURE__

//------------------------------------------------------------------------------------------------------------
// Includes
//------------------------------------------------------------------------------------------------------------

#include <vector>
#include <iostream>
#include "CommandObject.h"

class CommandsRegisterStructure{

//------------------------------------------------------------------------------------------------------------
// Constructors & Destructors
//------------------------------------------------------------------------------------------------------------
public:

        /*
        * Creates the CommandsRegisterStructure
        */
        CommandsRegisterStructure();

        /*
        * Destroys the CommandsRegisterStructure
        */
        ~CommandsRegisterStructure();

//------------------------------------------------------------------------------------------------------------
// Methods
//------------------------------------------------------------------------------------------------------------

        void registerCommand(CommandObject * theCommand);

        /*
        * Gets the -ACTUAL- command text 
        * @return
        */
        //std::string getActualCommandText();

        /*
        * Gets the -LAST- command text 
        * @return
        */
        //std::string getLastCommandText();

        /*
        * Deletes all the registered actions and reinitialize the -ACTUAL- and  -LAST- iterators
        */
        void clearActions();

        /*
        * Moves to the the previous position the -ACTUAL- iterator
        * @return Indicates true if it was done
        */
        bool moveBack_Actual();

        /*
        * Moves to the the next position the -ACTUAL- iterator
        * @return Indicates true if it was done
        */
        bool moveForward_Actual();

        /*
        * Moves to the the previous position the -LAST- iterator
        * @return Indicates true if it was done
        */
        bool moveBack_Last();

        /*
        * Moves to the the next position the -LAST- iterator
        * @return Indicates true if it was done
        */
        bool moveForward_Last();

        /*
        * Indicates if the -LAST- iterator has a next action or not
        * @return Returns true if it has
        */
        bool hasLastNext();

        /*
        * Indicates if the -ACTUAL- iterator has a next action or not
        * @return Returns true if it has
        */
        bool hasActualNext();

        /*
        * Indicates if the -LAST- iterator has a previous action or not
        * @return Returns true if it has
        */
        bool hasLastPrevious();

        /*
        * Indicates if the -ACTUAL- iterator has a previous action or not
        * @return Returns true if it has
        */
        bool hasActualPrevious();

        /*
        * Puts to point the -ACTUAL- iterator up to the -LAST-  iterator.
        */
        void levelActualToLast();

        /*
        * Puts to point the -LAST- iterator up to the -ACTUAL- iterator and erases automatically the actions after the 
        * referenced last and the end of the registered actions if nothing is given by parameter.       
        */
        void levelLastToActual(bool clearingAfterLast = true);

        /*
        * Clear all the elements in the vector bettween the -LAST- iterator and the end of the vector
        */
        void clearAll_afterLast();

        /*
        * Clear all the elements in the vector bettween the -ACTUAL- iterator and the start of the vector       
        */
        void clearAll_beforeActual();

        bool isEmpty();

        int getCommandsCount();

        /*
        * Gets the -ACTUAL-  iterator information data pointer
        * @return The pointer to the referenced object by the -ACTUAL- iterator
        */
        CommandObject * getActual_Pointer();

        /*
        * Gets the -LAST-  iterator information data pointer
        * @return The pointer to the referenced object by the -LAST- iterator
        */
        CommandObject * getLast_Pointer();

        /*
        * Gets the command at the given position 
        * @return The pointer to the referenced object by the position
        */
        CommandObject * getCommandAt(int position);

        /*
        * Gets the index of the actualAction in the vector
        * @return actualIndexToExec Is the corresponding index
        */
        int getActualIndex();

        /*
        * Gets the index of the lasAction in the vector
        * @return lasAction Is the corresponding index
        */
        int getLasIndex();

        /*
        * Sets the index of the actualAction in the vector
        * @param newActualIndex Is the corresponding index
        */
        void setActualIndex(int newActualIndex);

        /*
        * Sets the index of the lasAction in the vector
        * @param newLasIndex Is the corresponding index
        */
        void setLasIndex(int newLasIndex);

        /*
        * Gets the registered commands vector size
        * @return Returns the vector size
        */
        int getRegistereCommandsCount();

        /*
        * Gets the total registered commands 
        * @return Returns the total of commands
        */
        int getTotalCommandsCount();


        

//------------------------------------------------------------------------------------------------------------
// Constants
//------------------------------------------------------------------------------------------------------------

private:        
//------------------------------------------------------------------------------------------------------------
// Attributes
//------------------------------------------------------------------------------------------------------------
        
        /*
        * Represents the actions successfully registered 
        */
        std::vector<CommandObject*> registeredActions;
        
        /*
        * Represents the index to the actual action to execute at the registered actions vector
        */
        //std::vector <CommandObject*>::iterator actualAction;
        int actualIndexToExec;
        
        /*
        * Represents the index to the last action executed at the registered actions vector
        */
        //std::vector <CommandObject*>::iterator lastAction;   
        int lastAction;   

};
#endif