Semi-yearly copyright bump
[quassel.git] / src / common / network.h
index 5ad42e9..37bdadb 100644 (file)
@@ -1,5 +1,5 @@
 /***************************************************************************
- *   Copyright (C) 2005-2016 by the Quassel Project                        *
+ *   Copyright (C) 2005-2018 by the Quassel Project                        *
  *   devel@quassel-irc.org                                                 *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
@@ -172,10 +172,37 @@ public :
     //Network::ConnectionState connectionState() const;
     inline int connectionState() const { return _connectionState; }
 
+    /**@{*/
+    /**
+     * Translates a user’s prefix to the channelmode associated with it.
+     * @param prefix Prefix to be translated.
+     */
     QString prefixToMode(const QString &prefix) const;
     inline QString prefixToMode(const QCharRef &prefix) const { return prefixToMode(QString(prefix)); }
+    inline QString prefixesToModes(const QString &prefix) const {
+        QString modes;
+        for (QChar c : prefix) {
+            modes += prefixToMode(c);
+        }
+        return modes;
+    }
+    /**@}*/
+
+    /**@{*/
+    /**
+     * Translates a user’s prefix to the channelmode associated with it.
+     * @param prefix Prefix to be translated.
+     */
     QString modeToPrefix(const QString &mode) const;
     inline QString modeToPrefix(const QCharRef &mode) const { return modeToPrefix(QString(mode)); }
+    inline QString modesToPrefixes(const QString &mode) const {
+        QString prefixes;
+        for (QChar c : mode) {
+            prefixes += modeToPrefix(c);
+        }
+        return prefixes;
+    }
+    /**@}*/
 
     ChannelModeType channelModeType(const QString &mode);
     inline ChannelModeType channelModeType(const QCharRef &mode) { return channelModeType(QString(mode)); }
@@ -268,7 +295,7 @@ public :
      *
      * These results aren't valid if the network is disconnected or capability negotiation hasn't
      * happened, and some servers might not correctly advertise capabilities.  Don't treat this as
-     * a guarentee.
+     * a guarantee.
      *
      * @param[in] capability Name of capability
      * @returns True if connected and advertised by the server, otherwise false