1
0
Fork 0
mirror of git://git.psyc.eu/libpsyc synced 2024-08-15 03:19:02 +00:00
libpsyc/src/psyc_parser_cb.h
2011-04-25 23:40:38 +02:00

154 lines
4.9 KiB
C

#include <stdint.h>
struct psycParser;
/** @brief initialize a pstate struct
*
* @param pstate pointer to an allocated
* psycParser struct.
*/
void psyc_initState(struct psycParser* pstate);
/** @brief parses a packet
*
* This function parses rawdata
* and uses the callbacks in psycParser
* to communicate with the caller.
*
* First the header will be parsed,
* after that the stateCallback
* (with inEntity set to false)
* will be called for each variable.
* Then, routingCallback will be called
* to find out if further parsing
* is desired.
* If it returns false, psyc_parse returns.
* If it returns true, parsing continues
* to the body.
* After the entitystate has been parsed,
* stateCallback will be called for each
* variable, having inEntity set to true.
* Finally, bodyCallback will be called,
* containing the method, and its data.
*
* In case of an parsing error <to continue>
*
* @param data constant pointer to the
* raw data that is to be processed.
* @param length the amount of bytes to parse
* @param pstate pointer to a preallocated
* and initialized (psyc_initState)
* instance of the struct state
*
*/
void psyc_parse(const uint8_t* data, unsigned int length,
struct psycParser* pstate);
/** @brief FlagMod */
enum psycOperator
{
// modifier operators
ASSIGN = 0x02,
AUGMENT = 0x04,
DIMINISH = 0x08,
SET = 0x10,
QUERY = 0x20,
};
struct psycParser
{
/** @brief Callback for the states
*
* This callback will be called to inform
* the caller about the states.
*
* It will be called once for each variable.
*
* @param pstate pointer to the ParserState
* struct for identification
* @param name not null terminated c-string,
* containing the name of the variable
* @param nlength the length of the variable name
* @param value not null terminated c-string,
* containing the value of the variable
* @param vlength the length of the variable value
* @param modifers modifer of the variable (see Modifer)
* @param inEntity wether this variable is an entity
* variable(true) or a routing variable(false) */
void (*stateCallback)(struct psycParser* pstate,
const uint8_t *name, const unsigned int nlength,
const uint8_t *value, const unsigned int vlength,
enum psycOperator oper, char inEntity);
/** @brief gets called after the routing-header was parsed
*
* @return if 0, parser will continue to parse
* the content part and calls bodyCallback
* when finished,
* if not 0, parser will stop parsing and
* calls contentCallback */
char (*routingCallback)(struct psycParser* pstate);
/** @brief Body callback, gets called when the body was parsed
*
* @param pstate pointer to the ParserState struct
* for identificiation
* @param method not null terminated c-string,
* containing the method name
* @param mlength the length of the methodname
* @param dlength the length of the data
* @param data not null terminated c-string,
* containing the data section
* @param content not null terminated c-string
* @param clength length of the content string */
void (*bodyCallback)(struct psycParser* pstate,
const uint8_t* method, unsigned int mlength,
const uint8_t* data, unsigned int dlength,
const uint8_t* content, unsigned int clength);
/** @brief Error callback, gets called to indicate
* an error and the start of an error packet
*
* If there was an error while parsing the rawdata,
* instead of passing the packets data to the callbacks,
* an error packet will be passed back, describing the
* the error in more detail.
*
* On error, errorCallback will be called
* to report the errortype (in the method),
* after that errorStateCallback will be
* called to inform about more detailed facts
* of the error.
*
* Any previous state or body callbacks become
* invalid and have to be purged.*/
void (*errorCallback)(struct psycParser* pstate,
const uint8_t *method, unsigned int mlength);
/** @brief error state callback
*
* The parameters are the same as for stateCallback.
* The callback will be called once for each
* state variable in the error report packet
*/
void (*errorStateCallback)(struct psycParser* pstate,
const uint8_t *name, const unsigned int nlength,
const uint8_t *value, const unsigned int vlength,
enum psycOperator oper);
/*******************************************
* The following variables and datatypes *
* are being used to remember the *
* internal state. You should not *
* touch them. *
*******************************************/
uint8_t glyph;
unsigned int contpos; // position inside the content
unsigned int mstart,mlength, // position and length of the method
dstart,dlength; //
};