]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/channels.h
Spotted problem: must clear out all prefixes attached to a user when they quit or...
[user/henk/code/inspircd.git] / include / channels.h
index effb6587394c7e8c763c5792f18ad5767a919ddb..489c8b0e868886b511cab3df4df45956e2af2182 100644 (file)
@@ -46,8 +46,14 @@ class chanrec;
 class HostItem : public classbase
 {
  public:
+       /** Time the item was added
+        */
        time_t set_time;
+       /** Who added the item
+        */
        char set_by[NICKMAX];
+       /** The actual item data
+        */
        char data[MAXBUF];
 
        HostItem() { /* stub */ }
@@ -91,6 +97,9 @@ typedef std::map<userrec*,userrec*> CUList;
 /** Shorthand for CUList::iterator
  */
 typedef CUList::iterator CUListIter;
+
+/** Shorthand for CUList::const_iterator
+ */
 typedef CUList::const_iterator CUListConstIter;
 
 /** A list of custom modes parameters on a channel
@@ -99,7 +108,7 @@ 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,
@@ -133,6 +142,11 @@ class ucrec : public classbase
        virtual ~ucrec() { /* stub */ }
 };
 
+class InspIRCd;
+
+typedef std::pair<char, unsigned int> prefixtype;
+typedef std::vector<prefixtype> pfxcontainer;
+typedef std::map<userrec*, std::vector<prefixtype> > prefixlist;
 
 /** Holds all relevent information for a channel.
  * This class represents a channel, and contains its name, modes, time created, topic, topic set time,
@@ -142,14 +156,21 @@ class chanrec : public Extensible
 {
  private:
 
+       /** Pointer to creator object
+        */
+       InspIRCd* ServerInstance;
+
        /** Connect a chanrec to a userrec
         */
-       static chanrec* ForceChan(chanrec* Ptr,ucrec *a,userrec* user, int created);
+       static chanrec* ForceChan(InspIRCd* Instance, chanrec* Ptr,ucrec *a,userrec* user, int created);
+
+       prefixlist prefixes;
 
  public:
        /** The channels name.
         */
-       char name[CHANMAX]; /* channel name */
+       char name[CHANMAX];
+
        /** 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
@@ -164,8 +185,17 @@ class chanrec : public Extensible
         * the halfops and another for the voices.
         */
        CUList internal_userlist;
+
+       /** Opped users
+        */
        CUList internal_op_userlist;
+
+       /** Halfopped users
+        */
        CUList internal_halfop_userlist;
+
+       /** Voiced users
+        */
        CUList internal_voice_userlist;
 
        /** Parameters for custom modes
@@ -197,11 +227,7 @@ class chanrec : public Extensible
         * If this value is an empty string, there is no channel key in place.
         */
        char key[32];
-       
-       /** Contains a bitmask of the CM_* builtin (RFC) binary mode symbols
-        */
-       //char binarymodes;
-       
+
        /** The list of all bans set on the channel.
         */
        BanList bans;
@@ -254,17 +280,41 @@ class chanrec : public Extensible
         * as this is a very fast 32 or 64 bit integer comparison.
         */
        void AddUser(userrec* user);
+
+       /** Add a user pointer to the internal reference list of opped users
+        * @param user The user to add
+        */
        void AddOppedUser(userrec* user);
+
+       /** Add a user pointer to the internal reference list of halfopped users
+        * @param user The user to add
+        */
        void AddHalfoppedUser(userrec* user);
+
+       /** Add a user pointer to the internal reference list of voiced users
+        * @param user The user to add
+        */
        void AddVoicedUser(userrec* user);
 
         /** Delete a user pointer to the internal reference list
         * @param user The user to delete
-        * @return number of users left on the channel
+        * @return number of users left on the channel after deletion of the user
          */
        unsigned long DelUser(userrec* user);
+
+       /** Delete a user pointer to the internal reference list of opped users
+        * @param user The user to delete
+        */
        void DelOppedUser(userrec* user);
+
+       /** Delete a user pointer to the internal reference list of halfopped users
+        * @param user The user to delete
+        */
        void DelHalfoppedUser(userrec* user);
+
+       /** Delete a user pointer to the internal reference list of voiced users
+        * @param user The user to delete
+        */
        void DelVoicedUser(userrec* user);
 
        /** Obtain the internal reference list
@@ -277,17 +327,32 @@ class chanrec : public Extensible
         * @return This function returns pointer to a map of userrec pointers (CUList*).
         */
        CUList* GetUsers();
+
+       /** Obtain the internal reference list of opped users
+        * @return This function returns pointer to a map of userrec pointers (CUList*).
+        */
        CUList* GetOppedUsers();
+
+       /** Obtain the internal reference list of halfopped users
+        * @return This function returns pointer to a map of userrec pointers (CUList*).
+        */
        CUList* GetHalfoppedUsers();
+
+       /** Obtain the internal reference list of voiced users
+        * @return This function returns pointer to a map of userrec pointers (CUList*).
+        */
        CUList* GetVoicedUsers();
 
        /** Returns true if the user given is on the given channel.
+        * @param The user to look for
+        * @return True if the user is on this channel
         */
        bool HasUser(userrec* user);
 
        /** Creates a channel record and initialises it with default values
+        * @throw Nothing at present.
         */
-       chanrec();
+       chanrec(InspIRCd* Instance);
 
        /** Make src kick user from this channel with the given reason.
         * @param src The source of the kick
@@ -325,7 +390,92 @@ class chanrec : public Extensible
         * 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 = "");
+       static chanrec* JoinUser(InspIRCd* ServerInstance, userrec *user, const char* cn, bool override, const char* key = "");
+
+       /** Write to a channel, from a user, using va_args for text
+        * @param user User whos details to prefix the line with
+        * @param text A printf-style format string which builds the output line without prefix
+        * @param ... Zero or more POD types
+        */
+       void WriteChannel(userrec* user, char* text, ...);
+
+       /** Write to a channel, from a user, using std::string for text
+        * @param user User whos details to prefix the line with
+        * @param text A std::string containing the output line without prefix
+        */
+       void WriteChannel(userrec* user, const std::string &text);
+
+       /** Write to a channel, from a server, using va_args for text
+        * @param ServName Server name to prefix the line with
+        * @param text A printf-style format string which builds the output line without prefi
+        * @param ... Zero or more POD type
+        */
+       void WriteChannelWithServ(const char* ServName, const char* text, ...);
+
+       /** Write to a channel, from a server, using std::string for text
+        * @param ServName Server name to prefix the line with
+        * @param text A std::string containing the output line without prefix
+        */
+       void WriteChannelWithServ(const char* ServName, const std::string &text);
+
+       /** Write to all users on a channel except a specific user, using va_args for text
+        * @param user User whos details to prefix the line with, and to omit from receipt of the message
+        * @param status The status of the users to write to, e.g. '@' or '%'. Use a value of 0 to write to everyone
+        * @param text A printf-style format string which builds the output line without prefi
+        * @param ... Zero or more POD type
+        */
+       void WriteAllExceptSender(userrec* user, char status, char* text, ...);
+
+       /** Write to all users on a channel except a specific user, using std::string for text
+        * @param user User whos details to prefix the line with, and to omit from receipt of the message
+        * @param status The status of the users to write to, e.g. '@' or '%'. Use a value of 0 to write to everyone
+        * @param text A std::string containing the output line without prefix
+        */
+       void WriteAllExceptSender(userrec* user, char status, const std::string& text);
+
+       /** Returns the maximum number of bans allowed to be set on this channel
+        * @return The maximum number of bans allowed
+        */
+       long GetMaxBans();
+
+       /** Return the channel's modes with parameters.
+        * @param showkey If this is set to true, the actual key is shown,
+        * otherwise it is replaced with '&lt;KEY&gt;'
+        * @return The channel mode string
+        */
+       char* ChanModes(bool showkey);
+
+       /** Spool the NAMES list for this channel to the given user
+        * @param The user to spool the NAMES list to
+        */
+       void UserList(userrec *user);
+
+       /** Get the number of invisible users on this channel
+        * @return Number of invisible users
+        */
+       int CountInvisible();
+
+       /** Get a users status on this channel
+        * @param The user to look up
+        * @return One of STATUS_OP, STATUS_HOP, STATUS_VOICE, or zero.
+        */
+       int GetStatus(userrec *user);
+
+       /** Get a users status on this channel in a bitmask
+        * @param The user to look up
+        * @return A bitmask containing zero or more of STATUS_OP, STATUS_HOP, STATUS_VOICE
+        */
+       int GetStatusFlags(userrec *user);
+
+       /** Get a users status on this channel in a string
+        * @param The user to look up
+        * @return A character array containing the string "@", "%", "+" or ""
+        */
+       const char* GetStatusChar(userrec *user);
+
+       void RemoveAllPrefixes(userrec* user);
+
+       void SetPrefix(userrec* user, char prefix, unsigned int prefix_rank, bool adding);
 
        /** Destructor for chanrec
         */