/*  $Header: /dist/CVS/fzclips/src/msgfun.h,v 1.3 2001/08/11 21:06:59 dave Exp $  */

   /*******************************************************/
   /*      "C" Language Integrated Production System      */
   /*                                                     */
   /*               CLIPS Version 6.05  04/09/97          */
   /*                                                     */
   /*                                                     */
   /*******************************************************/

/*************************************************************/
/* Purpose: Message-passing support functions                */
/*                                                           */
/* Principal Programmer(s):                                  */
/*      Brian L. Donnell                                     */
/*                                                           */
/* Contributing Programmer(s):                               */
/*                                                           */
/* Revision History:                                         */
/*                                                           */
/*************************************************************/

#ifndef _H_msgfun
#define _H_msgfun

typedef struct handlerSlotReference
  {
   unsigned short classID;
   unsigned slotID;
  } HANDLER_SLOT_REFERENCE;

#ifndef _H_object
#include "object.h"
#endif
#include "msgpass.h"

#define BEGIN_TRACE ">>"
#define END_TRACE   "<<"

/* =================================================================================
   Message-handler types - don't change these values: a string array depends on them
   ================================================================================= */
#define MAROUND        0
#define MBEFORE        1
#define MPRIMARY       2
#define MAFTER         3
#define MERROR         4

#define LOOKUP_HANDLER_INDEX   0
#define LOOKUP_HANDLER_ADDRESS 1

#ifdef LOCALE
#undef LOCALE
#endif

#ifdef _MSGFUN_SOURCE_
#define LOCALE
#else
#define LOCALE extern
#endif

LOCALE void UnboundHandlerErr(void);
LOCALE void PrintNoHandlerError(char *);
LOCALE int CheckHandlerArgCount(void);
LOCALE void SlotAccessViolationError(char *,BOOLEAN,void *);
LOCALE void SlotVisibilityViolationError(SLOT_DESC *,DEFCLASS *);

#if ! RUN_TIME
LOCALE void NewSystemHandler(char *,char *,char *,int);
LOCALE HANDLER *InsertHandlerHeader(DEFCLASS *,SYMBOL_HN *,int);
#endif

#if (! BLOAD_ONLY) && (! RUN_TIME)
LOCALE HANDLER *NewHandler(void);
LOCALE int HandlersExecuting(DEFCLASS *);
LOCALE int DeleteHandler(DEFCLASS *,SYMBOL_HN *,int,int);
LOCALE void DeallocateMarkedHandlers(DEFCLASS *);
#endif
LOCALE int HandlerType(char *,char *);
LOCALE int CheckCurrentMessage(char *,int);
LOCALE void PrintHandler(char *,HANDLER *,int);
LOCALE HANDLER *FindHandlerByAddress(DEFCLASS *,SYMBOL_HN *,unsigned);
LOCALE int FindHandlerByIndex(DEFCLASS *,SYMBOL_HN *,unsigned);
LOCALE int FindHandlerNameGroup(DEFCLASS *,SYMBOL_HN *);
LOCALE void HandlerDeleteError(char *);

#if DEBUGGING_FUNCTIONS
LOCALE void DisplayCore(char *,HANDLER_LINK *,int);
LOCALE HANDLER_LINK *FindPreviewApplicableHandlers(DEFCLASS *,SYMBOL_HN *);
LOCALE void WatchMessage(char *,char *);
LOCALE void WatchHandler(char *,HANDLER_LINK *,char *);
#endif


#ifndef _MSGFUN_SOURCE_
extern SYMBOL_HN *INIT_SYMBOL,*DELETE_SYMBOL;
extern char *hndquals[];

#if DEBUGGING_FUNCTIONS
extern int WatchHandlers,WatchMessages;
#endif
#endif

#endif







