]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/channels.h
Removed chanrec::binarymodes - insp wont compile atm do not use :p
[user/henk/code/inspircd.git] / include / channels.h
index 7df2d665e76ec494e76a5632e45a1e9a3edb44ef..a6568cb1e8198ffd25ccd286725cf7d427b09b32 100644 (file)
@@ -2,7 +2,7 @@
  *       | Inspire Internet Relay Chat Daemon |
  *       +------------------------------------+
  *
- *  Inspire is copyright (C) 2002-2004 ChatSpike-Dev.
+ *  InspIRCd is copyright (C) 2002-2006 ChatSpike-Dev.
  *                       E-mail:
  *                <brain@chatspike.net>
  *               <Craig@chatspike.net>
  * ---------------------------------------------------
  */
 
+#ifndef __CHANNELS_H__
+#define __CHANNELS_H__
+
 #include "inspircd_config.h"
 #include "base.h"
 #include <time.h>
 #include <vector>
 #include <string>
+#include <map>
+
+enum ChannelModes {
+       CM_TOPICLOCK = 1,
+       CM_NOEXTERNAL = 2,
+       CM_INVITEONLY = 4,
+       CM_MODERATED = 8,
+       CM_SECRET = 16,
+       CM_PRIVATE = 32
+};
 
-#ifndef __CHANNELS_H__
-#define __CHANNELS_H__
-
-#define CM_TOPICLOCK 1
-#define CM_NOEXTERNAL 2
-#define CM_INVITEONLY 4
-#define CM_MODERATED 8
-#define CM_SECRET 16
-#define CM_PRIVATE 32
+class userrec;
 
 /** Holds an entry for a ban list, exemption list, or invite list.
  * This class contains a single element in a channel list, such as a banlist.
@@ -69,19 +74,6 @@ class InviteItem : public HostItem
 {
 };
 
-
-/** Holds a custom parameter to a module-defined channel mode
-  * e.g. for +L this would hold the channel name.
-  */
-
-class ModeParameter : public classbase
-{
- public:
-       char mode;
-       char parameter[MAXBUF];
-       char channel[CHANMAX];
-};
-
 /** Holds a complete ban list
  */
 typedef std::vector<BanItem>   BanList;
@@ -94,6 +86,16 @@ typedef std::vector<ExemptItem>      ExemptList;
  */
 typedef std::vector<InviteItem>        InviteList;
 
+class userrec;
+
+/** A list of users on a channel
+ */
+typedef std::map<userrec*,userrec*> CUList;
+
+/** A list of custom modes parameters on a channel
+ */
+typedef std::map<char,char*> CustomModeList;
+
 /** Holds all relevent information for a channel.
  * This class represents a channel, and contains its name, modes, time created, topic, topic set time,
  * etc, and an instance of the BanList type.
@@ -107,17 +109,26 @@ class chanrec : public Extensible
        /** Custom modes for the channel.
         * Plugins may use this field in any way they see fit.
         */
-       char custom_modes[MAXMODES];     /* modes handled by modules */
+       char custom_modes[64];     /* modes handled by modules */
 
-       /** User list (casted to char*'s to stop forward declaration stuff)
-        * (chicken and egg scenario!)
+       /** User lists
+        * There are four user lists, one for 
+        * all the users, one for the ops, one for
+        * the halfops and another for the voices.
         */
-       std::vector<char*> internal_userlist;
-       
+       CUList internal_userlist;
+       CUList internal_op_userlist;
+       CUList internal_halfop_userlist;
+       CUList internal_voice_userlist;
+
+       /** Parameters for custom modes
+        */
+       CustomModeList custom_mode_params;
+
        /** Channel topic.
         * If this is an empty string, no channel topic is set.
         */
-       char topic[MAXBUF];
+       char topic[MAXTOPIC];
        /** Creation time.
         */
        time_t created;
@@ -142,29 +153,40 @@ class chanrec : public Extensible
        
        /** Contains a bitmask of the CM_* builtin (RFC) binary mode symbols
         */
-       char binarymodes;
+       //char binarymodes;
        
        /** The list of all bans set on the channel.
         */
        BanList bans;
        
        /** Sets or unsets a custom mode in the channels info
+        * @param mode The mode character to set or unset
+        * @param mode_on True if you want to set the mode or false if you want to remove it
         */
        void SetCustomMode(char mode,bool mode_on);
 
        /** Sets or unsets the parameters for a custom mode in a channels info
+        * @param mode The mode character to set or unset
+        * @param parameter The parameter string to associate with this mode character
+        * @param mode_on True if you want to set the mode or false if you want to remove it
         */
        void SetCustomModeParam(char mode,char* parameter,bool mode_on);
  
        /** Returns true if a custom mode is set on a channel
+         * @param mode The mode character you wish to query
+         * @return True if the custom mode is set, false if otherwise
          */
        bool IsCustomModeSet(char mode);
 
        /** Returns the parameter for a custom mode on a channel.
+         * @param mode The mode character you wish to query
+         *
          * For example if "+L #foo" is set, and you pass this method
          * 'L', it will return '#foo'. If the mode is not set on the
          * channel, or the mode has no parameters associated with it,
          * it will return an empty string.
+         *
+         * @return The parameter for this mode is returned, or an empty string
          */
        std::string GetModeParameter(char mode);
 
@@ -172,31 +194,47 @@ class chanrec : public Extensible
         * 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.
+        *
+        * @return The number of users on this channel
         */
        long GetUserCounter();
 
        /** Add a user pointer to the internal reference list
+        * @param user The user to add
+        *
         * 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);
+       void AddUser(userrec* user);
+       void AddOppedUser(userrec* user);
+       void AddHalfoppedUser(userrec* user);
+       void AddVoicedUser(userrec* user);
 
         /** 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.
+        * @param user The user to delete
+        * @return number of users left on the channel
          */
-       void DelUser(char* castuser);
+       unsigned long DelUser(userrec* user);
+       void DelOppedUser(userrec* user);
+       void DelHalfoppedUser(userrec* user);
+       void DelVoicedUser(userrec* user);
 
        /** 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
+        * The internal reference list contains a list of userrec*.
+        * 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.
+        *
+        * @return This function returns pointer to a map of userrec pointers (CUList*).
         */
-       std::vector<char*> *GetUsers();
+       CUList* GetUsers();
+       CUList* GetOppedUsers();
+       CUList* GetHalfoppedUsers();
+       CUList* GetVoicedUsers();
+
+       bool HasUser(userrec* user);
 
        /** Creates a channel record and initialises it with default values
         */
@@ -205,14 +243,13 @@ class chanrec : public Extensible
        virtual ~chanrec() { /* stub */ }
 };
 
-/* used to hold a channel and a users modes on that channel, e.g. +v, +h, +o
+/** used to hold a channel and a users modes on that channel, e.g. +v, +h, +o
  * needs to come AFTER struct chanrec */
-
-#define UCMODE_OP      1
-#define UCMODE_VOICE   2
-#define UCMODE_HOP     4
-#define UCMODE_PROTECT 8
-#define UCMODE_FOUNDER 16
+enum UserChannelModes {
+       UCMODE_OP      = 1,
+       UCMODE_VOICE   = 2,
+       UCMODE_HOP     = 4
+};
  
 /** Holds a user's modes on a channel
  * This class associates a users privilages with a channel by creating a pointer link between
@@ -232,9 +269,14 @@ class ucrec : public classbase
         */
        chanrec *channel;
 
-       ucrec() { /* stub */ }
+       ucrec() : uc_modes(0), channel(NULL) { /* stub */ }
        virtual ~ucrec() { /* stub */ }
 };
 
+chanrec* add_channel(userrec *user, const char* cn, const char* key, bool override);
+chanrec* del_channel(userrec *user, const char* cname, const char* reason, bool local);
+void kick_channel(userrec *src,userrec *user, chanrec *Ptr, char* reason);
+void server_kick_channel(userrec* user, chanrec* Ptr, char* reason, bool triggerevents);
+
 #endif