]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/mode.h
Add a metric assload of TRANSLATE macros to modules.
[user/henk/code/inspircd.git] / include / mode.h
index 27cdd890f40f735c532a83d1d92ab99f54c53ae1..c8a315cce85df14b129a002a472061fce56f055c 100644 (file)
@@ -2,12 +2,9 @@
  *       | Inspire Internet Relay Chat Daemon |
  *       +------------------------------------+
  *
- *  InspIRCd is copyright (C) 2002-2006 ChatSpike-Dev.
- *                       E-mail:
- *                <brain@chatspike.net>
- *               <Craig@chatspike.net>
- *     
- * Written by Craig Edwards, Craig McLure, and others.
+ *  InspIRCd: (C) 2002-2007 InspIRCd Development Team
+ * See: http://www.inspircd.org/wiki/index.php/Credits
+ *
  * This program is free but copyrighted software; see
  *            the file COPYING for details.
  *
@@ -33,7 +30,9 @@ class InspIRCd;
  */
 enum ModeType
 {
+       /** User mode */
        MODETYPE_USER = 0,
+       /** Channel mode */
        MODETYPE_CHANNEL = 1
 };
 
@@ -67,8 +66,11 @@ enum ModeMasks
  */
 enum PrefixModeValue
 {
+       /* +v */
        VOICE_VALUE     =       10000,
+       /* +h */
        HALFOP_VALUE    =       20000,
+       /* +o */
        OP_VALUE        =       30000
 };
 
@@ -93,9 +95,12 @@ typedef std::pair<bool,std::string> ModePair;
  * mode is expected to have a parameter, then this is
  * equivalent to returning MODEACTION_DENY.
  */
-class ModeHandler : public Extensible
+class CoreExport ModeHandler : public Extensible
 {
  protected:
+       /**
+        * Creator/owner pointer
+        */
        InspIRCd* ServerInstance;
        /**
         * The mode letter you're implementing.
@@ -135,6 +140,10 @@ class ModeHandler : public Extensible
         */
        char prefix;
 
+       /** Number of items with this mode set on them
+        */
+       unsigned int count;
+
  public:
        /**
         * The constructor for ModeHandler initalizes the mode handler.
@@ -167,6 +176,12 @@ class ModeHandler : public Extensible
         * value for this mode prefix.
         */
        char GetPrefix();
+       /** Get number of items with this mode set on them
+        */
+       virtual unsigned int GetCount();
+       /** Adjust usage count returned by GetCount
+        */
+       virtual void ChangeCount(int modifier);
        /**
         * Get the 'value' of this modes prefix.
         * determines which to display when there are multiple.
@@ -213,9 +228,17 @@ class ModeHandler : public Extensible
         * If your mode is a listmode, then this method will be called for displaying an item list, e.g. on MODE #channel +modechar
         * without any parameter or other modes in the command.
         * @param user The user issuing the command
-        * @parameter channel The channel they're requesting an item list of (e.g. a banlist, or an exception list etc)
+        * @param channel The channel they're requesting an item list of (e.g. a banlist, or an exception list etc)
         */
        virtual void DisplayList(userrec* user, chanrec* channel);
+
+       /**
+        * If your mode is a listmode, this method will be called to display an empty list (just the end of list numeric)
+        * @param user The user issuing the command
+        * @param channel The channel tehy're requesting an item list of (e.g. a banlist, or an exception list etc)
+        */
+       virtual void DisplayEmptyList(userrec* user, chanrec* channel);
+
        /**
         * If your mode needs special action during a server sync to determine which side wins when comparing timestamps,
         * override this function and use it to return true or false. The default implementation just returns true if
@@ -272,9 +295,12 @@ class ModeHandler : public Extensible
  * and attach it to the mode using Server::AddModeWatcher and Server::DelModeWatcher.
  * A ModeWatcher will be called both before and after the mode change.
  */
-class ModeWatcher : public Extensible
+class CoreExport ModeWatcher : public Extensible
 {
  protected:
+       /**
+        * Creator/owner pointer
+        */
        InspIRCd* ServerInstance;
        /**
         * The mode letter this class is watching
@@ -340,9 +366,12 @@ typedef std::vector<ModeWatcher*>::iterator ModeWatchIter;
  * parses client to server MODE strings for user and channel modes, and performs
  * processing for the 004 mode list numeric, amongst other things.
  */
-class ModeParser : public classbase
+class CoreExport ModeParser : public classbase
 {
  private:
+       /**
+        * Creator/owner pointer
+        */
        InspIRCd* ServerInstance;
        /** Mode handlers for each mode, to access a handler subtract
         * 65 from the ascii value of the mode letter.
@@ -360,6 +389,11 @@ class ModeParser : public classbase
         */
        void DisplayCurrentModes(userrec *user, userrec* targetuser, chanrec* targetchannel, const char* text);
 
+       /** The string representing the last set of modes to be parsed.
+        * Use GetLastParse() to get this value, to be used for  display purposes.
+        */
+       std::string LastParse;
+
  public:
 
        /** The constructor initializes all the RFC basic modes by using ModeParserAddMode().
@@ -390,6 +424,12 @@ class ModeParser : public classbase
         * This method can be used on both IPV4 and IPV6 user masks.
         */
        static void CleanMask(std::string &mask);
+       /** Get the last string to be processed, as it was sent to the user or channel. 
+        * Use this to display a string you just sent to be parsed, as the actual output
+        * may be different to what you sent after it has been 'cleaned up' by the parser.
+        * @return Last parsed string, as seen by users.
+        */
+       const std::string& GetLastParse();
        /** Add a mode to the mode parser. The modeletter parameter
         * is purely to save on doing a lookup in the function, as
         * strictly it could be obtained via ModeHandler::GetModeChar().
@@ -466,7 +506,7 @@ class ModeParser : public classbase
        std::string ChanModes();
        /** Used by this class internally during std::sort and 005 generation
         */
-       static bool PrefixComparison(const prefixtype one, const prefixtype two);
+       static bool PrefixComparison(prefixtype one, prefixtype two);
 
        /** This returns the PREFIX=(ohv)@%+ section of the 005 numeric.
         */
@@ -483,18 +523,5 @@ class ModeParser : public classbase
        std::string ModeString(userrec* user, chanrec* channel);
 };
 
-/** Command handler class for the MODE command.
- * put here for completeness.
- */
-class cmd_mode : public command_t
-{
- public:
-       /** Standard constructor
-        */
-       cmd_mode (InspIRCd* Instance) : command_t(Instance,"MODE",0,1) { syntax = "<target> <modes> {<mode-parameters>}"; }
-       /** Handle MODE
-        */
-       void Handle(const char** parameters, int pcnt, userrec *user);
-};
-
 #endif
+