Annotation of libwww/Library/src/HTEvent.c, revision 2.8
2.1 eric 1: /* HTEvntrg.c
2: ** EVENT DISPATCHER
3: **
4: ** (c) COPYRIGHT MIT 1996.
5: ** Please first read the full copyright statement in the file COPYRIGH.
2.8 ! frystyk 6: ** @(#) $Id: HTEvent.c,v 2.7 1998/05/04 19:36:28 frystyk Exp $
2.1 eric 7: **
8: ** The event dispatcher allows applications to register their own event
9: ** models. They may register the standard HTEventrg methods from
10: ** HTEventrg.c, of implement their functionality with their on methods.
11: **
12: ** Authors:
13: ** EGP Eric Gordon Prud'hommeuax
14: ** Bugs
15: **
16: */
17:
18: /* Implementation dependent include files */
2.7 frystyk 19: #include "wwwsys.h"
2.2 frystyk 20: #include "WWWUtil.h"
2.1 eric 21: #include "HTEvent.h" /* Implemented here */
22:
2.2 frystyk 23: PRIVATE HTEvent_registerCallback * RegisterCBF = NULL;
24: PRIVATE HTEvent_unregisterCallback * UnregisterCBF = NULL;
2.1 eric 25:
2.4 frystyk 26: /* ------------------------------------------------------------------------- */
27:
2.1 eric 28: PUBLIC void HTEvent_setRegisterCallback(HTEvent_registerCallback * registerCBF)
29: {
2.2 frystyk 30: if (CORE_TRACE) HTTrace("Event....... registering %p\n", registerCBF);
2.1 eric 31: RegisterCBF = registerCBF;
32: }
33:
34: PUBLIC void HTEvent_setUnregisterCallback(HTEvent_unregisterCallback * unregisterCBF)
35: {
2.2 frystyk 36: if (CORE_TRACE) HTTrace("Event....... registering %p\n", unregisterCBF);
2.1 eric 37: UnregisterCBF = unregisterCBF;
2.8 ! frystyk 38: }
! 39:
! 40: PUBLIC BOOL HTEvent_isCallbacksRegistered (void)
! 41: {
! 42: return (RegisterCBF && UnregisterCBF);
2.1 eric 43: }
44:
2.4 frystyk 45: PUBLIC int HTEvent_unregister (SOCKET s, HTEventType type)
46: {
47: if (!UnregisterCBF) {
48: if (CORE_TRACE) HTTrace("Event....... No handler registered\n");
49: return -1;
50: }
51: return (*UnregisterCBF)(s, type);
52: }
2.1 eric 53:
2.4 frystyk 54: PUBLIC int HTEvent_register(SOCKET s, HTEventType type, HTEvent * event)
2.1 eric 55: {
2.2 frystyk 56: if (!RegisterCBF) {
57: if (CORE_TRACE) HTTrace("Event....... No handler registered\n");
2.1 eric 58: return -1;
2.2 frystyk 59: }
2.4 frystyk 60: return (*RegisterCBF)(s, type, event);
61: }
62:
63: PUBLIC BOOL HTEvent_setCallback(HTEvent * event, HTEventCallback * cbf)
64: {
65: if (!event) return NO;
66: event->cbf = cbf;
67: return YES;
68: }
69:
70: PUBLIC HTEvent * HTEvent_new (HTEventCallback * cbf, void * context,
71: HTPriority priority, int millis)
72: {
73: if (cbf) {
74: HTEvent * me;
75: if ((me = (HTEvent *) HT_CALLOC(1, sizeof(HTEvent))) == NULL)
76: HT_OUTOFMEM("HTEvent_new");
77: me->cbf = cbf;
78: me->param = context;
79: me->priority = priority;
80: me->millis = millis;
2.5 frystyk 81: if (CORE_TRACE)
82: HTTrace("Event....... Created event %p with context %p, priority %d, and timeout %d\n",
83: me, context, priority, millis);
2.4 frystyk 84: return me;
85: }
86: return NULL;
2.1 eric 87: }
88:
2.4 frystyk 89: PUBLIC BOOL HTEvent_delete (HTEvent * me)
2.1 eric 90: {
2.4 frystyk 91: if (me) {
92: HT_FREE(me);
93: if (CORE_TRACE) HTTrace("Event....... Deleted event %p\n", me);
94: return YES;
95: }
96: return NO;
97: }
98:
99: PUBLIC BOOL HTEvent_setParam(HTEvent * event, void * param)
100: {
101: if (!event) return NO;
102: event->param = param;
103: return YES;
104: }
105:
106: PUBLIC BOOL HTEvent_setPriority(HTEvent * event, HTPriority priority)
107: {
108: if (!event) return NO;
109: event->priority = priority;
110: return YES;
111: }
112:
113: PUBLIC BOOL HTEvent_setTimeout(HTEvent * event, int timeout)
114: {
115: if (event) {
116: event->millis = timeout;
117: return YES;
2.2 frystyk 118: }
2.4 frystyk 119: return NO;
2.6 eric 120: }
121:
122: PUBLIC char * HTEvent_type2str(HTEventType type)
123: {
124: int i;
125: static char space[20]; /* in case we have to sprintf type */
126: static struct {int type; char * str;} match[] = {HT_EVENT_INITIALIZER};
127: for (i = 0; i < sizeof(match)/sizeof(match[0]); i++)
128: if (match[i].type == type)
129: return match[i].str;
130: sprintf(space, "0x%x", type);
131: return space;
2.1 eric 132: }
133:
Webmaster