]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/cull_list.h
Penalty should be 'const int'. Note, you can set a const in the constructors init...
[user/henk/code/inspircd.git] / include / cull_list.h
index 67ffcaf967254614af8b6dbfdee223ca37b4b953..c5daab5dd5befac31a0e4544b6788033f8d0df7d 100644 (file)
@@ -2,12 +2,9 @@
  *       | Inspire Internet Relay Chat Daemon |
  *       +------------------------------------+
  *
- *  Inspire is copyright (C) 2002-2005 ChatSpike-Dev.
- *                       E-mail:
- *                <brain@chatspike.net>
- *                <Craig@chatspike.net>
+ *  InspIRCd: (C) 2002-2007 InspIRCd Development Team
+ * See: http://www.inspircd.org/wiki/index.php/Credits
  *
- * Written by Craig Edwards, Craig McLure, and others.
  * This program is free but copyrighted software; see
  *            the file COPYING for details.
  *
 
 // include the common header files
 
-#include <typeinfo>
-#include <iostream>
 #include <string>
 #include <deque>
-#include <sstream>
 #include <vector>
 #include "users.h"
 #include "channels.h"
 
+class InspIRCd;
+
 /** The CullItem class holds a user and their quitmessage,
  * and is used internally by the CullList class to compile
  * a list of users which are to be culled when a long
  * operation (such as a netsplit) has completed.
  */
-class CullItem
+class CoreExport CullItem : public classbase
 {
  private:
        /** Holds a pointer to the user,
         * must be valid and can be a local or remote user.
         */
-        userrec* user;
+       User* user;
        /** Holds the quit reason to use for this user.
         */
-        std::string reason;
+       std::string reason;
+       /** Holds the quit reason opers see, if different from users
+        */
+       std::string oper_reason;
+       /** Silent items dont generate an snotice.
+        */
+       bool silent;
  public:
+       /** Constrcutor.
+       * Initializes the CullItem with a user pointer
+       * and their quit reason
+       * @param u The user to add
+       * @param r The quit reason of the added user
+       * @param ro The quit reason to show to opers only
+       */
+       CullItem(User* u, std::string &r, const char* ro = "");
        /** Constrcutor.
         * Initializes the CullItem with a user pointer
         * and their quit reason
         * @param u The user to add
         * @param r The quit reason of the added user
+        * @param ro The quit reason to show to opers only
         */
-        CullItem(userrec* u, std::string r);
-       /** Returns a pointer to the user
+       CullItem(User* u, const char* r, const char* ro = "");
+
+       /** Make the quit silent a module is dealing with
+        * displaying this users quit, so we shouldn't
+        * send anything out.
+        */
+       void MakeSilent();
+
+       /** Returns true if the quit for this user has been set
+        * to silent.
+        */
+       bool IsSilent();
+
+       /** Destructor
         */
-        userrec* GetUser();
+       ~CullItem();
+
+       /** Returns a pointer to the user
+       */
+       User* GetUser();
        /** Returns the user's quit reason
+       */
+       std::string& GetReason();
+       /** Returns oper reason
         */
-        std::string GetReason();
+       std::string& GetOperReason();
 };
 
 /** The CullList class can be used by modules, and is used
@@ -72,40 +102,61 @@ class CullItem
  * you attempt to add the same user twice, then the second
  * attempt will be ignored.
  */
-class CullList
+class CoreExport CullList : public classbase
 {
  private:
-        /** Holds a list of users being quit.
-         * See the information for CullItem for
-         * more information.
-         */
-         std::vector<CullItem> list;
-        /** A list of users who have already been
-         * placed on the list, as a map for fast
-         * reference.
-         */
-        std::map<userrec*,int> exempt;
+       /** Creator of this CullList
+        */
+       InspIRCd* ServerInstance;
+
+       /** Holds a list of users already added for quick lookup
+        */
+       std::map<User*, User*> exempt;
+
+       /** Holds a list of users being quit.
+        * See the information for CullItem for
+        * more information.
+        */
+       std::vector<CullItem> list;
+
  public:
-        /** Constructor.
-         * Clears the CullList::list and CullList::exempt
-         * items.
-         */
-         CullList();
-        /** Adds a user to the cull list for later
-         * removal via QUIT.
-         * @param user The user to add
-         * @param reason The quit reason of the user being added
-         */
-         void AddItem(userrec* user, std::string reason);
-        /** Applies the cull list, quitting all the users
-         * on the list with their quit reasons all at once.
-         * This is a very fast operation compared to
-         * iterating the user list and comparing each one,
-         * especially if there are multiple comparisons
-         * to be done, or recursion.
-         * @returns The number of users removed from IRC.
-         */
-         int Apply();
+       /** Constructor.
+        * Clears the CullList::list and CullList::exempt
+        * items.
+        * @param Instance Creator of this CullList object
+        */
+       CullList(InspIRCd* Instance);
+
+       /** Adds a user to the cull list for later
+        * removal via QUIT.
+        * @param user The user to add
+        * @param reason The quit reason of the user being added
+        * @param o_reason The quit reason to show only to opers
+        */
+       void AddItem(User* user, std::string &reason, const char* o_reason = "");
+
+       /** Adds a user to the cull list for later
+        * removal via QUIT.
+        * @param user The user to add
+        * @param reason The quit reason of the user being added
+        * @param o_reason The quit reason to show only to opers
+        */
+       void AddItem(User* user, const char* reason, const char* o_reason = "");
+
+       /* Turn an item into a silent item (don't send out QUIT for this user)
+        */
+       void MakeSilent(User* user);
+
+       /** Applies the cull list, quitting all the users
+        * on the list with their quit reasons all at once.
+        * This is a very fast operation compared to
+        * iterating the user list and comparing each one,
+        * especially if there are multiple comparisons
+        * to be done, or recursion.
+        * @returns The number of users removed from IRC.
+        */
+       int Apply();
 };
 
 #endif
+