This is a simplistic C/C++-like preprocessor. More...
#include <OgreGLSLPreprocessor.h>
Classes | |
class | Macro |
A macro definition. More... | |
class | Token |
A input token. More... | |
Public Types | |
typedef void(* | ErrorHandlerFunc )(void *iData, int iLine, const char *iError, const char *iToken, size_t iTokenLen) |
An error handler function type. More... | |
Public Member Functions | |
CPreprocessor () | |
Create an empty preprocessor object. More... | |
virtual | ~CPreprocessor () |
Destroy the preprocessor object. More... | |
void | Define (const char *iMacroName, size_t iMacroNameLen, const char *iMacroValue, size_t iMacroValueLen) |
Define a macro without parameters. More... | |
void | Define (const char *iMacroName, size_t iMacroNameLen, long iMacroValue) |
Define a numerical macro. More... | |
char * | Parse (const char *iSource, size_t iLength, size_t &oLength) |
Parse the input string and return a newly-allocated output string. More... | |
bool | Undef (const char *iMacroName, size_t iMacroNameLen) |
Undefine a macro. More... | |
Public Attributes | |
void * | ErrorData |
User-specific storage, passed to Error() More... | |
Static Public Attributes | |
static ErrorHandlerFunc | ErrorHandler |
A pointer to the preprocessor's error handler. More... | |
Private Member Functions | |
CPreprocessor (const Token &iToken, int iLine) | |
Private constructor to re-parse a single token. More... | |
void | Error (int iLine, const char *iError, const Token *iToken=NULL) |
Call the error handler. More... | |
Token | ExpandMacro (const Token &iToken) |
Expand the given macro, if it exists. More... | |
Token | GetArgument (Token &oArg, bool iExpand) |
Get a single function argument until next ',' or ')'. More... | |
Token | GetArguments (int &oNumArgs, Token *&oArgs, bool iExpand) |
Get all the arguments of a macro: '(' arg1 { ',' arg2 { ',' ... More... | |
Token | GetExpression (Token &oResult, int iLine, int iOpPriority=0) |
Parse an expression, compute it and return the result. More... | |
Token | GetToken (bool iExpand) |
Stateless tokenizer: Parse the input text and return the next token. More... | |
bool | GetValue (const Token &iToken, long &oValue, int iLine) |
Get the numeric value of a token. More... | |
bool | HandleDefine (Token &iBody, int iLine) |
Handle a #define directive. More... | |
Token | HandleDirective (Token &iToken, int iLine) |
Handle a preprocessor directive. More... | |
bool | HandleElse (Token &iBody, int iLine) |
Handle an #else directive. More... | |
bool | HandleEndIf (Token &iBody, int iLine) |
Handle an #endif directive. More... | |
bool | HandleIf (Token &iBody, int iLine) |
Handle an #if directive. More... | |
bool | HandleIfDef (Token &iBody, int iLine) |
Handle an #ifdef directive. More... | |
bool | HandleUnDef (Token &iBody, int iLine) |
Undefine a previously defined macro. More... | |
Macro * | IsDefined (const Token &iToken) |
Check if a macro is defined, and if so, return it. More... | |
Token | Parse (const Token &iSource) |
Parse the input string and return a token containing the whole output. More... | |
Static Private Member Functions | |
static Token | ExpandDefined (CPreprocessor *iParent, int iNumArgs, Token *iArgs) |
The implementation of the defined() preprocessor function. More... | |
Private Attributes | |
bool | BOL |
True if we are at beginning of line. More... | |
unsigned | EnableOutput |
A stack of 32 booleans packed into one value :) More... | |
int | Line |
Current line number. More... | |
Macro * | MacroList |
The list of macros defined so far. More... | |
const char * | Source |
The current source text input. More... | |
const char * | SourceEnd |
The end of the source text. More... | |
Friends | |
class | CPreprocessor::Macro |
This is a simplistic C/C++-like preprocessor.
It takes an non-zero-terminated string on input and outputs a non-zero-terminated string buffer.
This preprocessor was designed specifically for GLSL shaders, so if you want to use it for other purposes you might want to check if the feature set it provides is enough for you.
Here's a list of supported features:
Definition at line 62 of file src/GLSL/include/OgreGLSLPreprocessor.h.
typedef void(* Ogre::GLSL::CPreprocessor::ErrorHandlerFunc)(void *iData, int iLine, const char *iError, const char *iToken, size_t iTokenLen) |
An error handler function type.
The default implementation just drops a note to stderr and then the parser ends, returning NULL.
iData | User-specific pointer from the corresponding CPreprocessor object. |
iLine | The line at which the error happened. |
iError | The error string. |
iToken | If not NULL contains the erroneous token |
iTokenLen | The length of iToken. iToken is never zero-terminated! |
Definition at line 508 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
private |
Private constructor to re-parse a single token.
|
inline |
Create an empty preprocessor object.
Definition at line 427 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
virtual |
Destroy the preprocessor object.
void Ogre::GLSL::CPreprocessor::Define | ( | const char * | iMacroName, |
size_t | iMacroNameLen, | ||
const char * | iMacroValue, | ||
size_t | iMacroValueLen | ||
) |
Define a macro without parameters.
iMacroName | The name of the defined macro |
iMacroNameLen | The length of the name of the defined macro |
iMacroValue | The value of the defined macro |
iMacroValueLen | The length of the value of the defined macro |
void Ogre::GLSL::CPreprocessor::Define | ( | const char * | iMacroName, |
size_t | iMacroNameLen, | ||
long | iMacroValue | ||
) |
Define a numerical macro.
iMacroName | The name of the defined macro |
iMacroNameLen | The length of the name of the defined macro |
iMacroValue | The value of the defined macro |
|
private |
Call the error handler.
iLine | The line at which the error happened. |
iError | The error string. |
iToken | If not NULL contains the erroneous token |
|
staticprivate |
The implementation of the defined() preprocessor function.
iParent | The parent preprocessor object |
iNumArgs | Number of arguments |
iArgs | The arguments themselves |
Expand the given macro, if it exists.
If macro has arguments, they are collected from source stream.
iToken | A KEYWORD token containing the (possible) macro name. |
Get a single function argument until next ',' or ')'.
oArg | The argument is returned in this variable. |
iExpand | If false, parameters are not expanded and no expressions are allowed; only a single keyword is expected per argument. |
|
private |
Get all the arguments of a macro: '(' arg1 { ',' arg2 { ',' ...
}} ')'
oNumArgs | Number of parsed arguments is stored into this variable. |
oArgs | This is set to a pointer to an array of parsed arguments. |
iExpand | If false, parameters are not expanded and no expressions are allowed; only a single keyword is expected per argument. |
|
private |
Parse an expression, compute it and return the result.
oResult | A token containing the result of expression |
iLine | The line at which the expression starts (for error reports) |
iOpPriority | Operator priority (at which operator we will stop if proceeding recursively – used internally. Parser stops when it encounters an operator with higher or equal priority). |
|
private |
Stateless tokenizer: Parse the input text and return the next token.
iExpand | If true, macros will be expanded to their values |
|
private |
Get the numeric value of a token.
If the token was produced by expanding a macro, we will get an TEXT token which can contain a whole expression; in this case we will call GetExpression to parse it. Otherwise we just call the token's GetValue() method.
iToken | The token to get the numeric value of |
oValue | The variable to put the value into |
iLine | The line where the directive begins (for error reports) |
|
private |
Handle a #define directive.
iBody | The body of the directive (everything after the directive until end of line). |
iLine | The line where the directive begins (for error reports) |
Handle a preprocessor directive.
iToken | The whole preprocessor directive line (until EOL) |
iLine | The line where the directive begins (for error reports) |
|
private |
Handle an #else directive.
iBody | The body of the directive (everything after the directive until end of line). |
iLine | The line where the directive begins (for error reports) |
|
private |
Handle an #endif directive.
iBody | The body of the directive (everything after the directive until end of line). |
iLine | The line where the directive begins (for error reports) |
|
private |
Handle an #if directive.
iBody | The body of the directive (everything after the directive until end of line). |
iLine | The line where the directive begins (for error reports) |
|
private |
Handle an #ifdef directive.
iBody | The body of the directive (everything after the directive until end of line). |
iLine | The line where the directive begins (for error reports) |
|
private |
Undefine a previously defined macro.
iBody | The body of the directive (everything after the directive until end of line). |
iLine | The line where the directive begins (for error reports) |
Check if a macro is defined, and if so, return it.
iToken | Macro name |
Parse the input string and return a token containing the whole output.
iSource | The source text enclosed in a token |
char* Ogre::GLSL::CPreprocessor::Parse | ( | const char * | iSource, |
size_t | iLength, | ||
size_t & | oLength | ||
) |
Parse the input string and return a newly-allocated output string.
iSource | The source text |
iLength | The length of the source text in characters |
oLength | The length of the output string. |
bool Ogre::GLSL::CPreprocessor::Undef | ( | const char * | iMacroName, |
size_t | iMacroNameLen | ||
) |
Undefine a macro.
iMacroName | The name of the macro to undefine |
iMacroNameLen | The length of the name of the macro to undefine |
|
friend |
Definition at line 205 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
private |
True if we are at beginning of line.
Definition at line 214 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
private |
A stack of 32 booleans packed into one value :)
Definition at line 216 of file src/GLSL/include/OgreGLSLPreprocessor.h.
void* Ogre::GLSL::CPreprocessor::ErrorData |
User-specific storage, passed to Error()
Definition at line 520 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
static |
A pointer to the preprocessor's error handler.
You can assign the address of your own function to this variable and implement your own error handling (e.g. throwing an exception etc).
Definition at line 517 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
private |
Current line number.
Definition at line 212 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
private |
The list of macros defined so far.
Definition at line 218 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
private |
The current source text input.
Definition at line 208 of file src/GLSL/include/OgreGLSLPreprocessor.h.
|
private |
The end of the source text.
Definition at line 210 of file src/GLSL/include/OgreGLSLPreprocessor.h.