Shared parsing functions. More...

#include "parse.h"
#include "defines.h"
#include "ufotypes.h"

Include dependency graph for parse.cpp:

Functions
void	Com_UnParseLastToken (void)
	Put back the last token into the parser The next call of Com_Parse will return the same token again.
const char *	Com_GetToken (const char **data_p)
	Get the current token value.
Com_TokenType_t	Com_GetType (const char **data_p)
	Get the current token type.
Com_TokenType_t	Com_NextToken (const char **data_p)
	Compute the next token.
int	Com_CountTokensInBuffer (const char *buffer)
	Counts the tokens in the given buffer that the Com_Parse function would extract.
const char *	Com_Parse (const char data_p[], char target, size_t size, bool replaceWhitespaces)
	Parse a token out of a string.
void	Com_SkipBlock (const char **text)
	Skips a block of {} in our script files.
int	Com_GetBlock (const char text, const char start)
	Get the start and end point of a block in the given text.

Variables
static char	com_token [4096]
static bool	isUnparsedToken
static Com_TokenType_t	type

Detailed Description

Shared parsing functions.

Definition in file parse.cpp.

Function Documentation

◆ Com_CountTokensInBuffer()

int Com_CountTokensInBuffer ( const char * buffer )

Counts the tokens in the given buffer that the Com_Parse function would extract.

Parameters

[in] buffer The buffer to count the tokens in

Returns: The amount of tokens in the given buffer

Definition at line 80 of file parse.cpp.

References Com_Parse().

Referenced by R_ModLoadAnims().

◆ Com_GetBlock()

int Com_GetBlock	(	const char **	text,
		const char **	start )

Get the start and end point of a block in the given text.

Parameters

[in,out]	text	The text pointer to get the start and end for. The pointer is set to the end of the block in this function.
[out]	start	The pointer to the beginning of the block

Returns: The amount of characters in the block, or -1 if the text does not start with the script block character '{'

Definition at line 272 of file parse.cpp.

References Com_Parse(), and Com_SkipBlock().

Referenced by ParseUMP(), SV_ParseUMP(), and TEST_F().

◆ Com_GetToken()

const char * Com_GetToken ( const char ** data_p )

Get the current token value.

Returns: The current token value

Definition at line 51 of file parse.cpp.

References com_token.

Referenced by Com_ParseList().

◆ Com_GetType()

Com_TokenType_t Com_GetType ( const char ** data_p )

Get the current token type.

Returns: The current token type

Definition at line 60 of file parse.cpp.

References type.

Referenced by TEST_F(), TEST_F(), TEST_F(), TEST_F(), UI_ParseNode(), UI_ParseProperty(), UI_ParseValueExpression(), and UI_ParseWindow().

◆ Com_NextToken()

Com_TokenType_t Com_NextToken ( const char ** data_p )

Compute the next token.

Returns: Type of the next token

Definition at line 69 of file parse.cpp.

References Com_Parse(), and type.

Referenced by Com_ParseList().

◆ Com_Parse()

const char * Com_Parse	(	const char *	data_p[],
		char *	target,
		size_t	size,
		bool	replaceWhitespaces )

Parse a token out of a string.

Parameters

data_p	Pointer to a string which is to be parsed
target	A place to put the parsed data. If 0, an internal buffer of 4096 is used.
size	The length of target buffer, if any
replaceWhitespaces	Replace "\\t" and "\\n" to "\t" and "\n"

Precondition: data_p is expected to be null-terminated

Returns: The string result of parsing in a string.

Note: if used to parse a quoted string that needs further parsing the returned string must be copied first, as Com_Parse returns a pointer to a static buffer that it holds. this will be re-used on the next call.