memberdef.h

Go to the documentation of this file.

/******************************************************************************
 *
 * Copyright (C) 1997-2015 by Dimitri van Heesch.
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation under the terms of the GNU General Public License is hereby
 * granted. No representations are made about the suitability of this software
 * for any purpose. It is provided "as is" without express or implied warranty.
 * See the GNU General Public License for more details.
 *
 * Documents produced by Doxygen are derivative works derived from the
 * input used in their production; they are not affected by this license.
 *
 */
 
#ifndef MEMBERDEF_H
#define MEMBERDEF_H
 
#include <memory>
#include <optional>
#include <sys/types.h>
#include <vector>
 
#include "arguments.h"
#include "containers.h"
#include "definition.h"
#include "types.h"
 
class ClassDef;
class ClassDefMutable;
class ExampleList;
class FileDef;
class GroupDef;
class MemberDefMutable;
class MemberGroup;
class MemberList;
class MemberVector;
class ModuleDef;
class NamespaceDef;
class OutputList;
class TagInfo;
 
/** A model of a class/file/namespace member symbol. */
class MemberDef : public Definition
{
  public:
    ABSTRACT_BASE_CLASS(MemberDef)
 
    // move this member into a different scope
    virtual std::unique_ptr<MemberDef> deepCopy() const =0;
    virtual void moveTo(Definition *) = 0;
 
    virtual MemberDef *resolveAlias() = 0;
    virtual const MemberDef *resolveAlias() const = 0;
 
 
    //-----------------------------------------------------------------------------------
    // ----  getters -----
    //-----------------------------------------------------------------------------------
 
    virtual DString declaration() const = 0;
    virtual DString definition() const = 0;
    virtual DString typeString() const = 0;
    virtual DString argsString() const = 0;
    virtual DString excpString() const = 0;
    virtual DString bitfieldString() const = 0;
    virtual DString extraTypeChars() const = 0;
    virtual const DString &initializer() const = 0;
    virtual int initializerLines() const = 0;
    virtual TypeSpecifier getMemberSpecifiers() const = 0;
    virtual VhdlSpecifier getVhdlSpecifiers() const = 0;
    virtual const MemberList *getSectionList(const Definition *container) const = 0;
    virtual DString    displayDefinition() const = 0;
 
    // scope query members
    virtual const FileDef *     getFileDef() const      = 0;
    virtual       FileDef *     getFileDef()            = 0;
    virtual const ClassDef *    getClassDef() const     = 0;
    virtual       ClassDef *    getClassDef()           = 0;
    virtual const NamespaceDef* getNamespaceDef() const = 0;
    virtual       NamespaceDef* getNamespaceDef()       = 0;
    virtual const ModuleDef*    getModuleDef() const    = 0;
 
    // grabbing the property read/write accessor names
    virtual DString getReadAccessor() const = 0;
    virtual DString getWriteAccessor() const = 0;
 
    // querying the grouping definition
    virtual GroupDef *getGroupDef() = 0;
    virtual const GroupDef *getGroupDef() const = 0;
    virtual Grouping::GroupPri_t getGroupPri() const = 0;
    virtual DString getGroupFileName() const = 0;
    virtual int getGroupStartLine() const = 0;
    virtual bool getGroupHasDocs() const = 0;
 
    virtual DString objCMethodName(bool localLink,bool showStatic) const = 0;
 
    // direct kind info
    virtual Protection protection() const = 0;
    virtual Specifier virtualness(int count=0) const = 0;
    virtual MemberType memberType() const = 0;
    virtual DString   memberTypeName() const = 0;
 
    // getter methods
    virtual bool isSignal() const = 0;
    virtual bool isSlot() const = 0;
    virtual bool isVariable() const = 0;
    virtual bool isEnumerate() const = 0;
    virtual bool isEnumValue() const = 0;
    virtual bool isTypedef() const = 0;
    virtual bool isSequence() const = 0;
    virtual bool isDictionary() const = 0;
    virtual bool isFunction() const = 0;
    virtual bool isFunctionPtr() const = 0;
    virtual bool isDefine() const = 0;
    virtual bool isFriend() const = 0;
    virtual bool isDCOP() const = 0;
    virtual bool isProperty() const = 0;
    virtual bool isEvent() const = 0;
    virtual bool isRelated() const = 0;
    virtual bool isForeign() const = 0;
    virtual bool isStatic() const = 0;
    virtual bool isInline() const = 0;
    virtual bool isExplicit() const = 0;
    virtual bool isMutable() const = 0;
    virtual bool isThreadLocal() const = 0;
    virtual bool isGettable() const = 0;
    virtual bool isPrivateGettable() const = 0;
    virtual bool isProtectedGettable() const = 0;
    virtual bool isSettable() const = 0;
    virtual bool isPrivateSettable() const = 0;
    virtual bool isProtectedSettable() const = 0;
    virtual bool isReadable() const = 0;
    virtual bool isWritable() const = 0;
    virtual bool isAddable() const = 0;
    virtual bool isRemovable() const = 0;
    virtual bool isRaisable() const = 0;
    virtual bool isFinal() const = 0;
    virtual bool isAbstract() const = 0;
    virtual bool isOverride() const = 0;
    virtual bool isInitonly() const = 0;
    virtual bool isOptional() const = 0;
    virtual bool isRequired() const = 0;
    virtual bool isNonAtomic() const = 0;
    virtual bool isCopy() const = 0;
    virtual bool isAssign() const = 0;
    virtual bool isRetain() const = 0;
    virtual bool isWeak() const = 0;
    virtual bool isStrong() const = 0;
    virtual bool isEnumStruct() const = 0;
    virtual bool isUnretained() const = 0;
    virtual bool isNew() const = 0;
    virtual bool isSealed() const = 0;
    virtual bool isImplementation() const = 0;
    virtual bool isExternal() const = 0;
    virtual bool isTypeAlias() const = 0;
    virtual bool isDefault() const = 0;
    virtual bool isDelete() const = 0;
    virtual bool isNoExcept() const = 0;
    virtual bool isAttribute() const = 0; // UNO IDL attribute
    virtual bool isUNOProperty() const = 0; // UNO IDL property
    virtual bool isReadonly() const = 0;
    virtual bool isBound() const = 0;
    virtual bool isConstrained() const = 0;
    virtual bool isTransient() const = 0;
    virtual bool isMaybeVoid() const = 0;
    virtual bool isMaybeDefault() const = 0;
    virtual bool isMaybeAmbiguous() const = 0;
    virtual bool isPublished() const = 0; // UNO IDL published
    virtual bool isTemplateSpecialization() const = 0;
    virtual bool isObjCMethod() const = 0;
    virtual bool isObjCProperty() const = 0;
    virtual bool isCSharpProperty() const = 0;
    virtual bool isConstructor() const = 0;
    virtual bool isDestructor() const = 0;
    virtual bool hasOneLineInitializer() const = 0;
    virtual bool hasMultiLineInitializer() const = 0;
    virtual bool isCallable() const = 0;
    virtual bool isStrongEnumValue() const = 0;
    virtual bool livesInsideEnum() const = 0;
    virtual bool isSliceLocal() const = 0;
    virtual bool isConstExpr() const = 0;
    virtual bool isConstEval() const = 0;
    virtual bool isConstInit() const = 0;
    virtual bool isNoDiscard() const = 0;
    virtual int  numberOfFlowKeyWords() const = 0;
 
    // derived getters
    virtual bool isFriendToHide() const = 0;
    virtual bool isNotFriend() const = 0;
    virtual bool isFunctionOrSignalSlot() const = 0;
    virtual bool isRelatedOrFriend() const = 0;
 
    // output info
    virtual bool isDeleted() const = 0;
    virtual bool isBriefSectionVisible() const = 0;
    virtual bool isDetailedSectionVisible(MemberListContainer container) const = 0;
    virtual bool hasDetailedDescription() const = 0;
    virtual bool isFriendClass() const = 0;
    virtual bool isDocumentedFriendClass() const = 0;
 
    virtual const MemberDef *reimplements() const = 0;
    virtual const MemberVector &reimplementedBy() const = 0;
    virtual bool isReimplementedBy(const ClassDef *cd) const = 0;
 
    virtual ClassDef *relatedAlso() const = 0;
 
    virtual bool hasDocumentedEnumValues() const = 0;
    virtual const MemberDef *getAnonymousEnumType() const = 0;
    virtual bool isDocsForDefinition() const = 0;
    virtual const MemberDef *getEnumScope() const = 0;
    virtual const MemberVector &enumFieldList() const = 0;
    virtual DString enumBaseType() const = 0;
 
    virtual bool hasExamples() const = 0;
    virtual const ExampleList &getExamples() const = 0;
    virtual bool isPrototype() const = 0;
 
    // argument related members
    virtual const ArgumentList &argumentList() const = 0;
    virtual const ArgumentList &declArgumentList() const = 0;
    virtual const ArgumentList &templateArguments() const = 0;
    virtual const ArgumentLists &definitionTemplateParameterLists() const = 0;
    virtual std::optional<ArgumentList> formalTemplateArguments() const = 0;
 
    // member group related members
    virtual int getMemberGroupId() const = 0;
    virtual MemberGroup *getMemberGroup() const = 0;
 
    // callgraph related members
    virtual bool hasCallGraph() const = 0;
    virtual bool hasCallerGraph() const = 0;
    // referenced related members
    virtual bool hasReferencesRelation() const = 0;
    virtual bool hasReferencedByRelation() const = 0;
 
    virtual bool hasInlineSource() const = 0;
    virtual bool hasEnumValues() const = 0;
 
    virtual bool isDocTransferDone() const = 0;
 
    virtual DString sourceRefName() const = 0;
 
    virtual const MemberDef *templateMaster() const = 0;
    virtual DString getScopeString() const = 0;
    virtual const ClassDef *getClassDefOfAnonymousType() const = 0;
 
    // cached typedef functions
    virtual bool isTypedefValCached() const = 0;
    virtual const ClassDef *getCachedTypedefVal() const = 0;
    virtual DString getCachedTypedefTemplSpec() const = 0;
    virtual DString getCachedResolvedTypedef() const = 0;
 
    virtual MemberDef *memberDefinition() const = 0;
    virtual MemberDef *memberDeclaration() const = 0;
    virtual const MemberDef *inheritsDocsFrom() const = 0;
    virtual const MemberDef *getGroupAlias() const = 0;
 
    virtual ClassDef *category() const = 0;
    virtual const MemberDef *categoryRelation() const = 0;
 
    virtual DString getDeclType() const = 0;
    virtual StringVector getLabels(const Definition *container) const = 0;
    virtual StringVector getQualifiers() const = 0;
 
    virtual const ArgumentList &typeConstraints() const = 0;
 
    virtual DString requiresClause() const = 0;
 
    virtual DString fieldType() const = 0;
 
    virtual DString getDeclFileName() const = 0;
    virtual int getDeclLine() const = 0;
    virtual size_t getDeclColumn() const = 0;
 
    virtual std::unique_ptr<MemberDef> createTemplateInstanceMember(const ArgumentList &formalArgs,
               const std::unique_ptr<ArgumentList> &actualArgs) const = 0;
    virtual void writeDeclaration(OutputList &ol,
                 const ClassDef *cd,const NamespaceDef *nd,const FileDef *fd,const GroupDef *gd,const ModuleDef *md,
                 bool inGroup, int indentLevel=0, const ClassDef *inheritFrom=nullptr,const DString &inheritId=DString()) const = 0;
    virtual void writeEnumDeclaration(OutputList &typeDecl, const ClassDef *cd,
                const NamespaceDef *nd,const FileDef *fd,const GroupDef *gd,const ModuleDef *mod) const = 0;
    virtual void writeLink(OutputList &ol,
                 const ClassDef *cd,const NamespaceDef *nd,const FileDef *fd,const GroupDef *gd,const ModuleDef *md,
                 bool onlyText=false) const = 0;
    virtual void detectUndocumentedParams(bool hasParamCommand,bool hasReturnCommand) const = 0;
    virtual void warnIfUndocumented() const = 0;
    virtual void warnIfUndocumentedParams() const = 0;
    virtual bool visibleInIndex() const = 0;
    virtual int redefineCount() const = 0;
 
    // TODO: this is not a getter, should be passed at construction
    virtual void setMemberGroup(MemberGroup *grp) = 0;
 
};
 
class MemberDefMutable : public DefinitionMutable, public MemberDef
{
  public:
    ABSTRACT_BASE_CLASS(MemberDefMutable)
 
    //-----------------------------------------------------------------------------------
    // ----  setters -----
    //-----------------------------------------------------------------------------------
 
    // set functions
    virtual void setMemberType(MemberType t) = 0;
    virtual void setDefinition(const DString &d) = 0;
    virtual void setFileDef(FileDef *fd) = 0;
    virtual void setAnchor() = 0;
    virtual void setProtection(Protection p) = 0;
    virtual void setMemberSpecifiers(TypeSpecifier s) = 0;
    virtual void setVhdlSpecifiers(VhdlSpecifier s) = 0;
    virtual void mergeMemberSpecifiers(TypeSpecifier s) = 0;
    virtual void setInitializer(const DString &i) = 0;
    virtual void setBitfields(const DString &s) = 0;
    virtual void setMaxInitLines(int lines) = 0;
    virtual void setMemberClass(ClassDef *cd) = 0;
    virtual void setSectionList(const Definition *container,const MemberList *sl) = 0;
    virtual void setGroupDef(GroupDef *gd,Grouping::GroupPri_t pri,
                     const DString &fileName,int startLine,bool hasDocs,
                     MemberDef *member=nullptr) = 0;
    virtual void setReadAccessor(const DString &r) = 0;
    virtual void setWriteAccessor(const DString &w) = 0;
    virtual void setTemplateSpecialization(bool b) = 0;
 
    virtual void makeRelated() = 0;
    virtual void makeForeign() = 0;
    virtual void setInheritsDocsFrom(const MemberDef *md) = 0;
    virtual void setTagInfo(const TagInfo *i) = 0;
    virtual void setArgsString(const DString &as) = 0;
    virtual void incrementFlowKeyWordCount() = 0;
    virtual void setEnumBaseType(const DString &type) = 0;
    virtual void setDocTransferDone() = 0;
    virtual void setExplicitInherited(bool b) = 0;
 
    // relation to other members
    virtual void setReimplements(MemberDef *md) = 0;
    virtual void insertReimplementedBy(MemberDef *md) = 0;
 
    virtual void setRelatedAlso(ClassDef *cd) = 0;
 
    // enumeration specific members
    virtual void insertEnumField(MemberDef *md) = 0;
    virtual void setEnumScope(MemberDef *md,bool livesInsideEnum=false) = 0;
    virtual void setEnumClassScope(ClassDef *cd) = 0;
    virtual void setDocumentedEnumValues(bool value) = 0;
    virtual void setAnonymousEnumType(const MemberDef *md) = 0;
 
    // example related members
    virtual bool addExample(const DString &anchor,const DString &name,const DString &file) = 0;
 
    // prototype related members
    virtual void setPrototype(bool p,const DString &df,int line, size_t column) = 0;
    virtual void setExplicitExternal(bool b,const DString &df,int line,size_t column) = 0;
    virtual void setDeclFile(const DString &df,int line,size_t column) = 0;
 
    // argument related members
    virtual void moveArgumentList(std::unique_ptr<ArgumentList> al) = 0;
    virtual void moveDeclArgumentList(std::unique_ptr<ArgumentList> al) = 0;
    virtual void resolveUnnamedParameters(const MemberDef *md) = 0;
    virtual void setDefinitionTemplateParameterLists(const ArgumentLists &lists) = 0;
    virtual void setTypeConstraints(const ArgumentList &al) = 0;
    virtual void setType(const DString &t) = 0;
 
    // namespace related members
    virtual void setNamespace(NamespaceDef *nd) = 0;
 
    // member group related members
    virtual void setMemberGroupId(int id) = 0;
    virtual void makeImplementationDetail() = 0;
 
    // anonymous scope members
    virtual void setClassDefOfAnonymousType(const ClassDef *cd) = 0;
 
    virtual void overrideCallGraph(bool e) = 0;
    virtual void overrideCallerGraph(bool e) = 0;
    virtual void overrideReferencedByRelation(bool e) = 0;
    virtual void overrideReferencesRelation(bool e) = 0;
    virtual void overrideInlineSource(bool e) = 0;
    virtual void overrideEnumValues(bool e) = 0;
 
    virtual void setTemplateMaster(const MemberDef *mt) = 0;
    virtual void setFormalTemplateArguments(const ArgumentList &al) = 0;
    virtual void addListReference(const Definition *) = 0;
    virtual void addRequirementReferences(const Definition *) = 0;
    virtual void setDocsForDefinition(bool b) = 0;
    virtual void setGroupAlias(const MemberDef *md) = 0;
 
    virtual void cacheTypedefVal(const ClassDef *val,const DString &templSpec,const DString &resolvedType) = 0;
    virtual void invalidateTypedefValCache() = 0;
 
    virtual void invalidateCachedArgumentTypes() = 0;
 
    // declaration <-> definition relation
    virtual void setMemberDefinition(MemberDef *md) = 0;
    virtual void setMemberDeclaration(MemberDef *md) = 0;
 
    virtual void copyArgumentNames(const MemberDef *bmd) = 0;
 
    virtual void setCategory(ClassDef *) = 0;
    virtual void setCategoryRelation(const MemberDef *) = 0;
 
    virtual void setRequiresClause(const DString &req) = 0;
 
    virtual void addQualifiers(const StringVector &qualifiers) = 0;
 
    virtual void setModuleDef(ModuleDef *mod) = 0;
 
 
    // macro redefinition
    virtual void setRedefineCount(int count) = 0;
 
    //-----------------------------------------------------------------------------------
    // --- actions ----
    //-----------------------------------------------------------------------------------
 
    virtual void findSectionsInDocumentation() = 0;
    //virtual void addToSearchIndex() const = 0;
 
    virtual ClassDefMutable *getClassDefMutable() = 0;
 
    //-----------------------------------------------------------------------------------
    // --- write output ----
    //-----------------------------------------------------------------------------------
 
    virtual void writeDocumentation(const MemberList *ml,int memCount,int memTotal,OutputList &ol,
                 const DString &scopeName,const Definition *container,
                 bool inGroup,bool showEnumValues=false,bool
                 showInline=false) const = 0;
    virtual void writeMemberDocSimple(OutputList &ol,const Definition *container) const = 0;
    virtual void writeTagFile(TextStream &,bool useQualifiedName,bool showNamespaceMembers) const = 0;
};
 
 
// --- Cast functions
 
MemberDef            *toMemberDef(Definition *d);
MemberDef            *toMemberDef(DefinitionMutable *d);
const MemberDef      *toMemberDef(const Definition *d);
MemberDefMutable     *toMemberDefMutable(Definition *d);
 
//------------------------------------------------------------------------
 
 
/** Factory method to create a new instance of a MemberDef */
std::unique_ptr<MemberDef> createMemberDef(const DString &defFileName,int defLine,size_t defColumn,
              const DString &type,const DString &name,const DString &args,
              const DString &excp,Protection prot,Specifier virt,bool stat,
              Relationship related,MemberType t,const ArgumentList &tal,
              const ArgumentList &al,const DString &metaData);
 
std::unique_ptr<MemberDef> createMemberDefAlias(const Definition *newScope,const MemberDef *aliasMd);
 
void combineDeclarationAndDefinition(MemberDefMutable *mdec,MemberDefMutable *mdef);
void mergeMemberOverrideOptions(MemberDefMutable *md1,MemberDefMutable *md2);
void addDocCrossReference(const MemberDef *src,const MemberDef *dst);
 
#endif