OGRE  1.8
Object-Oriented Graphics Rendering Engine
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
OgreGLSLESPreprocessor.h
Go to the documentation of this file.
1 
29 #ifndef __OGRE_CPREPROCESSOR_H__
30 #define __OGRE_CPREPROCESSOR_H__
31 
32 #include <string.h>
33 #include <stdlib.h>
34 
35 namespace Ogre {
36 
61 class CPreprocessor
62 {
76  class Token
77  {
78  public:
79  enum Kind
80  {
81  TK_EOS, // End of input stream
82  TK_ERROR, // An error has been encountered
83  TK_WHITESPACE, // A whitespace span (but not newline)
84  TK_NEWLINE, // A single newline (CR & LF)
85  TK_LINECONT, // Line continuation ('\' followed by LF)
86  TK_NUMBER, // A number
87  TK_KEYWORD, // A keyword
88  TK_PUNCTUATION, // A punctuation character
89  TK_DIRECTIVE, // A preprocessor directive
90  TK_STRING, // A string
91  TK_COMMENT, // A block comment
92  TK_LINECOMMENT, // A line comment
93  TK_TEXT // An unparsed text (cannot be returned from GetToken())
94  };
95 
97  Kind Type;
99  mutable size_t Allocated;
100  union
101  {
103  const char *String;
105  char *Buffer;
106  };
108  size_t Length;
109 
110  Token () : Allocated (0), String (NULL)
111  { }
112 
113  Token (Kind iType) : Type (iType), Allocated (0), String (NULL)
114  { }
115 
116  Token (Kind iType, const char *iString, size_t iLength) :
117  Type (iType), Allocated (0), String (iString), Length (iLength)
118  { }
119 
120  Token (const Token &iOther)
121  {
122  Type = iOther.Type;
123  Allocated = iOther.Allocated;
124  iOther.Allocated = 0; // !!! not quite correct but effective
125  String = iOther.String;
126  Length = iOther.Length;
127  }
128 
130  { if (Allocated) free (Buffer); }
131 
133  Token &operator = (const Token &iOther)
134  {
135  if (Allocated) free (Buffer);
136  Type = iOther.Type;
137  Allocated = iOther.Allocated;
138  iOther.Allocated = 0; // !!! not quite correct but effective
139  String = iOther.String;
140  Length = iOther.Length;
141  return *this;
142  }
143 
145  void Append (const char *iString, size_t iLength);
146 
148  void Append (const Token &iOther);
149 
151  void AppendNL (int iCount);
152 
154  int CountNL ();
155 
157  bool GetValue (long &oValue) const;
158 
160  void SetValue (long iValue);
161 
163  bool operator == (const Token &iOther)
164  {
165  if (iOther.Length != Length)
166  return false;
167  return (memcmp (String, iOther.String, Length) == 0);
168  }
169  };
170 
172  class Macro
173  {
174  public:
176  Token Name;
178  int NumArgs;
180  Token *Args;
182  Token Value;
184  Token Body;
186  Macro *Next;
188  Token (*ExpandFunc) (CPreprocessor *iParent, int iNumArgs, Token *iArgs);
190  bool Expanding;
191 
192  Macro (const Token &iName) :
193  Name (iName), NumArgs (0), Args (NULL), Next (NULL),
194  ExpandFunc (NULL), Expanding (false)
195  { }
196 
198  //{ OGRE_DELETE [] Args; OGRE_DELETE Next; }
199  { delete [] Args; delete Next; }
200 
202  Token Expand (int iNumArgs, Token *iArgs, Macro *iMacros);
203  };
204 
205  friend class CPreprocessor::Macro;
206 
208  const char *Source;
210  const char *SourceEnd;
212  int Line;
214  bool BOL;
216  unsigned EnableOutput;
218  Macro *MacroList;
219 
223  CPreprocessor (const Token &iToken, int iLine);
224 
232  Token GetToken (bool iExpand);
233 
243  Token HandleDirective (Token &iToken, int iLine);
244 
255  bool HandleDefine (Token &iBody, int iLine);
256 
267  bool HandleUnDef (Token &iBody, int iLine);
268 
279  bool HandleIfDef (Token &iBody, int iLine);
280 
291  bool HandleIf (Token &iBody, int iLine);
292 
303  bool HandleElse (Token &iBody, int iLine);
304 
315  bool HandleEndIf (Token &iBody, int iLine);
316 
327  Token GetArgument (Token &oArg, bool iExpand);
328 
339  Token GetArguments (int &oNumArgs, Token *&oArgs, bool iExpand);
340 
354  Token GetExpression (Token &oResult, int iLine, int iOpPriority = 0);
355 
371  bool GetValue (const Token &iToken, long &oValue, int iLine);
372 
381  Token ExpandMacro (const Token &iToken);
382 
390  Macro *IsDefined (const Token &iToken);
391 
403  static Token ExpandDefined (CPreprocessor *iParent, int iNumArgs, Token *iArgs);
404 
412  Token Parse (const Token &iSource);
413 
423  void Error (int iLine, const char *iError, const Token *iToken = NULL);
424 
425 public:
428  { }
429 
431  virtual ~CPreprocessor ();
432 
444  void Define (const char *iMacroName, size_t iMacroNameLen,
445  const char *iMacroValue, size_t iMacroValueLen);
446 
456  void Define (const char *iMacroName, size_t iMacroNameLen, long iMacroValue);
457 
467  bool Undef (const char *iMacroName, size_t iMacroNameLen);
468 
491  char *Parse (const char *iSource, size_t iLength, size_t &oLength);
492 
508  typedef void (*ErrorHandlerFunc) (
509  void *iData, int iLine, const char *iError,
510  const char *iToken, size_t iTokenLen);
511 
518 
520  void *ErrorData;
521 };
522 
523 } // namespace Ogre
524 
525 #endif // __OGRE_CPREPROCESSOR_H__
bool HandleUnDef(Token &iBody, int iLine)
Undefine a previously defined macro.
Macro * MacroList
The list of macros defined so far.
static ErrorHandlerFunc ErrorHandler
A pointer to the preprocessor's error handler.
unsigned EnableOutput
A stack of 32 booleans packed into one value :)
void(* ErrorHandlerFunc)(void *iData, int iLine, const char *iError, const char *iToken, size_t iTokenLen)
An error handler function type.
size_t Length
Token length in bytes.
static Token ExpandDefined(CPreprocessor *iParent, int iNumArgs, Token *iArgs)
The implementation of the defined() preprocessor function.
Token(Kind iType, const char *iString, size_t iLength)
bool BOL
True if we are at beginning of line.
Macro * Next
Next macro in chained list.
Token Value
The macro value.
const char * String
A pointer somewhere into the input buffer.
int NumArgs
Number of arguments.
size_t Allocated
True if string was allocated (and must be freed)
bool GetValue(long &oValue) const
Get the numeric value of the token.
char * Buffer
A memory-allocated string.
Token Expand(int iNumArgs, Token *iArgs, Macro *iMacros)
Expand the macro value (will not work for functions)
int Line
Current line number.
This is a simplistic C/C++-like preprocessor.
Token GetToken(bool iExpand)
Stateless tokenizer: Parse the input text and return the next token.
void Define(const char *iMacroName, size_t iMacroNameLen, const char *iMacroValue, size_t iMacroValueLen)
Define a macro without parameters.
Token GetExpression(Token &oResult, int iLine, int iOpPriority=0)
Parse an expression, compute it and return the result.
Token GetArguments(int &oNumArgs, Token *&oArgs, bool iExpand)
Get all the arguments of a macro: '(' arg1 { ',' arg2 { ',' ...
void SetValue(long iValue)
Set the numeric value of the token.
bool Expanding
true if macro expansion is in progress
Token(* ExpandFunc)(CPreprocessor *iParent, int iNumArgs, Token *iArgs)
A pointer to function implementation (if macro is really a func)
Token ExpandMacro(const Token &iToken)
Expand the given macro, if it exists.
bool HandleEndIf(Token &iBody, int iLine)
Handle an #endif directive.
int CountNL()
Count number of newlines in this token.
Token & operator=(const Token &iOther)
Assignment operator.
bool HandleIf(Token &iBody, int iLine)
Handle an #if directive.
bool HandleDefine(Token &iBody, int iLine)
Handle a #define directive.
Token Parse(const Token &iSource)
Parse the input string and return a token containing the whole output.
Token Body
Unparsed macro body (keeps the whole raw unparsed macro body)
const char * Source
The current source text input.
const char * SourceEnd
The end of the source text.
bool HandleElse(Token &iBody, int iLine)
Handle an #else directive.
bool HandleIfDef(Token &iBody, int iLine)
Handle an #ifdef directive.
void AppendNL(int iCount)
Append given number of newlines to this token.
void Error(int iLine, const char *iError, const Token *iToken=NULL)
Call the error handler.
CPreprocessor()
Create an empty preprocessor object.
Token HandleDirective(Token &iToken, int iLine)
Handle a preprocessor directive.
virtual ~CPreprocessor()
Destroy the preprocessor object.
bool operator==(const Token &iOther)
Test two tokens for equality.
_StringBase String
Token GetArgument(Token &oArg, bool iExpand)
Get a single function argument until next ',' or ')'.
bool GetValue(const Token &iToken, long &oValue, int iLine)
Get the numeric value of a token.
Macro * IsDefined(const Token &iToken)
Check if a macro is defined, and if so, return it.
void Append(const char *iString, size_t iLength)
Append a string to this token.
bool Undef(const char *iMacroName, size_t iMacroNameLen)
Undefine a macro.
Token * Args
The names of the arguments.
void * ErrorData
User-specific storage, passed to Error()