/* * Copyright (C) 2020-2022 Roy Qu (royqh1979@gmail.com) * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #ifndef PARSER_UTILS_H #define PARSER_UTILS_H #include #include #include #include #include #include using GetFileStreamCallBack = std::function; enum ParserLanguage { C, CPlusPlus, #ifdef ENABLE_SDCC SDCC, #endif }; struct CodeSnippet { QString caption; //Name QString prefix; //Prefix used in code suggestion QString code; //Code body QString desc; //Description int section; //Section in the menu }; using PCodeSnippet = std::shared_ptr; // preprocess/ macro define struct Define { QString name; QString args; QString value; QString filename; bool hardCoded;// if true, don't free memory (points to hard defines) QList argUsed; int varArgIndex; QString formatValue; // format template to format values }; using PDefine = std::shared_ptr; using DefineMap = QHash; using PDefineMap = std::shared_ptr; enum class KeywordType { SkipItself, // skip itself SkipNextSemicolon, // move to ; and skip it SkipNextColon, // move to : and skip it SkipNextParenthesis, // move to ) and skip it MoveToLeftBrace,// move to { // MoveToRightBrace, // move to } For, //for Catch, //catch Public, // public Private, Protected, Friend, Struct, // struct/class/enum Enum, //enum Inline, // inline Namespace, //namespace Typedef, //typedef Using, //using DeclType, // decltype Operator, //operator Concept, //concept Requires, //requires None, // It's a keyword but don't process here NotKeyword }; //It will be used as hash key. DONT make it enum class!!!!! enum StatementKind { skUnknown, skNamespace, skNamespaceAlias, skClass, skPreprocessor, skEnumType, skEnumClassType, skTypedef, skConstructor, skDestructor, skFunction, skVariable, skGlobalVariable, skLocalVariable, skEnum, skOperator, skParameter, skBlock, skUserCodeSnippet, // user code template skKeyword, // keywords skKeywordType, //keywords for type (for color management) skAlias }; using StatementKindSet = QSet; enum class StatementScope { Global, Local, ClassLocal }; enum class StatementAccessibility { None, Private, Protected, Public }; enum class MemberOperatorType { Arrow, Dot, DColon, Other }; enum class EvalStatementKind { Namespace, Type, Variable, Literal, Function }; struct StatementMatchPosition{ uint16_t start; uint16_t end; }; enum StatementProperty { spNone = 0x0, spStatic = 0x0001, spHasDefinition = 0x0002, spInProject = 0x0004, spInSystemHeader = 0x0008, spInherited = 0x0010, spVirtual = 0x0020, spOverride = 0x0040, spConstexpr = 0x0080, spFunctionPointer = 0x0100, spOperatorOverloading = 0x0200, spDummyStatement = 0x0400 }; Q_DECLARE_FLAGS(StatementProperties, StatementProperty) Q_DECLARE_OPERATORS_FOR_FLAGS(StatementProperties) using PStatementMathPosition = std::shared_ptr; struct Statement; using PStatement = std::shared_ptr; using StatementList = QList; using PStatementList = std::shared_ptr; using StatementMap = QMultiMap; struct Statement { // Statement(); // ~Statement(); std::weak_ptr parentScope; // parent class/struct/namespace scope, use weak pointer to prevent circular reference QString type; // type "int" QString command; // identifier/name of statement "foo" QString args; // args "(int a,float b)" QString value; // Used for macro defines/typedef, "100" in "#defin COUNT 100" StatementKind kind; // kind of statement class/variable/function/etc StatementScope scope; // global/local/classlocal StatementAccessibility accessibility; // protected/private/public int line; // declaration int definitionLine; // definition QString fileName; // declaration QString definitionFileName; // definition StatementMap children; // functions can be overloaded,so we use list to save children with the same name QSet friends; // friend class / functions QString fullName; // fullname(including class and namespace), ClassA::foo QSet usingList; // using namespaces QString noNameArgs;// Args without name StatementProperties properties; // fields for code completion int usageCount; //Usage Count uint16_t matchPosTotal; // total of matched positions uint16_t matchPosSpan; // distance between the first match pos and the last match pos; uint16_t firstMatchLength; // length of first match; uint16_t caseMatched; // if match with case QList matchPositions; // definiton line/filename is valid bool hasDefinition() { return properties.testFlag(StatementProperty::spHasDefinition); } void setHasDefinition(bool on) { properties.setFlag(StatementProperty::spHasDefinition,on); } // statement in project bool inProject() { return properties.testFlag(StatementProperty::spInProject); } void setInProject(bool on) { properties.setFlag(StatementProperty::spInProject, on); } // statement in system header (#include <>) bool inSystemHeader() { return properties.testFlag(StatementProperty::spInSystemHeader); } void setInSystemHeader(bool on) { properties.setFlag(StatementProperty::spInSystemHeader, on); } bool isStatic() { return properties.testFlag(StatementProperty::spStatic); } // static function / variable void setIsStatic(bool on) { properties.setFlag(StatementProperty::spStatic, on); } bool isInherited() { return properties.testFlag(StatementProperty::spInherited); } // inherted member; }; struct EvalStatement; using PEvalStatement = std::shared_ptr; /** * @brief Statement for evaluation result * Ex. (Test*)(y+1) * it's baseStatement is the statement for y * it's effetiveTypeStatement is Test */ struct EvalStatement { QString baseType; // type "int" QString templateParams; EvalStatementKind kind; // namespace / type / variable / function / literal int pointerLevel; // 0 for "int", 1 for "int *", 2 for "int **"... QString definitionString; // std::vector etc... PStatement baseStatement; // if not literal or primitive type, the base statement PStatement typeStatement; PStatement effectiveTypeStatement; public: EvalStatement (const QString& baseType, EvalStatementKind kind, const PStatement& baseStatement, const PStatement& typeStatement, const PStatement& effectiveTypeStatement, int pointerLevel=0, const QString& templateParams=QString()); void assignType(const PEvalStatement& typeStatement); }; struct UsingNamespace { QStringList namespaces; // List['std','foo'] for using namespace std::foo; QString filename; int line; bool fromHeader; }; using PUsingNamespace = std::shared_ptr; struct CppScope { int startLine; PStatement statement; }; using PCppScope = std::shared_ptr; class CppScopes { public: PStatement findScopeAtLine(int line); void addScope(int line, PStatement scopeStatement); PStatement lastScope(); void removeLastScope(); void clear(); private: QVector mScopes; }; struct ClassInheritanceInfo { std::weak_ptr derivedClass; QString file; QString parentClassName; bool isGlobal; bool isStruct; StatementAccessibility visibility; // QString parentClassFilename; bool handled; }; using PClassInheritanceInfo = std::shared_ptr; struct FileIncludes { QString baseFile; QMap includeFiles; // true means the file is directly included, false means included indirectly QStringList directIncludes; // QSet usings; // namespaces it usings StatementMap statements; // but we don't save temporary statements (full name as key) StatementMap declaredStatements; // statements declared in this file (full name as key) CppScopes scopes; // int is start line of the statement scope QMap branches; QList> handledInheritances; bool isLineVisible(int line); }; using PFileIncludes = std::shared_ptr; extern QStringList CppDirectives; extern QStringList JavadocTags; extern QMap CppKeywords; #ifdef ENABLE_SDCC extern QMap SDCCKeywords; extern QSet SDCCTypeKeywords; #endif extern QSet CppControlKeyWords; extern QSet CKeywords; extern QSet CppTypeKeywords; extern QSet STLPointers; extern QSet STLContainers; extern QSet STLMaps; extern QSet STLElementMethods; extern QSet STLIterators; extern QSet MemberOperators; extern QSet IOManipulators; extern QSet AutoTypes; void initParser(); QString getHeaderFilename(const QString& relativeTo, const QString& line, const QStringList& includePaths, const QStringList& projectIncludePaths); QString getLocalHeaderFilename(const QString& relativeTo, const QString& fileName); QString getSystemHeaderFilename(const QString& fileName, const QStringList& includePaths); bool isSystemHeaderFile(const QString& fileName, const QSet& includePaths); bool isHFile(const QString& filename); bool isCFile(const QString& filename); bool isCppFile(const QString& filename); bool isCppKeyword(const QString& word); bool isCppControlKeyword(const QString& word); bool isScopeTypeKind(StatementKind kind); bool isTypeKind(StatementKind kind); MemberOperatorType getOperatorType(const QString& phrase, int index); QStringList getOwnerExpressionAndMember( const QStringList expression, QString& memberOperator, QStringList& memberExpression); bool isMemberOperator(QString token); StatementKind getKindOfStatement(const PStatement& statement); #endif // PARSER_UTILS_H