source: src/ControlStruct/MLEMutator.cc @ 356189a

//
// Cforall Version 1.0.0 Copyright (C) 2015 University of Waterloo
//
// The contents of this file are covered under the licence agreement in the
// file "LICENCE" distributed with Cforall.
//
// MLEMutator.cc -- 
//
// Author           : Rodolfo G. Esteves
// Created On       : Mon May 18 07:44:20 2015
// Last Modified By : Rob Schluntz
// Last Modified On : Mon Jul 20 13:58:35 2015
// Update Count     : 176
//

// NOTE: There are two known subtle differences from the code that uC++ 
// generates for the same input
// -CFA puts the break label inside at the end of a switch, uC++ puts it after
// -CFA puts the break label after a block, uC++ puts it inside at the end
// we don't yet know if these differences are important, but if they are then
// the fix would go in this file, since this is where these labels are generated.

#include <cassert>
#include <algorithm>

#include "MLEMutator.h"
#include "SynTree/Statement.h"
#include "SynTree/Expression.h"

namespace ControlStruct {
        MLEMutator::~MLEMutator() {
                delete targetTable;
                targetTable = 0;
        }

        // break labels have to come after the statement they break out of, 
        // so mutate a statement, then if they inform us through the breakLabel field
        // tha they need a place to jump to on a break statement, add the break label 
        // to the body of statements
        void MLEMutator::fixBlock( std::list< Statement * > &kids ) {
                for ( std::list< Statement * >::iterator k = kids.begin(); k != kids.end(); k++ ) {
                        *k = (*k)->acceptMutator(*this);

                        if ( ! get_breakLabel().empty() ) {
                                std::list< Statement * >::iterator next = k+1;
                                if ( next == kids.end() ) {
                                        std::list<Label> ls; ls.push_back( get_breakLabel() );
                                        kids.push_back( new NullStmt( ls ) );
                                } else {
                                        (*next)->get_labels().push_back( get_breakLabel() );
                                }

                                set_breakLabel("");
                        } // if
                } // for
        }

        CompoundStmt* MLEMutator::mutate( CompoundStmt *cmpndStmt ) {
                bool labeledBlock = !(cmpndStmt->get_labels().empty());
                if ( labeledBlock ) {
                        Label brkLabel = generator->newLabel("blockBreak");
                        enclosingBlocks.push_back( Entry( cmpndStmt, brkLabel ) );
                } // if

                // a child statement may set the break label
                // - if they do, attach it to the next statement
                std::list< Statement * > &kids = cmpndStmt->get_kids();
                fixBlock( kids );

                if ( labeledBlock ) {
                        assert( ! enclosingBlocks.empty() );
                        if ( ! enclosingBlocks.back().useBreakExit().empty() ) {
                                set_breakLabel( enclosingBlocks.back().useBreakExit() );
                        }
                        enclosingBlocks.pop_back();
                } // if

                return cmpndStmt;
        }

        template< typename LoopClass >
        Statement *MLEMutator::handleLoopStmt( LoopClass *loopStmt ) {
                // remember this as the most recent enclosing loop, then mutate 
                // the body of the loop -- this will determine whether brkLabel
                // and contLabel are used with branch statements
                // and will recursively do the same to nested loops
                Label brkLabel = generator->newLabel("loopBreak");
                Label contLabel = generator->newLabel("loopContinue");
                enclosingLoops.push_back( Entry( loopStmt, brkLabel, contLabel ) );
                loopStmt->set_body ( loopStmt->get_body()->acceptMutator( *this ) );

                // sanity check that the enclosing loops have been popped correctly
                Entry &e = enclosingLoops.back();
                assert ( e == loopStmt );

                // this will take the necessary steps to add definitions of the previous
                // two labels, if they are used.
                loopStmt->set_body( mutateLoop( loopStmt->get_body(), e ) );
                enclosingLoops.pop_back();

                return loopStmt;
        }

        Statement *MLEMutator::mutate( CaseStmt *caseStmt ) {
                caseStmt->set_condition( maybeMutate( caseStmt->get_condition(), *this ) );
                fixBlock( caseStmt->get_statements() );

                return caseStmt;
        }

        template< typename SwitchClass >
        Statement *MLEMutator::handleSwitchStmt( SwitchClass *switchStmt ) {
                // generate a label for breaking out of a labeled switch 
                Label brkLabel = generator->newLabel("switchBreak");
                enclosingSwitches.push_back( Entry(switchStmt, brkLabel) );
                mutateAll( switchStmt->get_branches(), *this ); 

                Entry &e = enclosingSwitches.back();
                assert ( e == switchStmt );

                // only generate break label if labeled break is used
                if (e.isBreakUsed()) {
                        // for the purposes of keeping switch statements uniform (i.e. all statements that are 
                        // direct children of a switch should be CastStmts), append the exit label + break to the 
                        // last case statement; create a default case if there are no cases
                        std::list< Statement * > &branches = switchStmt->get_branches();
                        if ( branches.empty() ) {
                                branches.push_back( CaseStmt::makeDefault() );
                        }

                        if ( CaseStmt * c = dynamic_cast< CaseStmt * >( branches.back() ) ) {
                                std::list<Label> temp; temp.push_back( brkLabel );
                                c->get_statements().push_back( new BranchStmt( temp, Label(""), BranchStmt::Break ) );
                        } else assert(0); // as of this point, all branches of a switch are still CaseStmts
                }

                assert ( enclosingSwitches.back() == switchStmt );
                enclosingSwitches.pop_back();
                return switchStmt;
        }

        Statement *MLEMutator::mutate( BranchStmt *branchStmt ) throw ( SemanticError ) {
                std::string originalTarget = branchStmt->get_originalTarget();

                if ( branchStmt->get_type() == BranchStmt::Goto )
                        return branchStmt;

                // test if continue target is a loop
                if ( branchStmt->get_type() == BranchStmt::Continue) {
                        if ( enclosingLoops.empty() ) {
                                throw SemanticError( "'continue' outside a loop" );
                        } else if ( branchStmt->get_target() != "" && std::find( enclosingLoops.begin(), enclosingLoops.end(), (*targetTable)[branchStmt->get_target()] ) == enclosingLoops.end() ) {
                                throw SemanticError( "'continue' target label must be an enclosing loop: " + originalTarget );
                        }
                }

                if ( branchStmt->get_type() == BranchStmt::Break && (enclosingLoops.empty() && enclosingSwitches.empty() && enclosingBlocks.empty() ) )
                        throw SemanticError( "'break' outside a loop or switch" );

                if ( branchStmt->get_target() == "" ) return branchStmt;

                if ( targetTable->find( branchStmt->get_target() ) == targetTable->end() )
                        throw SemanticError("The label defined in the exit loop statement does not exist: " + originalTarget );  // shouldn't happen (since that's already checked)

                std::list< Entry >::iterator check;
                if ( ( check = std::find( enclosingLoops.begin(), enclosingLoops.end(), (*targetTable)[branchStmt->get_target()] ) ) == enclosingLoops.end() )
                        // not in loop, checking if in block
                        if ( (check = std::find( enclosingBlocks.begin(), enclosingBlocks.end(), (*targetTable)[branchStmt->get_target()] )) == enclosingBlocks.end() )
                                // neither in loop nor in block, checking if in switch/choose
                                if ( (check = std::find( enclosingSwitches.begin(), enclosingSwitches.end(), (*targetTable)[branchStmt->get_target()] )) == enclosingSwitches.end() )
                                        throw SemanticError("The target specified in the exit loop statement does not correspond to an enclosing control structure: " + originalTarget );

                // what about exiting innermost block or switch???
                if ( enclosingLoops.back() == (*check) )
                        return branchStmt;                              // exit the innermost loop (labels unnecessary)

                // branch error checks, get the appropriate label name and create a goto
                Label exitLabel;
                switch ( branchStmt->get_type() ) {
                  case BranchStmt::Break:
                                assert( check->useBreakExit() != "");
                                exitLabel = check->useBreakExit();
                                break;
                  case BranchStmt::Continue:
                                assert( check->useContExit() != "");
                                exitLabel = check->useContExit();
                                break;
                  default:
                                assert(0);                                      // shouldn't be here
                } // switch

                return new BranchStmt( std::list<Label>(), exitLabel, BranchStmt::Goto );
        }

        Statement *MLEMutator::mutateLoop( Statement *bodyLoop, Entry &e ) {
                // ensure loop body is a block
                CompoundStmt *newBody;
                if ( ! (newBody = dynamic_cast<CompoundStmt *>( bodyLoop )) ) {
                        newBody = new CompoundStmt( std::list< Label >() );
                        newBody->get_kids().push_back( bodyLoop );
                } // if

                // only generate these when needed

                if ( e.isContUsed() ) {
                        // continue label goes in the body as the last statement
                        std::list< Label > labels; labels.push_back( e.useContExit() );
                        newBody->get_kids().push_back( new NullStmt( labels ) );                        
                }

                if ( e.isBreakUsed() ) {
                        // break label goes after the loop -- it'll get set by the 
                        // outer mutator if we do this
                        set_breakLabel( e.useBreakExit() );                     
                }

                return newBody;
        }

        Statement *MLEMutator::mutate( WhileStmt *whileStmt ) {
                return handleLoopStmt( whileStmt );
        }

        Statement *MLEMutator::mutate( ForStmt *forStmt ) {
                return handleLoopStmt( forStmt );
        }

        Statement *MLEMutator::mutate( SwitchStmt *switchStmt ) {
                return handleSwitchStmt( switchStmt );
        }

        Statement *MLEMutator::mutate( ChooseStmt *switchStmt ) {
                return handleSwitchStmt( switchStmt );          
        }

} // namespace ControlStruct

// Local Variables: //
// tab-width: 4 //
// mode: c++ //
// compile-command: "make install" //
// End: //