]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/mode.h
Properly name the windows service error constants and put proper descriptions in...
[user/henk/code/inspircd.git] / include / mode.h
index a787e4637bbadeb5efc2cfdc38a2259b23c9b9b7..3ea4f6d0601e9c73974059347b5f7445b804ec6a 100644 (file)
@@ -2,7 +2,7 @@
  *       | Inspire Internet Relay Chat Daemon |
  *       +------------------------------------+
  *
- *  InspIRCd: (C) 2002-2007 InspIRCd Development Team
+ *  InspIRCd: (C) 2002-2008 InspIRCd Development Team
  * See: http://www.inspircd.org/wiki/index.php/Credits
  *
  * This program is free but copyrighted software; see
 #ifndef __MODE_H
 #define __MODE_H
 
-/* include the common header files */
-#include <string>
-#include <deque>
-#include <vector>
-#include "users.h"
-#include "channels.h"
-#include "ctables.h"
+/* Forward declarations. */
+class User;
 
-class InspIRCd;
+#include "channels.h"
 
 /**
  * Holds the values for different type of modes
@@ -144,6 +139,11 @@ class CoreExport ModeHandler : public Extensible
         */
        unsigned int count;
 
+       /** The prefix char needed on channel to use this mode,
+        * only checked for channel modes
+        */
+       char prefixneeded;
+
  public:
        /**
         * The constructor for ModeHandler initalizes the mode handler.
@@ -161,7 +161,7 @@ class CoreExport ModeHandler : public Extensible
         * and the rank values OP_VALUE, HALFOP_VALUE and VOICE_VALUE respectively. Any prefixes you define should have unique values proportional
         * to these three defaults or proportional to another mode in a module you depend on. See src/cmode_o.cpp as an example.
         */
-       ModeHandler(InspIRCd* Instance, char modeletter, int parameters_on, int parameters_off, bool listmode, ModeType type, bool operonly, char mprefix = 0);
+       ModeHandler(InspIRCd* Instance, char modeletter, int parameters_on, int parameters_off, bool listmode, ModeType type, bool operonly, char mprefix = 0, char prefixrequired = '%');
        /**
         * The default destructor does nothing
         */
@@ -223,7 +223,7 @@ class CoreExport ModeHandler : public Extensible
         * @param adding This value is true when the mode is being set, or false when it is being unset.
         * @return MODEACTION_ALLOW to allow the mode, or MODEACTION_DENY to prevent the mode, also see the description of 'parameter'.
         */
-       virtual ModeAction OnModeChange(User* source, User* dest, Channel* channel, std::string &parameter, bool adding); /* Can change the mode parameter as its a ref */
+       virtual ModeAction OnModeChange(User* source, User* dest, Channel* channel, std::string &parameter, bool adding, bool servermode = false); /* Can change the mode parameter as its a ref */
        /**
         * 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.
@@ -232,6 +232,14 @@ class CoreExport ModeHandler : public Extensible
         */
        virtual void DisplayList(User* user, Channel* channel);
 
+       /** In the event that the mode should be given a parameter, and no parameter was provided, this method is called.
+        * This allows you to give special information to the user, or handle this any way you like.
+        * @param user The user issuing the mode change
+        * @param dest For user mode changes, the target of the mode. For channel mode changes, NULL.
+        * @param channel For channel mode changes, the target of the mode. For user mode changes, NULL.
+        */
+       virtual void OnParameterMissing(User* user, User* dest, Channel* 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
@@ -276,7 +284,7 @@ class CoreExport ModeHandler : public Extensible
         * your mode properly from each user.
         * @param user The user which the server wants to remove your mode from
         */
-       virtual void RemoveMode(User* user);
+       virtual void RemoveMode(User* user, irc::modestacker* stack = NULL);
 
        /**
         * When a MODETYPE_CHANNEL mode handler is being removed, the server will call this method for every channel on the server.
@@ -286,7 +294,37 @@ class CoreExport ModeHandler : public Extensible
         * your mode properly from each channel. Note that in the case of listmodes, you should remove the entire list of items.
         * @param channel The channel which the server wants to remove your mode from
         */
-       virtual void RemoveMode(Channel* channel);
+       virtual void RemoveMode(Channel* channel, irc::modestacker* stack = NULL);
+
+       char GetNeededPrefix();
+
+       void SetNeededPrefix(char needsprefix);
+};
+
+/** A prebuilt mode handler which handles a simple user mode, e.g. no parameters, usable by any user, with no extra
+ * behaviour to the mode beyond the basic setting and unsetting of the mode, not allowing the mode to be set if it
+ * is already set and not allowing it to be unset if it is already unset.
+ * An example of a simple user mode is user mode +w.
+ */
+class CoreExport SimpleUserModeHandler : public ModeHandler
+{
+ public:
+       SimpleUserModeHandler(InspIRCd* Instance, char modeletter);
+       virtual ~SimpleUserModeHandler();
+       virtual ModeAction OnModeChange(User* source, User* dest, Channel* channel, std::string &parameter, bool adding, bool servermode = false);
+};
+
+/** A prebuilt mode handler which handles a simple channel mode, e.g. no parameters, usable by any user, with no extra
+ * behaviour to the mode beyond the basic setting and unsetting of the mode, not allowing the mode to be set if it
+ * is already set and not allowing it to be unset if it is already unset.
+ * An example of a simple channel mode is channel mode +s.
+ */
+class CoreExport SimpleChannelModeHandler : public ModeHandler
+{
+ public:
+       SimpleChannelModeHandler(InspIRCd* Instance, char modeletter);
+       virtual ~SimpleChannelModeHandler();
+       virtual ModeAction OnModeChange(User* source, User* dest, Channel* channel, std::string &parameter, bool adding, bool servermode = false);
 };
 
 /**
@@ -345,7 +383,7 @@ class CoreExport ModeWatcher : public Extensible
         * @return True to allow the mode change to go ahead, false to abort it. If you abort the
         * change, the mode handler (and ModeWatcher::AfterMode()) will never see the mode change.
         */
-       virtual bool BeforeMode(User* source, User* dest, Channel* channel, std::string &parameter, bool adding, ModeType type);
+       virtual bool BeforeMode(User* source, User* dest, Channel* channel, std::string &parameter, bool adding, ModeType type, bool servermode = false);
        /**
         * After the mode character has been processed by the ModeHandler, this method will be called.
         * @param source The sender of the mode
@@ -356,7 +394,7 @@ class CoreExport ModeWatcher : public Extensible
         * @param adding True if the mode is being added and false if it is being removed
         * @type The mode type, either MODETYPE_USER or MODETYPE_CHANNEL
         */
-       virtual void AfterMode(User* source, User* dest, Channel* channel, const std::string &parameter, bool adding, ModeType type);
+       virtual void AfterMode(User* source, User* dest, Channel* channel, const std::string &parameter, bool adding, ModeType type, bool servermode = false);
 };
 
 typedef std::vector<ModeWatcher*>::iterator ModeWatchIter;
@@ -394,6 +432,10 @@ class CoreExport ModeParser : public classbase
         */
        std::string LastParse;
 
+       unsigned int sent[256];
+
+       unsigned int seq;
+
  public:
 
        /** The constructor initializes all the RFC basic modes by using ModeParserAddMode().
@@ -462,13 +504,12 @@ class CoreExport ModeParser : public classbase
        /** Process a set of mode changes from a server or user.
         * @param parameters The parameters of the mode change, in the format
         * they would be from a MODE command.
-        * @param pcnt The number of items in the parameters array
         * @param user The user setting or removing the modes. When the modes are set
         * by a server, an 'uninitialized' User is used, where *user::nick == NULL
         * and *user->server == NULL.
         * @param servermode True if a server is setting the mode.
         */
-       void Process(const char** parameters, int pcnt, User *user, bool servermode);
+       void Process(const std::vector<std::string>& parameters, User *user, bool servermode);
 
        /** Find the mode handler for a given mode and type.
         * @param modeletter mode letter to search for
@@ -516,9 +557,11 @@ class CoreExport ModeParser : public classbase
         * similar purposes.
         * @param user The username to look up
         * @param channel The channel name to look up the privilages of the user for
+        * @param nick_suffix true (the default) if you want nicknames in the mode string, for easy
+        * use with the mode stacker, false if you just want the "avh" part of "avh nick nick nick".
         * @return The mode string.
         */
-       std::string ModeString(User* user, Channel* channel);
+       std::string ModeString(User* user, Channel* channel, bool nick_suffix = true);
 };
 
 #endif