]> rtime.felk.cvut.cz Git - boost-statechart-viewer.git/blobdiff - src/iooper.h
Create dir for MSVC version source files. Update commentaries at source files.
[boost-statechart-viewer.git] / src / iooper.h
index acd72c79eb01fd182aba7331d2ff39b68bd00418..a5bd254563a9bb09ed4797234f0bbd15a1c86807 100644 (file)
@@ -1,4 +1,4 @@
-
+/** @file */ 
 ////////////////////////////////////////////////////////////////////////////////////////  
 //    
 //    This file is part of Boost Statechart Viewer.
 
 #include <fstream>
 #include <list>
+#include <string>
 
 #include "stringoper.h"
 
 using namespace std;
 
+/**
+* This class provides saving information about state machine to a specified output file. It saves states and transitions and also it creates the transition table.
+*/
 class IO_operations
-{
-       list<string> transitions;
-       list<string> states;
-       list<string> events;
-       string outputFilename;
+{      
+       list<string> transitions; /** list of transitions */
+       list<string> states; /** list of states */
+       list<string> events; /** list of events */
+       string outputFilename; 
        string name_of_machine;
        string name_of_first_state;
+       string *table; /** transition table. It is being allocated when starting the creation of output file. */
+       int nState;
+       int cols, rows;
+       /** This function finds place in the transition table to put a transition there. */
+       int find_place(string model, int type)
+       {
+               if(type == 1)
+               {
+                       for(int i = 3;i<cols;i++)
+                       {
+                               if(model.compare(0,model.size(),table[i])==0) return i;
+                       }
+               }
+               else 
+               {
+                       for(int i = 1;i<rows;i++)
+                       if(model.compare(0,model.size(),table[i*cols+2])==0) return i;
+               }
+               return -1;
+       }
        public:
-       IO_operations() {}
-       
+       IO_operations() {} /** Implicit constructor */
+       /** Constructor that fill in all private variables in this class */
        IO_operations( const string outputFile, const string FSM_name, const string firstState, const list<string> trans, const list<string> state, const list<string> ev )
        {
                outputFilename = outputFile;
@@ -46,44 +70,51 @@ class IO_operations
                events = ev;
        }
 
-       // set methods
-       void setEvents(list<string> events)
+       ~IO_operations() /** destructor. It deallocates the transition table.*/
+       {
+               delete table;
+       }
+       
+       void setEvents(list<string> events) /** Set list of events to an attribute */
        {
                this->events = events;
        }
        
-       void setTransitions(list<string> transitions)
+       void setTransitions(list<string> transitions) /** Set list of transitions to an attribute */
        {
                this->transitions = transitions;
        }
 
-       void setStates(list<string> states)
+       void setStates(list<string> states) /** Set list of states to an attribute */
        {
                this->states = states;
        }
 
-       void setNameOfStateMachine(string name_of_FSM)
+       void setNameOfStateMachine(string name_of_FSM) /** Set name of FSM to an attribute */
        {
                name_of_machine = name_of_FSM;
        }
 
-       void setNameOfFirstState(string first_state)
+       void setNameOfFirstState(string first_state) /** Set name of start state to an attribute */ 
        {
                name_of_first_state = first_state;
        }
 
-       void setOutputFilename(string outputFilename)
+       void setOutputFilename(string outputFilename) /** Set name of an output file to an attribute */
        {
                this->outputFilename = outputFilename;
        }
        
-       // outputfile writing methods
-       void write_states(ofstream& filestr) // write states
+       bool write_states(ofstream& filestr) /** This method write states to the output file and also to transition table. */
        {
                int pos1, pos2, cnt, subs;
-               string context, state, ctx;
+               nState = 1;
+               string context, state, ctx, sState, str;
                list<string> nstates = states;
                context = name_of_machine;
+               table[0] = "S";
+               table[1] = "Context";
+               table[2] = "State";
                for(list<string>::iterator i = nstates.begin();i!=nstates.end();i++) // write all states in the context of the automaton
                {
                        state = *i;
@@ -94,9 +125,14 @@ class IO_operations
                                ctx = cut_namespaces(state.substr(pos1+1));
                                if(ctx.compare(0,context.length(),context)==0)
                                {
-                                       filestr<<cut_namespaces(state.substr(0,pos1))<<";\n";
+                                       str = cut_namespaces(state.substr(0,pos1));
+                                       filestr<<str<<";\n";
+                                       table[cols*nState+2] = str;
+                                       table[cols*nState+1] = context;
+                                       nState+=1;
                                        nstates.erase(i);
                                        i--;
+                                       if(str.compare(0,str.length(),name_of_first_state)==0) table[cols*(nState-1)] = "*";
                                }
                        }
                        if(cnt==2)
@@ -106,10 +142,16 @@ class IO_operations
                                ctx = cut_namespaces(state.substr(pos1+1,pos2-pos1-1));
                                if(ctx.compare(0,context.length(),context)==0)
                                {                               
-                                       filestr<<cut_namespaces(state.substr(0,pos1))<<";\n";
+                                       str = cut_namespaces(state.substr(0,pos1));
+                                       filestr<<str<<";\n";
+                                       table[cols*nState+2] = str;
+                                       table[cols*nState+1] = context;                 
+                                       nState+=1;
+                                       if(str.compare(0,str.length(),name_of_first_state)==0) table[cols*(nState-1)] = "*";
                                }
                        }
                }
+               filestr<<name_of_first_state<<" [peripheries=2] ;\n";
                subs = 0;
                while(!nstates.empty()) // substates ?
                {
@@ -117,11 +159,13 @@ class IO_operations
                        filestr<<"subgraph cluster"<<subs<<" {\n";                      
                        pos1 = state.find(",");
                        pos2 = state.rfind(",");
+                       if(pos1 == pos2) return false;
+                                               
                        context = cut_namespaces(state.substr(0,pos1));
                        filestr<<"label=\""<<context<<"\";\n";
-                       filestr<<cut_namespaces(state.substr(pos2+1))<<" [peripheries=2] ;\n";  
+                       sState = cut_namespaces(state.substr(pos2+1));
+                       filestr<<sState<<" [peripheries=2] ;\n";        
                        nstates.pop_front();    
-                       //std::cout<<states.size();     
                        for(list<string>::iterator i = nstates.begin();i!=nstates.end();i++)
                        {
                                state = *i;
@@ -132,9 +176,14 @@ class IO_operations
                                        ctx = cut_namespaces(state.substr(pos1+1));
                                        if(ctx.compare(0,context.length(),context)==0)
                                        {
-                                               filestr<<cut_namespaces(state.substr(0,pos1))<<";\n";
+                                               str = cut_namespaces(state.substr(0,pos1));
+                                               filestr<<str<<";\n";
+                                               table[cols*nState+2] = str;
+                                               table[cols*nState+1] = context;
+                                               nState+=1;
                                                nstates.erase(i);
                                                i--;
+                                               if(str.compare(0,str.length(),sState)==0) table[cols*(nState-1)] = "*";
                                        }
                                }
                                if(cnt==2)
@@ -142,54 +191,119 @@ class IO_operations
                                        pos1 = state.find(",");
                                        pos2 = state.rfind(",");
                                        ctx = cut_namespaces(state.substr(pos1+1,pos2-pos1-1));
-                                       if(ctx.compare(0,context.length(),context)==0) filestr<<cut_namespaces(state.substr(0,pos1))<<";\n";
+                                       if(ctx.compare(0,context.length(),context)==0) 
+                                       {
+                                               str = cut_namespaces(state.substr(0,pos1));
+                                               filestr<<str<<";\n";
+                                               table[cols*nState+2] = str;
+                                               table[cols*nState+1] = context;
+                                               nState+=1;
+                                               if(str.compare(0,str.length(),sState)==0) table[cols*(nState-1)] = "*";
+                                       }
                                }
                        }
                        filestr<<"}\n";
                        subs+=1;        
                }
-               return;
+               return true;
        }
 
-       void write_transitions(ofstream& filestr) // write transitions
+       void write_transitions(ofstream& filestr) /** Write transitions to the output file nad the transition table. */
        {
                int pos1, pos2;
-               string state;
+               string params, state, event, dest;
                for(list<string>::iterator i = transitions.begin();i!=transitions.end();i++) // write all transitions
                {
-                       state = *i;
-                       pos1 = state.find(",");
-                       filestr<<cut_namespaces(state.substr(0,pos1))<<"->";
-                       pos2 = state.rfind(",");
-                       filestr<<cut_namespaces(state.substr(pos2+1));
-                       filestr<<"[label=\""<<cut_namespaces(state.substr(pos1+1,pos2-pos1-1))<<"\"];\n";
+                       params = *i;
+                       pos1 = params.find(",");
+                       state = cut_namespaces(params.substr(0,pos1));
+                       filestr<<state<<"->";
+                       pos2 = params.rfind(",");
+                       dest = cut_namespaces(params.substr(pos2+1));
+                       filestr<<dest;
+                       event = cut_namespaces(params.substr(pos1+1,pos2-pos1-1));
+                       filestr<<"[label=\""<<event<<"\"];\n";
+                       table[find_place(state,2)*cols+find_place(event,1)]=dest;
                }               
                return;
        }
 
-       void save_to_file() // save state automaton to file
+       void fill_table_with_events() /** Fill the first row of the transition table with events. */
+       {
+               int j = 3;
+               for(list<string>::iterator i = events.begin();i!=events.end();i++)
+               {
+                       table[j] = *i;
+                       j++;
+               }
+       }
+
+       void save_to_file() /** Create output file stream and write there the name of state machine. It controls the whole process of writing into output files. */
        {
                if(!name_of_first_state.empty())        
                {       
                        ofstream filestr(outputFilename.c_str());
                        filestr<<"digraph "<< name_of_machine<< " {\n";
-                       filestr<<name_of_first_state<<" [peripheries=2] ;\n";
-                       write_states(filestr);
+                       cols = events.size()+3;
+                       rows = states.size()+1;
+                       table = new string [cols*rows];
+                       fill_table_with_events();                       
+                       if(!write_states(filestr)) 
+                       {
+                               cerr<<"Error during writing states.\n";
+                               filestr<<"}";           
+                               filestr.close();
+                               return;                 
+                       }
                        write_transitions(filestr);
                        filestr<<"}";           
                        filestr.close();
+                       print_table();
                }
                else cout<<"No state machine was found. So no output file was created.\n";
                return;
        }
-               
-       // method for printing statistics about state automaton
-       void print_stats() // print statistics
+
+       void print_table() /** This function prints the transition table. At first it counts the size of all columns. */
+       {
+               cout<<"\nTRANSITION TABLE\n";
+               unsigned * len = new unsigned[cols];
+               len[0] = 1;
+               string line = "-|---|-";
+               for(int i = 1; i<cols; i++)
+               {
+                       len[i] = 0;
+                       for(int j = 0;j<rows;j++)
+                       {
+                               if(len[i]<table[j*cols+i].length()) len[i] = table[j*cols+i].length();
+                       }
+                       for(unsigned k = 0; k<len[i]; k++)
+                       {
+                               line.append("-");
+                       }
+                       line.append("-|-");
+               }
+               cout<<line<<"\n";
+               for(int i = 0; i<rows; i++)
+               {
+                       cout<<" | ";            
+                       for(int j = 0;j<cols;j++)
+                       {
+                               cout.width(len[j]);
+                               cout<<left<<table[i*cols+j]<<" | ";
+                       }
+                       cout<<"\n";
+                       cout<<line<<"\n";
+               }
+               delete len;
+       }
+
+       void print_stats() /** Print short statistics about the state machine */
        {
                cout<<"\n"<<"Statistics: \n";
                cout<<"Number of states: "<<states.size()<<"\n";
                cout<<"Number of events: "<<events.size()<<"\n";
-               cout<<"Number of transitions: "<<transitions.size()<<"\n";
+               cout<<"Number of transitions: "<<transitions.size()<<"\n\n";
                return;
        }