mirror of
https://github.com/dhewm/dhewm3-sdk.git
synced 2024-11-25 14:01:10 +00:00
a9a6042a04
Apart from some minor stuff, this changes the signature of some methods of Parser and Token classes and of the (unused) Random2 class. That no problem though, because the calling code uses normal ints anyway.
286 lines
11 KiB
C++
286 lines
11 KiB
C++
/*
|
|
===========================================================================
|
|
|
|
Doom 3 GPL Source Code
|
|
Copyright (C) 1999-2011 id Software LLC, a ZeniMax Media company.
|
|
|
|
This file is part of the Doom 3 GPL Source Code ("Doom 3 Source Code").
|
|
|
|
Doom 3 Source Code is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
Doom 3 Source Code is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with Doom 3 Source Code. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
In addition, the Doom 3 Source Code is also subject to certain additional terms. You should have received a copy of these additional terms immediately following the terms and conditions of the GNU General Public License which accompanied the Doom 3 Source Code. If not, please request a copy in writing from id Software at the address below.
|
|
|
|
If you have questions concerning this license or the applicable additional terms, you may contact in writing id Software LLC, c/o ZeniMax Media Inc., Suite 120, Rockville, Maryland 20850 USA.
|
|
|
|
===========================================================================
|
|
*/
|
|
|
|
#ifndef __PARSER_H__
|
|
#define __PARSER_H__
|
|
|
|
#include "idlib/Token.h"
|
|
#include "idlib/Lexer.h"
|
|
|
|
/*
|
|
===============================================================================
|
|
|
|
C/C++ compatible pre-compiler
|
|
|
|
===============================================================================
|
|
*/
|
|
|
|
#define DEFINE_FIXED 0x0001
|
|
|
|
#define BUILTIN_LINE 1
|
|
#define BUILTIN_FILE 2
|
|
#define BUILTIN_DATE 3
|
|
#define BUILTIN_TIME 4
|
|
#define BUILTIN_STDC 5
|
|
|
|
#define INDENT_IF 0x0001
|
|
#define INDENT_ELSE 0x0002
|
|
#define INDENT_ELIF 0x0004
|
|
#define INDENT_IFDEF 0x0008
|
|
#define INDENT_IFNDEF 0x0010
|
|
|
|
// macro definitions
|
|
typedef struct define_s {
|
|
char * name; // define name
|
|
int flags; // define flags
|
|
int builtin; // > 0 if builtin define
|
|
int numparms; // number of define parameters
|
|
idToken * parms; // define parameters
|
|
idToken * tokens; // macro tokens (possibly containing parm tokens)
|
|
struct define_s *next; // next defined macro in a list
|
|
struct define_s *hashnext; // next define in the hash chain
|
|
} define_t;
|
|
|
|
// indents used for conditional compilation directives:
|
|
// #if, #else, #elif, #ifdef, #ifndef
|
|
typedef struct indent_s {
|
|
int type; // indent type
|
|
int skip; // true if skipping current indent
|
|
idLexer * script; // script the indent was in
|
|
struct indent_s *next; // next indent on the indent stack
|
|
} indent_t;
|
|
|
|
|
|
class idParser {
|
|
|
|
public:
|
|
// constructor
|
|
idParser();
|
|
idParser( int flags );
|
|
idParser( const char *filename, int flags = 0, bool OSPath = false );
|
|
idParser( const char *ptr, int length, const char *name, int flags = 0 );
|
|
// destructor
|
|
~idParser();
|
|
// load a source file
|
|
int LoadFile( const char *filename, bool OSPath = false );
|
|
// load a source from the given memory with the given length
|
|
// NOTE: the ptr is expected to point at a valid C string: ptr[length] == '\0'
|
|
int LoadMemory( const char *ptr, int length, const char *name );
|
|
// free the current source
|
|
void FreeSource( bool keepDefines = false );
|
|
// returns true if a source is loaded
|
|
int IsLoaded( void ) const { return idParser::loaded; }
|
|
// read a token from the source
|
|
int ReadToken( idToken *token );
|
|
// expect a certain token, reads the token when available
|
|
int ExpectTokenString( const char *string );
|
|
// expect a certain token type
|
|
int ExpectTokenType( int type, int subtype, idToken *token );
|
|
// expect a token
|
|
int ExpectAnyToken( idToken *token );
|
|
// returns true if the next token equals the given string and removes the token from the source
|
|
int CheckTokenString( const char *string );
|
|
// returns true if the next token equals the given type and removes the token from the source
|
|
int CheckTokenType( int type, int subtype, idToken *token );
|
|
// returns true if the next token equals the given string but does not remove the token from the source
|
|
int PeekTokenString( const char *string );
|
|
// returns true if the next token equals the given type but does not remove the token from the source
|
|
int PeekTokenType( int type, int subtype, idToken *token );
|
|
// skip tokens until the given token string is read
|
|
int SkipUntilString( const char *string );
|
|
// skip the rest of the current line
|
|
int SkipRestOfLine( void );
|
|
// skip the braced section
|
|
int SkipBracedSection( bool parseFirstBrace = true );
|
|
// parse a braced section into a string
|
|
const char * ParseBracedSection( idStr &out, int tabs = -1 );
|
|
// parse a braced section into a string, maintaining indents and newlines
|
|
const char * ParseBracedSectionExact( idStr &out, int tabs = -1 );
|
|
// parse the rest of the line
|
|
const char * ParseRestOfLine( idStr &out );
|
|
// unread the given token
|
|
void UnreadToken( idToken *token );
|
|
// read a token only if on the current line
|
|
int ReadTokenOnLine( idToken *token );
|
|
// read a signed integer
|
|
int ParseInt( void );
|
|
// read a boolean
|
|
bool ParseBool( void );
|
|
// read a floating point number
|
|
float ParseFloat( void );
|
|
// parse matrices with floats
|
|
int Parse1DMatrix( int x, float *m );
|
|
int Parse2DMatrix( int y, int x, float *m );
|
|
int Parse3DMatrix( int z, int y, int x, float *m );
|
|
// get the white space before the last read token
|
|
int GetLastWhiteSpace( idStr &whiteSpace ) const;
|
|
// Set a marker in the source file (there is only one marker)
|
|
void SetMarker( void );
|
|
// Get the string from the marker to the current position
|
|
void GetStringFromMarker( idStr& out, bool clean = false );
|
|
// add a define to the source
|
|
int AddDefine( const char *string );
|
|
// add builtin defines
|
|
void AddBuiltinDefines( void );
|
|
// set the source include path
|
|
void SetIncludePath( const char *path );
|
|
// set the punctuation set
|
|
void SetPunctuations( const punctuation_t *p );
|
|
// returns a pointer to the punctuation with the given id
|
|
const char * GetPunctuationFromId( int id );
|
|
// get the id for the given punctuation
|
|
int GetPunctuationId( const char *p );
|
|
// set lexer flags
|
|
void SetFlags( int flags );
|
|
// get lexer flags
|
|
int GetFlags( void ) const;
|
|
// returns the current filename
|
|
const char * GetFileName( void ) const;
|
|
// get current offset in current script
|
|
const int GetFileOffset( void ) const;
|
|
// get file time for current script
|
|
const ID_TIME_T GetFileTime( void ) const;
|
|
// returns the current line number
|
|
const int GetLineNum( void ) const;
|
|
// print an error message
|
|
void Error( const char *str, ... ) const id_attribute((format(printf,2,3)));
|
|
// print a warning message
|
|
void Warning( const char *str, ... ) const id_attribute((format(printf,2,3)));
|
|
|
|
// add a global define that will be added to all opened sources
|
|
static int AddGlobalDefine( const char *string );
|
|
// remove the given global define
|
|
static int RemoveGlobalDefine( const char *name );
|
|
// remove all global defines
|
|
static void RemoveAllGlobalDefines( void );
|
|
// set the base folder to load files from
|
|
static void SetBaseFolder( const char *path );
|
|
|
|
private:
|
|
int loaded; // set when a source file is loaded from file or memory
|
|
idStr filename; // file name of the script
|
|
idStr includepath; // path to include files
|
|
bool OSPath; // true if the file was loaded from an OS path
|
|
const punctuation_t *punctuations; // punctuations to use
|
|
int flags; // flags used for script parsing
|
|
idLexer * scriptstack; // stack with scripts of the source
|
|
idToken * tokens; // tokens to read first
|
|
define_t * defines; // list with macro definitions
|
|
define_t ** definehash; // hash chain with defines
|
|
indent_t * indentstack; // stack with indents
|
|
int skip; // > 0 if skipping conditional code
|
|
const char* marker_p;
|
|
|
|
static define_t *globaldefines; // list with global defines added to every source loaded
|
|
|
|
private:
|
|
void PushIndent( int type, int skip );
|
|
void PopIndent( int *type, int *skip );
|
|
void PushScript( idLexer *script );
|
|
int ReadSourceToken( idToken *token );
|
|
int ReadLine( idToken *token );
|
|
int UnreadSourceToken( idToken *token );
|
|
int ReadDefineParms( define_t *define, idToken **parms, int maxparms );
|
|
int StringizeTokens( idToken *tokens, idToken *token );
|
|
int MergeTokens( idToken *t1, idToken *t2 );
|
|
int ExpandBuiltinDefine( idToken *deftoken, define_t *define, idToken **firsttoken, idToken **lasttoken );
|
|
int ExpandDefine( idToken *deftoken, define_t *define, idToken **firsttoken, idToken **lasttoken );
|
|
int ExpandDefineIntoSource( idToken *deftoken, define_t *define );
|
|
void AddGlobalDefinesToSource( void );
|
|
define_t * CopyDefine( define_t *define );
|
|
define_t * FindHashedDefine(define_t **definehash, const char *name);
|
|
int FindDefineParm( define_t *define, const char *name );
|
|
void AddDefineToHash(define_t *define, define_t **definehash);
|
|
static void PrintDefine( define_t *define );
|
|
static void FreeDefine( define_t *define );
|
|
static define_t *FindDefine( define_t *defines, const char *name );
|
|
static define_t *DefineFromString( const char *string);
|
|
define_t * CopyFirstDefine( void );
|
|
int Directive_include( void );
|
|
int Directive_undef( void );
|
|
int Directive_if_def( int type );
|
|
int Directive_ifdef( void );
|
|
int Directive_ifndef( void );
|
|
int Directive_else( void );
|
|
int Directive_endif( void );
|
|
int EvaluateTokens( idToken *tokens, int *intvalue, double *floatvalue, int integer );
|
|
int Evaluate( int *intvalue, double *floatvalue, int integer );
|
|
int DollarEvaluate( int *intvalue, double *floatvalue, int integer);
|
|
int Directive_define( void );
|
|
int Directive_elif( void );
|
|
int Directive_if( void );
|
|
int Directive_line( void );
|
|
int Directive_error( void );
|
|
int Directive_warning( void );
|
|
int Directive_pragma( void );
|
|
void UnreadSignToken( void );
|
|
int Directive_eval( void );
|
|
int Directive_evalfloat( void );
|
|
int ReadDirective( void );
|
|
int DollarDirective_evalint( void );
|
|
int DollarDirective_evalfloat( void );
|
|
int ReadDollarDirective( void );
|
|
};
|
|
|
|
ID_INLINE const char *idParser::GetFileName( void ) const {
|
|
if ( idParser::scriptstack ) {
|
|
return idParser::scriptstack->GetFileName();
|
|
}
|
|
else {
|
|
return "";
|
|
}
|
|
}
|
|
|
|
ID_INLINE const int idParser::GetFileOffset( void ) const {
|
|
if ( idParser::scriptstack ) {
|
|
return idParser::scriptstack->GetFileOffset();
|
|
}
|
|
else {
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
ID_INLINE const ID_TIME_T idParser::GetFileTime( void ) const {
|
|
if ( idParser::scriptstack ) {
|
|
return idParser::scriptstack->GetFileTime();
|
|
}
|
|
else {
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
ID_INLINE const int idParser::GetLineNum( void ) const {
|
|
if ( idParser::scriptstack ) {
|
|
return idParser::scriptstack->GetLineNum();
|
|
}
|
|
else {
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
#endif /* !__PARSER_H__ */
|