server/src/util/message.h

/* vi: set ts=2:
 +-------------------+  Christian Schlittchen <corwin@amber.kn-bremen.de>
 |                   |  Enno Rehling <enno@eressea.de>
 | Eressea PBEM host |  Katja Zedel <katze@felidae.kn-bremen.de>
 | (c) 1998 - 2003   |  Henning Peters <faroul@beyond.kn-bremen.de>
 |                   |  Ingo Wilken <Ingo.Wilken@informatik.uni-oldenburg.de>
 +-------------------+  Stefan Reich <reich@halbling.de>

 This program may not be used, modified or distributed 
 without prior permission by the authors of Eressea.
*/
#ifndef UTIL_MESSAGE_H
#define UTIL_MESSAGE_H

#include "variant.h"

#ifdef __cplusplus
extern "C" {
#endif

struct locale;

typedef struct arg_type {
  struct arg_type * next;
  variant_type vtype;
  const char * name;
  void  (*release)(variant);
  variant (*copy)(variant);
} arg_type;

typedef struct message_type {
  unsigned int key;
	const char * name;
	int nparameters;
	const char ** pnames;
	const struct arg_type ** types;
} message_type;

typedef struct message {
	const struct message_type * type;
	variant * parameters;
	int refcount;
} message;

extern struct message_type * mt_new(const char * name, const char ** args);
extern struct message_type * mt_new_va(const char * name, ...);
	/* mt_new("simple_sentence", "subject:string", "predicate:string", 
    *        "object:string", "lang:locale", NULL); */

extern struct message * msg_create(const struct message_type * type, variant args[]);
	/* msg_create(&mt_simplesentence, "enno", "eats", "chocolate", &locale_de); 
	 * parameters must be in the same order as they were for mt_new! */

extern void msg_release(struct message * msg);
extern struct message * msg_addref(struct message * msg);

extern const char * mt_name(const struct message_type* mtype);

/** message_type registry (optional): **/
extern const struct message_type * mt_register(struct message_type *);
extern const struct message_type * mt_find(const char *);

extern void register_argtype(const char * name, void(*free_arg)(variant), variant (*copy_arg)(variant), variant_type);
extern const struct arg_type * find_argtype(const char * name);

extern void (*msg_log_create)(const struct message * msg);

#ifdef __cplusplus
}
#endif
#endif