223 lines
7.6 KiB
PHP
223 lines
7.6 KiB
PHP
/**
|
|
* vim: set ts=4 :
|
|
* =============================================================================
|
|
* SourceMod (C)2004-2008 AlliedModders LLC. All rights reserved.
|
|
* =============================================================================
|
|
*
|
|
* This file is part of the SourceMod/SourcePawn SDK.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it under
|
|
* the terms of the GNU General Public License, version 3.0, as published by the
|
|
* Free Software Foundation.
|
|
*
|
|
* 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, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* As a special exception, AlliedModders LLC gives you permission to link the
|
|
* code of this program (as well as its derivative works) to "Half-Life 2," the
|
|
* "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
|
|
* by the Valve Corporation. You must obey the GNU General Public License in
|
|
* all respects for all other code used. Additionally, AlliedModders LLC grants
|
|
* this exception to all derivative works. AlliedModders LLC defines further
|
|
* exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
|
|
* or <http://www.sourcemod.net/license.php>.
|
|
*
|
|
* Version: $Id$
|
|
*/
|
|
|
|
#if defined _textparse_included
|
|
#endinput
|
|
#endif
|
|
#define _textparse_included
|
|
|
|
|
|
/**
|
|
* Everything below describes the SMC Parse, or "SourceMod Configuration" format.
|
|
* This parser is entirely event based. You must hook events to receive data.
|
|
* The file format itself is nearly identical to Valve's KeyValues format.
|
|
*/
|
|
|
|
/**
|
|
* Parse result directive.
|
|
*/
|
|
enum SMCResult
|
|
{
|
|
SMCParse_Continue, /**< Continue parsing */
|
|
SMCParse_Halt, /**< Stop parsing here */
|
|
SMCParse_HaltFail /**< Stop parsing and return failure */
|
|
};
|
|
|
|
/**
|
|
* Parse error codes.
|
|
*/
|
|
enum SMCError
|
|
{
|
|
SMCError_Okay = 0, /**< No error */
|
|
SMCError_StreamOpen, /**< Stream failed to open */
|
|
SMCError_StreamError, /**< The stream died... somehow */
|
|
SMCError_Custom, /**< A custom handler threw an error */
|
|
SMCError_InvalidSection1, /**< A section was declared without quotes, and had extra tokens */
|
|
SMCError_InvalidSection2, /**< A section was declared without any header */
|
|
SMCError_InvalidSection3, /**< A section ending was declared with too many unknown tokens */
|
|
SMCError_InvalidSection4, /**< A section ending has no matching beginning */
|
|
SMCError_InvalidSection5, /**< A section beginning has no matching ending */
|
|
SMCError_InvalidTokens, /**< There were too many unidentifiable strings on one line */
|
|
SMCError_TokenOverflow, /**< The token buffer overflowed */
|
|
SMCError_InvalidProperty1, /**< A property was declared outside of any section */
|
|
};
|
|
|
|
enum TextParser
|
|
{
|
|
Invalid_TextPaser = 0
|
|
};
|
|
|
|
/**
|
|
* Creates a new SMC file format parser.
|
|
* This is used to set parse hooks.
|
|
*
|
|
* @return A new Handle to an SMC Parse structure.
|
|
*/
|
|
native TextParser:SMC_CreateParser();
|
|
|
|
/**
|
|
* Parses an SMC file.
|
|
*
|
|
* @param smc A Handle to an SMC Parse structure.
|
|
* @param file A string containing the file path.
|
|
* @param line An optional by reference cell to store the last line number read.
|
|
* @param col An optional by reference cell to store the last column number read.
|
|
|
|
* @return An SMCParseError result.
|
|
* @error Invalid or corrupt Handle.
|
|
*/
|
|
native SMCError:SMC_ParseFile(TextParser:smc, const file[], &line = 0, &col = 0);
|
|
|
|
/**
|
|
* Gets an error string for an SMCError code.
|
|
*
|
|
* @note SMCError_Okay returns false.
|
|
* @note SMCError_Custom (which is thrown on SMCParse_HaltFail) returns false.
|
|
*
|
|
* @param error The SMCParseError code.
|
|
* @param buffer A string buffer for the error (contents undefined on failure).
|
|
* @param buf_max The maximum size of the buffer.
|
|
*
|
|
* @return True on success, false otherwise.
|
|
*/
|
|
native bool:SMC_GetErrorString(SMCError:error, buffer[], buf_max);
|
|
|
|
/**
|
|
* Sets the SMC_ParseStart function of a parse Handle.
|
|
* Below is the prototype of callback.:
|
|
*
|
|
* - ParseStart:
|
|
* Called when parsing is started.
|
|
*
|
|
* @param smc The SMC Parse Handle.
|
|
* @noreturn
|
|
*
|
|
* public SMC_ParseStart(TextParser:smc)
|
|
*
|
|
* @param smc Handle to an SMC Parse.
|
|
* @param func A ParseStart callback.
|
|
*
|
|
* @noreturn
|
|
* @error Invalid or corrupt Handle.
|
|
*/
|
|
native SMC_SetParseStart(TextParser:smc, const func[]);
|
|
|
|
/**
|
|
* Sets the SMC_ParseEnd of a parse handle.
|
|
* Below is the prototype of callback.:
|
|
*
|
|
* - ParseEnd:
|
|
* Called when parsing is halted.
|
|
*
|
|
* @param smc The SMC Parse Handle.
|
|
* @param halted True if abnormally halted, false otherwise.
|
|
* @param failed True if parsing failed, false otherwise.
|
|
* @noreturn
|
|
*
|
|
* public SMC_ParseEnd(TextParser:smc, bool:halted, bool:failed)
|
|
*
|
|
* @param smc Handle to an SMC Parse.
|
|
* @param func A ParseEnd callback..
|
|
*
|
|
* @noreturn
|
|
* @error Invalid or corrupt Handle.
|
|
*/
|
|
native SMC_SetParseEnd(TextParser:smc, const func[]);
|
|
|
|
/**
|
|
* Sets the three main reader functions.
|
|
* Below are the different prototypes of callbacks:
|
|
*
|
|
* - NewSection:
|
|
* Called when the parser finds the end of the current section.
|
|
* @note Enclosing quotes are always stripped.
|
|
*
|
|
* @param smc The SMC Parse Handle.
|
|
* @param name String containing section name.
|
|
* @return An SMCResult action to take.
|
|
*
|
|
* public SMCResult:SMC_NewSection(TextParser:smc, const name[])
|
|
*
|
|
* - KeyValue:
|
|
* Called when the parser finds a new key/value pair.
|
|
* @note Enclosing quotes are always stripped.
|
|
*
|
|
* @param smc The SMC Parse Handle.
|
|
* @param key String containing key name.
|
|
* @param value String containing value name.
|
|
* @return An SMCResult action to take.
|
|
*
|
|
* public SMCResult:SMC_KeyValue(TextParser:smc, const key[], const value[])
|
|
*
|
|
* - EndSection:
|
|
* Called when the parser finds the end of the current section.
|
|
*
|
|
* @param smc The SMC Parse Handle.
|
|
*
|
|
* public SMCResult:SMC_EndSection(TextParser:smc)
|
|
* -
|
|
* @param smc An SMC parse Handle.
|
|
* @param ns A NewSection callback.
|
|
* @param kv A KeyValue callback.
|
|
* @param es An EndSection callback.
|
|
*
|
|
* @noreturn
|
|
*/
|
|
native SMC_SetReaders(TextParser:smc, const nsFunc[], const kvFunc[], const esFunc[]);
|
|
|
|
/**
|
|
* Sets a raw line reader on an SMC parser Handle.
|
|
* Below is the prototype of callback.:
|
|
*
|
|
* - RawLine:
|
|
* Called whenever a raw line is read.
|
|
*
|
|
* @param smc The SMC Parse Handle.
|
|
* @param line A string containing the raw line from the file.
|
|
* @param lineno The line number it occurs on.
|
|
* @return An SMCResult action to take.
|
|
*
|
|
* public SMCResult:SMC_RawLine(TextParser:smc, const line[], lineno)
|
|
*
|
|
* @param smc Handle to an SMC Parse.
|
|
* @param func A RawLine callback..
|
|
* @noreturn
|
|
*/
|
|
native SMC_SetRawLine(TextParser:smc, const func[]);
|
|
|
|
/**
|
|
* Disposes of a text parser.
|
|
*
|
|
* @param smc Handle to an SMC Parse.
|
|
* @return True if disposed, false otherwise.
|
|
*/
|
|
native SMC_DestroyParser(&TextParser:smc); |