diff options
Diffstat (limited to 'projects/Stacker/lib/compiler/StackerCompiler.h')
| -rw-r--r-- | projects/Stacker/lib/compiler/StackerCompiler.h | 248 |
1 files changed, 124 insertions, 124 deletions
diff --git a/projects/Stacker/lib/compiler/StackerCompiler.h b/projects/Stacker/lib/compiler/StackerCompiler.h index cd48ccb382..383e569c25 100644 --- a/projects/Stacker/lib/compiler/StackerCompiler.h +++ b/projects/Stacker/lib/compiler/StackerCompiler.h @@ -46,176 +46,176 @@ class StackerCompiler /// @name Constructors and Operators /// @{ public: - /// Default Constructor - StackerCompiler(); + /// Default Constructor + StackerCompiler(); - /// Destructor - ~StackerCompiler(); + /// Destructor + ~StackerCompiler(); private: - /// Do not copy StackerCompilers - StackerCompiler(const StackerCompiler&); + /// Do not copy StackerCompilers + StackerCompiler(const StackerCompiler&); - /// Do not copy StackerCompilers. - StackerCompiler& operator=(const StackerCompiler& ); + /// Do not copy StackerCompilers. + StackerCompiler& operator=(const StackerCompiler& ); /// @} /// @name High Level Interface /// @{ public: - /// @brief Compile a single file to LLVM bytecode. - /// - /// To use the StackerCompiler, just create one on - /// the stack and call this method. - Module* compile( - const std::string& filename, ///< File to compile - bool echo, ///< Causes compiler to echo output + /// @brief Compile a single file to LLVM bytecode. + /// + /// To use the StackerCompiler, just create one on + /// the stack and call this method. + Module* compile( + const std::string& filename, ///< File to compile + bool echo, ///< Causes compiler to echo output unsigned optLevel, ///< Level of optimization - size_t stack_size ); ///< Size of generated stack + size_t stack_size ); ///< Size of generated stack /// @} /// @name Accessors /// @{ public: - /// @brief Returns the name of the file being compiled. - std::string& filename() { return CurFilename; } + /// @brief Returns the name of the file being compiled. + std::string& filename() { return CurFilename; } /// @} /// @name Parse Handling Methods /// @{ private: - /// Allow only the parser to access these methods. No - /// one else should call them. - friend int Stackerparse(); + /// Allow only the parser to access these methods. No + /// one else should call them. + friend int Stackerparse(); - /// @brief Handle the start of a module - Module* handle_module_start(); + /// @brief Handle the start of a module + Module* handle_module_start(); - /// @brief Handle the end of a module - /// @param mod The module we're defining. - Module* handle_module_end( Module* mod ); + /// @brief Handle the end of a module + /// @param mod The module we're defining. + Module* handle_module_end( Module* mod ); - /// @brief Handle the start of a list of definitions - Module* handle_definition_list_start( ); + /// @brief Handle the start of a list of definitions + Module* handle_definition_list_start( ); - /// @brief Handle the end of a list of definitions - /// @param mod The module we're constructing - /// @param definition A definition (function) to add to the module - Module* handle_definition_list_end( Module* mod, Function* definition ); + /// @brief Handle the end of a list of definitions + /// @param mod The module we're constructing + /// @param definition A definition (function) to add to the module + Module* handle_definition_list_end( Module* mod, Function* definition ); - /// @brief Handle creation of the MAIN definition - /// @param func The function to be used as the MAIN definition - Function* handle_main_definition( Function* func ); + /// @brief Handle creation of the MAIN definition + /// @param func The function to be used as the MAIN definition + Function* handle_main_definition( Function* func ); - /// @brief Handle a forward definition - /// @param name The name of the definition being declared - Function* handle_forward( char* name ); + /// @brief Handle a forward definition + /// @param name The name of the definition being declared + Function* handle_forward( char* name ); - /// @brief Handle a general definition - /// @param name The name of the definition being defined - /// @param func The Function definition. - Function* handle_definition( char* name, Function* func ); + /// @brief Handle a general definition + /// @param name The name of the definition being defined + /// @param func The Function definition. + Function* handle_definition( char* name, Function* func ); - /// @brief Handle the start of a definition's word list - Function* handle_word_list_start(); + /// @brief Handle the start of a definition's word list + Function* handle_word_list_start(); - /// @brief Handle the end of a definition's word list - /// @param func The function to which the basic block is added - /// @param next The block to add to the function - Function* handle_word_list_end( Function* func, BasicBlock* next ); + /// @brief Handle the end of a definition's word list + /// @param func The function to which the basic block is added + /// @param next The block to add to the function + Function* handle_word_list_end( Function* func, BasicBlock* next ); - /// @brief Handle an if statement, possibly without an else - /// @brief ifTrue The block to execute if true - /// @brief ifFalse The optional block to execute if false - BasicBlock* handle_if( char* ifTrue, char* ifFalse = 0 ); + /// @brief Handle an if statement, possibly without an else + /// @brief ifTrue The block to execute if true + /// @brief ifFalse The optional block to execute if false + BasicBlock* handle_if( char* ifTrue, char* ifFalse = 0 ); - /// @brief Handle a while statement - /// @brief todo The block to repeatedly execute - BasicBlock* handle_while( char* todo ); + /// @brief Handle a while statement + /// @brief todo The block to repeatedly execute + BasicBlock* handle_while( char* todo ); - /// @brief Handle an identifier to call the identified definition - /// @param name The name of the identifier to be called. - BasicBlock* handle_identifier( char * name ); + /// @brief Handle an identifier to call the identified definition + /// @param name The name of the identifier to be called. + BasicBlock* handle_identifier( char * name ); - /// @brief Handle the push of a string onto the stack - /// @param value The string to be pushed. - BasicBlock* handle_string( char * value ); + /// @brief Handle the push of a string onto the stack + /// @param value The string to be pushed. + BasicBlock* handle_string( char * value ); - /// @brief Handle the push of an integer onto the stack. - /// @param value The integer value to be pushed. - BasicBlock* handle_integer( const int64_t value ); + /// @brief Handle the push of an integer onto the stack. + /// @param value The integer value to be pushed. + BasicBlock* handle_integer( const int64_t value ); - /// @brief Handle one of the reserved words (given as a token) - BasicBlock* handle_word( int tkn ); + /// @brief Handle one of the reserved words (given as a token) + BasicBlock* handle_word( int tkn ); /// @} /// @name Utility functions /// @{ public: - /// @brief Throws an exception to indicate an error - /// @param message The message to be output - /// @param line Override for the current line no - static inline void ThrowException( const std::string &message, - int line = -1) - { - if (line == -1) line = Stackerlineno; - // TODO: column number in exception - throw ParseException(TheInstance->CurFilename, message, line); - } + /// @brief Throws an exception to indicate an error + /// @param message The message to be output + /// @param line Override for the current line no + static inline void ThrowException( const std::string &message, + int line = -1) + { + if (line == -1) line = Stackerlineno; + // TODO: column number in exception + throw ParseException(TheInstance->CurFilename, message, line); + } private: - /// @brief Generate code to increment the stack index - Instruction* incr_stack_index( BasicBlock* bb, Value* ); - /// @brief Generate code to decrement the stack index. - Instruction* decr_stack_index( BasicBlock* bb, Value* ); - /// @brief Generate code to dereference the top of stack. - Instruction* get_stack_pointer( BasicBlock* bb, Value* ); - /// @brief Generate code to push any value onto the stack. - Instruction* push_value( BasicBlock* bb, Value* value ); - /// @brief Generate code to push a constant integer onto the stack. - Instruction* push_integer( BasicBlock* bb, int64_t value ); - /// @brief Generate code to pop an integer off the stack. - Instruction* pop_integer( BasicBlock* bb ); - /// @brief Generate code to push a string pointer onto the stack. - Instruction* push_string( BasicBlock* bb, const char* value ); - /// @brief Generate code to pop a string pointer off the stack. - Instruction* pop_string( BasicBlock* bb ); - /// @brief Generate code to get the top stack element. - Instruction* stack_top( BasicBlock* bb, Value* index ); - /// @brief Generate code to get the top stack element as a string. - Instruction* stack_top_string( BasicBlock* bb, Value* index ); - /// @brief Generate code to replace the top element of the stack. - Instruction* replace_top( BasicBlock* bb, Value* new_top, Value* index); + /// @brief Generate code to increment the stack index + Instruction* incr_stack_index( BasicBlock* bb, Value* ); + /// @brief Generate code to decrement the stack index. + Instruction* decr_stack_index( BasicBlock* bb, Value* ); + /// @brief Generate code to dereference the top of stack. + Instruction* get_stack_pointer( BasicBlock* bb, Value* ); + /// @brief Generate code to push any value onto the stack. + Instruction* push_value( BasicBlock* bb, Value* value ); + /// @brief Generate code to push a constant integer onto the stack. + Instruction* push_integer( BasicBlock* bb, int64_t value ); + /// @brief Generate code to pop an integer off the stack. + Instruction* pop_integer( BasicBlock* bb ); + /// @brief Generate code to push a string pointer onto the stack. + Instruction* push_string( BasicBlock* bb, const char* value ); + /// @brief Generate code to pop a string pointer off the stack. + Instruction* pop_string( BasicBlock* bb ); + /// @brief Generate code to get the top stack element. + Instruction* stack_top( BasicBlock* bb, Value* index ); + /// @brief Generate code to get the top stack element as a string. + Instruction* stack_top_string( BasicBlock* bb, Value* index ); + /// @brief Generate code to replace the top element of the stack. + Instruction* replace_top( BasicBlock* bb, Value* new_top, Value* index); /// @} /// @name Data Members (used during parsing) /// @{ public: - static StackerCompiler* TheInstance; ///< The instance for the parser + static StackerCompiler* TheInstance; ///< The instance for the parser private: - std::string CurFilename; ///< Current file name - Module* TheModule; ///< Module instance we'll build - Function* TheFunction; ///< Function we're building - FunctionType* DefinitionType; ///< FT for Definitions - GlobalVariable* TheStack; ///< For referencing _stack_ - GlobalVariable* TheIndex; ///< For referencing _index_ - Function* TheScanf; ///< External input function - Function* ThePrintf; ///< External output function - Function* TheExit; ///< External exit function - GlobalVariable* StrFormat; ///< Format for strings - GlobalVariable* NumFormat; ///< Format for numbers - GlobalVariable* ChrFormat; ///< Format for chars - GlobalVariable* InStrFormat; ///< Format for input strings - GlobalVariable* InNumFormat; ///< Format for input numbers - GlobalVariable* InChrFormat; ///< Format for input chars - ConstantInt* Zero; ///< long constant 0 - ConstantInt* One; ///< long constant 1 - ConstantInt* Two; ///< long constant 2 - ConstantInt* Three; ///< long constant 3 - ConstantInt* Four; ///< long constant 4 - ConstantInt* Five; ///< long constant 5 - std::vector<Value*> no_arguments; ///< no arguments for Stacker - bool echo; ///< Echo flag - size_t stack_size; ///< Size of stack to gen. - ArrayType* stack_type; ///< The type of the stack + std::string CurFilename; ///< Current file name + Module* TheModule; ///< Module instance we'll build + Function* TheFunction; ///< Function we're building + FunctionType* DefinitionType; ///< FT for Definitions + GlobalVariable* TheStack; ///< For referencing _stack_ + GlobalVariable* TheIndex; ///< For referencing _index_ + Function* TheScanf; ///< External input function + Function* ThePrintf; ///< External output function + Function* TheExit; ///< External exit function + GlobalVariable* StrFormat; ///< Format for strings + GlobalVariable* NumFormat; ///< Format for numbers + GlobalVariable* ChrFormat; ///< Format for chars + GlobalVariable* InStrFormat; ///< Format for input strings + GlobalVariable* InNumFormat; ///< Format for input numbers + GlobalVariable* InChrFormat; ///< Format for input chars + ConstantInt* Zero; ///< long constant 0 + ConstantInt* One; ///< long constant 1 + ConstantInt* Two; ///< long constant 2 + ConstantInt* Three; ///< long constant 3 + ConstantInt* Four; ///< long constant 4 + ConstantInt* Five; ///< long constant 5 + std::vector<Value*> no_arguments; ///< no arguments for Stacker + bool echo; ///< Echo flag + size_t stack_size; ///< Size of stack to gen. + ArrayType* stack_type; ///< The type of the stack /// @} }; |