mirror of
https://git.code.sf.net/p/quake/quakeforge
synced 2025-06-03 18:10:59 +00:00
7314ebde0c
Both came about while working on KSP modding and eventually found there way into script.py in qfmap. This gets the changes into the C implementation.
116 lines
3.9 KiB
C
116 lines
3.9 KiB
C
/*
|
|
Copyright (C) 1996-1997 Id Software, Inc.
|
|
|
|
This program 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 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program 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 this program; if not, write to the Free Software
|
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
See file, 'COPYING', for details.
|
|
*/
|
|
#ifndef __QF_script_h
|
|
#define __QF_script_h
|
|
|
|
/** \defgroup script Scripts
|
|
\ingroup utils
|
|
Line oriented script parsing. Multiple scripts being parsed at the same
|
|
time is supported.
|
|
*/
|
|
///@{
|
|
|
|
#include "QF/qtypes.h"
|
|
|
|
typedef struct script_s {
|
|
/// The current (or next when unget is true) token
|
|
struct dstring_s *token;
|
|
/// True if the last token has been pushed back.
|
|
bool unget;
|
|
/// current position within the script
|
|
const char *p;
|
|
/// name of the file being processed. used only for error reporting
|
|
const char *file;
|
|
/// line number of the file being processed. used only for error reporting
|
|
/// but updated internally.
|
|
int line;
|
|
/// contains last error message or null if no error
|
|
/// if set, no tokens will be parsed.
|
|
const char *error;
|
|
/// if true, multi line quoted tokens will be treated as errors
|
|
bool no_quote_lines;
|
|
/// if true, quotes do not delimit strips
|
|
bool no_quotes;
|
|
/// if set, characters in this string will always be lexed as single
|
|
/// character tokens. If not set, defaults to "{}()':". Set to ""
|
|
/// (empty string) to disable. Not set by default.
|
|
const char *single;
|
|
} script_t;
|
|
|
|
/** Return a new script_t object.
|
|
\return A new, blank, script object. Use Script_Start() to initialize.
|
|
*/
|
|
script_t *Script_New (void);
|
|
|
|
/** Delete a script_t object.
|
|
\param script The script_t object to be deleted
|
|
Does not free the memory passed to Script_Start().
|
|
*/
|
|
void Script_Delete (script_t *script);
|
|
|
|
/** Prepare a script_t object for parsing.
|
|
The caller is responsible for freeing the memory associated with file and
|
|
data when parsing is complete.
|
|
Resets \a script->error
|
|
\param script The script_t object being parsed
|
|
\param file Name of the file being parsed. used only for error reporting
|
|
\param data The script to be parsed
|
|
*/
|
|
void Script_Start (script_t *script, const char *file, const char *data);
|
|
|
|
/** Check if a new token is available.
|
|
\param script The script_t object being parsed
|
|
\param crossline True to allow passing \n
|
|
\return True if a token is available, false if end of file
|
|
or end of line (if crossline is false) has been hit
|
|
*/
|
|
bool Script_TokenAvailable (script_t *script, bool crossline);
|
|
|
|
/** Get the next token. Generates an error and exits the program if no token
|
|
is available and crossline is false.
|
|
\param script The script_t object being parsed
|
|
\param crossline True to allow passing \n
|
|
\return True on success, false on failure (no token available)
|
|
*/
|
|
bool Script_GetToken (script_t *script, bool crossline);
|
|
|
|
/** Get the remainder of the current line as a token
|
|
|
|
Parses the rest of the line (minus // style comments) as the token.
|
|
Trailing whitespace is not stripped.
|
|
If a token has been pushed back, it will be included in the new token.
|
|
\param script The script_t object being parsed
|
|
\return true if there is more to parse (EOF not hit)
|
|
*/
|
|
bool Script_GetLine (script_t *script);
|
|
|
|
/** Unget the current token. Only one level of unget is supported.
|
|
\param script The script_t object being parsed
|
|
*/
|
|
void Script_UngetToken (script_t *script);
|
|
|
|
/** Return a pointer to the current token.
|
|
\param script The script_t object being parsed
|
|
*/
|
|
const char *Script_Token (script_t *script) __attribute__((pure));
|
|
|
|
///@}
|
|
|
|
#endif//__QF_script_h
|