X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=include%2Fchannels.h;h=6080cda98182cb4e82fbe279434184f1c04d1a33;hb=3ffb95a12391eac5cf89549af9e790362fbfc075;hp=c0df69513c06b0427a46272c0aaaa8607a9cbea9;hpb=71247cc2f120b67302271937b887de95c8bcc623;p=user%2Fhenk%2Fcode%2Finspircd.git

diff --git a/include/channels.h b/include/channels.h
index c0df69513..6080cda98 100644
--- a/include/channels.h
+++ b/include/channels.h
@@ -1,7 +1,18 @@
-/*
-
-   
-*/
+/*       +------------------------------------+
+ *       | Inspire Internet Relay Chat Daemon |
+ *       +------------------------------------+
+ *
+ *  Inspire is copyright (C) 2002-2004 ChatSpike-Dev.
+ *                       E-mail:
+ *                <brain@chatspike.net>
+ *           	  <Craig@chatspike.net>
+ *     
+ * Written by Craig Edwards, Craig McLure, and others.
+ * This program is free but copyrighted software; see
+ *            the file COPYING for details.
+ *
+ * ---------------------------------------------------
+ */
 
 #include "inspircd_config.h"
 #include "base.h"
@@ -90,6 +101,15 @@ class chanrec : public Extensible
 	 * Plugins may use this field in any way they see fit.
 	 */
 	char custom_modes[MAXMODES];     /* modes handled by modules */
+
+	/** Count of users on the channel used for fast user counting
+	 */
+	long users;
+
+	/** User list (casted to char*'s to stop forward declaration stuff)
+	 * (chicken and egg scenario!)
+	 */
+	std::vector<char*> internal_userlist;
 	
 	/** Channel topic.
 	 * If this is an empty string, no channel topic is set.
@@ -167,6 +187,52 @@ class chanrec : public Extensible
 	  */
 	std::string GetModeParameter(char mode);
 
+	/** Increment the channel "user counter"
+	 * The channel user counter is a reference counter which
+	 * holds the number of users on the channel. If it decremented
+	 * to 0 then the channel is removed from the system.
+	 */
+	void IncUserCounter();
+
+	/** Decrement the channel "user counter"
+         * The channel user counter is a reference counter which
+         * holds the number of users on the channel. If it decremented
+         * to 0 then the channel is removed from the system.
+	 * Modules may alter the reference count to hold channels open
+	 * which have no users and would normally be deleted once empty.
+	 */
+	void DecUserCounter();
+
+	/** Obtain the channel "user counter"
+	 * This returns the channel reference counter, which is initialized
+	 * to 0 when the channel is created and incremented/decremented
+	 * upon joins, parts quits and kicks.
+	 */
+	long GetUserCounter();
+
+	/** Add a user pointer to the internal reference list
+	 * The data inserted into the reference list is a table as it is
+	 * an arbitary pointer compared to other users by its memory address,
+	 * as this is a very fast 32 or 64 bit integer comparison.
+	 */
+	void AddUser(char* castuser);
+
+        /** Delete a user pointer to the internal reference list
+         * The data removed from the reference list is a table as it is
+         * an arbitary pointer compared to other users by its memory address,
+         * as this is a very fast 32 or 64 bit integer comparison.
+         */
+	void DelUser(char* castuser);
+
+	/** Obrain the internal reference list
+	 * The internal reference list contains a list of userrec*
+	 * cast to char*. These are used for rapid comparison to determine
+	 * channel membership for PRIVMSG, NOTICE, QUIT, PART etc.
+	 * The resulting pointer to the vector should be considered
+	 * readonly and only modified via AddUser and DelUser.
+	 */
+	std::vector<char*> *GetUsers();
+
 	/** Creates a channel record and initialises it with default values
 	 */
 	chanrec();