refs #77, a simple command parser

* more a util class, not a real parser

src/blackmisc/simplecommandparser.h

@@ -0,0 +1,89 @@
+/* Copyright (C) 2013
+ * swift project Community / Contributors
+ *
+ * This file is part of swift project. It is subject to the license terms in the LICENSE file found in the top-level
+ * directory of this distribution and at http://www.swift-project.org/license.html. No part of swift project,
+ * including this file, may be copied, modified, propagated, or distributed except according to the terms
+ * contained in the LICENSE file.
+ */
+
+//! \file
+
+#ifndef BLACKMISC_SIMPLECOMMANDPARSER_H
+#define BLACKMISC_SIMPLECOMMANDPARSER_H
+
+#include <QStringList>
+#include <QString>
+
+namespace BlackMisc
+{
+    //! Utility methods for simple line parsing used with the command line
+    //! \remarks case insensitive parsing, commands start with . as ".msg"
+    class CSimpleCommandParser
+    {
+    public:
+        //! No Constructor
+        CSimpleCommandParser(const QStringList &knownCommands);
+
+        //! Known command
+        bool isKnownCommand() const { return m_knownCommand; }
+
+        //! Parse
+        void parse(const QString &commandLine);
+
+        //! Is given command current command of command line
+        bool matchesCommand(const QString &checkCommand, const QString &alias1 = "", const QString &alias2 = "");
+
+        //! Command starting with pattern?
+        bool commandStartsWith(const QString &startPattern) const;
+
+        //! Command ending with pattern?
+        bool commandEndsWith(const QString &endPattern) const;
+
+        //! Get part, 0 is command itself
+        const QString &part(int index) const;
+
+        //! Remaining part after
+        QString remainingStringAfter(int index) const;
+
+        //! Count parts
+        int countParts() const;
+
+        //! Count parts, command excluded
+        int countPartsWithoutCommand() const;
+
+        //! Is part an integer?
+        bool isInt(int index) const;
+
+        //! Is part a double?
+        bool isDouble(int index) const;
+
+        //! Part as integer
+        int toInt(int index, int def = -1) const;
+
+        //! Part as double
+        double toDouble(int index, double def = -1.0) const;
+
+    private:
+        QString m_originalLine;
+        QString m_cleanedLine;       //!< trimmed, no double spaces etc.
+        QString m_commandPart;       //!< command part (e.g. ".msg", if any)
+        QStringList m_splitParts;    //!< split parts (split by " ")
+        QStringList m_knownCommands; //!< known / handled commands
+        bool m_knownCommand = false; //!< known command
+
+        //! Avoid wrong usage
+        void setCheckedCommandList(const QStringList &commands);
+
+        //! Remove leading dot: ".msg" -> "msg"
+        static QString removeLeadingDot(const QString &candidate);
+
+        //! Clean up a command string
+        static QString formatCommand(const QString &command);
+
+        //! Command, aka as starts with dot
+        static bool isCommand(const QString &candidate);
+    };
+}
+
+#endif // guard