]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/channels.h
Tons of comments
[user/henk/code/inspircd.git] / include / channels.h
index e14c81f270143da501c1b1cdbff919a6a2962219..82a955069fe15c5ecc77591c73538c51517afedb 100644 (file)
 #include <string>
 #include <map>
 
+/** RFC1459 channel modes
+ */
 enum ChannelModes {
-       CM_TOPICLOCK = 1,
-       CM_NOEXTERNAL = 2,
-       CM_INVITEONLY = 4,
-       CM_MODERATED = 8,
-       CM_SECRET = 16,
-       CM_PRIVATE = 32
+       CM_TOPICLOCK = 't'-65,
+       CM_NOEXTERNAL = 'n'-65,
+       CM_INVITEONLY = 'i'-65,
+       CM_MODERATED = 'm'-65,
+       CM_SECRET = 's'-65,
+       CM_PRIVATE = 'p'-65,
+       CM_KEY = 'k'-65,
+       CM_LIMIT = 'l'-65
 };
 
 class userrec;
+class chanrec;
 
 /** 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.
@@ -49,25 +54,18 @@ class HostItem : public classbase
        virtual ~HostItem() { /* stub */ }
 };
 
-// banlist is inherited from HostList mainly for readability
-// reasons only
-
 /** A subclass of HostItem designed to hold channel bans (+b)
  */
 class BanItem : public HostItem
 {
 };
 
-// same with this...
-
 /** A subclass of HostItem designed to hold channel exempts (+e)
  */
 class ExemptItem : public HostItem
 {
 };
 
-// and this...
-
 /** A subclass of HostItem designed to hold channel invites (+I)
  */
 class InviteItem : public HostItem
@@ -86,30 +84,79 @@ 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;
 
+/** Shorthand for CUList::iterator
+ */
+typedef CUList::iterator CUListIter;
+typedef CUList::const_iterator CUListConstIter;
+
 /** A list of custom modes parameters on a channel
  */
 typedef std::map<char,char*> CustomModeList;
 
+
+/** used to hold a channel and a users modes on that channel, e.g. +v, +h, +o
+ * needs to come AFTER struct chanrec */
+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
+ * a userrec and chanrec class. The uc_modes member holds a bitmask of which privilages the user
+ * has on the channel, such as op, voice, etc.
+ */
+class ucrec : public classbase
+{
+ public:
+       /** Contains a bitmask of the UCMODE_OP ... UCMODE_FOUNDER values.
+        * If this value is zero, the user has no privilages upon the channel.
+        */
+       char uc_modes;
+
+       /** Points to the channel record where the given modes apply.
+        * If the record is not in use, this value will be NULL.
+        */
+       chanrec *channel;
+
+       /** Constructor for ucrec
+        */
+       ucrec() : uc_modes(0), channel(NULL) { /* stub */ }
+
+       /** Destructor for ucrec
+        */
+       virtual ~ucrec() { /* stub */ }
+};
+
+
 /** 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.
  */
 class chanrec : public Extensible
 {
+ private:
+
+       /** Connect a chanrec to a userrec
+        */
+       static chanrec* ForceChan(chanrec* Ptr,ucrec *a,userrec* user, int created);
+
  public:
        /** The channels name.
         */
        char name[CHANMAX]; /* channel name */
-       /** Custom modes for the channel.
-        * Plugins may use this field in any way they see fit.
+       /** Modes for the channel.
+        * This is not a null terminated string! It is a hash where
+        * each item in it represents if a mode is set. For example
+        * for mode +A, index 0. Use modechar-65 to calculate which
+        * field to check.
         */
-       char custom_modes[64];     /* modes handled by modules */
+       char modes[64];
 
        /** User lists
         * There are four user lists, one for 
@@ -153,7 +200,7 @@ 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.
         */
@@ -163,20 +210,20 @@ class chanrec : public Extensible
         * @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);
+       void SetMode(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);
+       void SetModeParam(char mode,const char* parameter,bool mode_on);
  
-       /** Returns true if a custom mode is set on a channel
+       /** Returns true if a 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);
+       bool IsModeSet(char mode);
 
        /** Returns the parameter for a custom mode on a channel.
          * @param mode The mode character you wish to query
@@ -220,7 +267,7 @@ class chanrec : public Extensible
        void DelHalfoppedUser(userrec* user);
        void DelVoicedUser(userrec* user);
 
-       /** Obrain the internal reference list
+       /** Obtain the internal reference list
         * 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.
@@ -234,49 +281,62 @@ class chanrec : public Extensible
        CUList* GetHalfoppedUsers();
        CUList* GetVoicedUsers();
 
+       /** Returns true if the user given is on the given channel.
+        */
        bool HasUser(userrec* user);
 
        /** Creates a channel record and initialises it with default values
         */
        chanrec();
 
-       virtual ~chanrec() { /* stub */ }
-};
-
-/** used to hold a channel and a users modes on that channel, e.g. +v, +h, +o
- * needs to come AFTER struct chanrec */
-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
- * a userrec and chanrec class. The uc_modes member holds a bitmask of which privilages the user
- * has on the channel, such as op, voice, etc.
- */
-class ucrec : public classbase
-{
- public:
-       /** Contains a bitmask of the UCMODE_OP ... UCMODE_FOUNDER values.
-        * If this value is zero, the user has no privilages upon the channel.
+       /** Make src kick user from this channel with the given reason.
+        * @param src The source of the kick
+        * @param user The user being kicked (must be on this channel)
+        * @param reason The reason for the kick
+        * @return The number of users left on the channel. If this is zero
+        * when the method returns, you MUST delete the chanrec immediately!
         */
-       char uc_modes;
-       
-       /** Points to the channel record where the given modes apply.
-        * If the record is not in use, this value will be NULL.
+       long KickUser(userrec *src, userrec *user, const char* reason);
+
+       /** Make the server kick user from this channel with the given reason.
+        * @param user The user being kicked (must be on this channel)
+        * @param reason The reason for the kick
+        * @param triggerevents True if you wish this kick to trigger module events
+        * @return The number of users left on the channel. If this is zero
+        * when the method returns, you MUST delete the chanrec immediately!
         */
-       chanrec *channel;
+       long ServerKickUser(userrec* user, const char* reason, bool triggerevents);
+
+       /** Part a user from this channel with the given reason.
+        * If the reason field is NULL, no reason will be sent.
+        * @param user The user who is parting (must be on this channel)
+        * @param reason The (optional) part reason
+        * @return The number of users left on the channel. If this is zero
+        * when the method returns, you MUST delete the chanrec immediately!
+        */
+       long PartUser(userrec *user, const char* reason = NULL);
+
+       /* Join a user to a channel. May be a channel that doesnt exist yet.
+        * @param user The user to join to the channel.
+        * @param cn The channel name to join to. Does not have to exist.
+        * @param key The key of the channel, if given
+        * @param override If true, override all join restrictions such as +bkil
+        * @return A pointer to the chanrec the user was joined to. A new chanrec may have
+        * been created if the channel did not exist before the user was joined to it.
+        * If the user could not be joined to a channel, the return value may be NULL.
+        */
+       static chanrec* JoinUser(userrec *user, const char* cn, bool override, const char* key = "");
 
-       ucrec() : uc_modes(0), channel(NULL) { /* stub */ }
-       virtual ~ucrec() { /* stub */ }
-};
+       void WriteChannel(userrec* user, char* text, ...);
+       void WriteChannel(userrec* user, const std::string &text);
+       void WriteChannelWithServ(const char* ServName, const char* text, ...);
+       void WriteChannelWithServ(const char* ServName, const std::string &text);
+       void WriteAllExceptSender(userrec* user, char status, char* text, ...);
+       void WriteAllExceptSender(userrec* user, char status, const std::string& text);
 
-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);
+       /** Destructor for chanrec
+        */
+       virtual ~chanrec() { /* stub */ }
+};
 
 #endif
-