Doxygen
Loading...
Searching...
No Matches
DocMermaidFile Class Referencefinal

Node representing a mermaid file. More...

#include <src/docnode.h>

Inheritance diagram for DocMermaidFile:
Collaboration diagram for DocMermaidFile:

Public Member Functions

 DocMermaidFile (DocParser *parser, DocNodeVariant *parent, const DString &name, const DString &context, const DString &srcFile, int srcLine)
bool parse ()
Public Member Functions inherited from DocDiagramFileBase
 DocDiagramFileBase (DocParser *parser, DocNodeVariant *parent, const DString &name, const DString &context, const DString &srcFile, int srcLine)
DString name () const
DString file () const
DString relPath () const
bool hasCaption () const
DString width () const
DString height () const
DString context () const
DString srcFile () const
int srcLine () const
Public Member Functions inherited from DocCompoundNode
 DocCompoundNode (DocParser *parser, DocNodeVariant *parent)
DocNodeListchildren ()
const DocNodeListchildren () const
Public Member Functions inherited from DocNode
 DocNode (DocParser *parser, DocNodeVariant *parent)
 ~DocNode ()=default
DocNodeVariantparent ()
const DocNodeVariantparent () const
DocNodeVariantthisVariant ()
const DocNodeVariantthisVariant () const
void setThisVariant (DocNodeVariant *thisVariant)
DocParserparser ()
const DocParserparser () const
void setParent (DocNodeVariant *parent)
bool isPreformatted () const

Additional Inherited Members

Protected Types inherited from DocNode
enum  RefType {
  Unknown , Anchor , Section , Table ,
  Requirement
}
Protected Member Functions inherited from DocNode
void setInsidePreformatted (bool p)
Protected Attributes inherited from DocDiagramFileBase
std::unique_ptr< Privatep

Detailed Description

Node representing a mermaid file.

Definition at line 748 of file docnode.h.

Constructor & Destructor Documentation

◆ DocMermaidFile()

DocMermaidFile::DocMermaidFile ( DocParser * parser,
DocNodeVariant * parent,
const DString & name,
const DString & context,
const DString & srcFile,
int srcLine )

Definition at line 1288 of file docnode.cpp.

1289 :
1291{
1292 p->relPath = parser->context.relPath;
1293}
DString name() const
Definition docnode.h:684
DocDiagramFileBase(DocParser *parser, DocNodeVariant *parent, const DString &name, const DString &context, const DString &srcFile, int srcLine)
Definition docnode.h:681
DString srcFile() const
Definition docnode.h:691
std::unique_ptr< Private > p
Definition docnode.h:708
DString context() const
Definition docnode.h:690
int srcLine() const
Definition docnode.h:692
DocParser * parser()
Definition docnode.h:98
DocNodeVariant * parent()
Definition docnode.h:90
DocParserContext context

References DocDiagramFileBase::context(), DocParser::context, DocDiagramFileBase::DocDiagramFileBase(), DocDiagramFileBase::name(), DocDiagramFileBase::p, parent(), DocNode::parser(), DocParserContext::relPath, DocDiagramFileBase::srcFile(), and DocDiagramFileBase::srcLine().

Member Function Documentation

◆ parse()

bool DocMermaidFile::parse ( )

Definition at line 1295 of file docnode.cpp.

1296{
1297 bool ok = false;
1299
1300 bool ambig = false;
1301 FileDef *fd = Doxygen::mermaidFileNameLinkedMap->findFileDef(p->name,ambig);
1302 if (fd==nullptr && !p->name.endsWith(".mmd")) // try with .mmd extension as well
1303 {
1304 fd = Doxygen::mermaidFileNameLinkedMap->findFileDef(p->name+".mmd",ambig);
1305 }
1306 if (fd)
1307 {
1308 p->file = fd->absFilePath();
1309 ok = true;
1310 if (ambig)
1311 {
1312 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"included mermaid file name '{}' is ambiguous.\n"
1313 "Possible candidates:\n{}",p->name,
1315 );
1316 }
1317 }
1318 else
1319 {
1320 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"included mermaid file '{}' is not found "
1321 "in any of the paths specified via MERMAIDFILE_DIRS!",p->name);
1322 }
1323 return ok;
1324}
DocNodeList & children()
Definition docnode.h:143
DocNodeVariant * thisVariant()
Definition docnode.h:93
void defaultHandleTitleAndSize(const CommandType cmd, DocNodeVariant *parent, DocNodeList &children, DString &width, DString &height)
static FileNameLinkedMap * mermaidFileNameLinkedMap
Definition doxygen.h:110
virtual DString absFilePath() const =0
DString showFileDefMatches(const DString &n) const
Returns a list of file definitions in fnMap that match the file name n.
Definition filename.cpp:129
FileDef * findFileDef(const DString &n, bool &ambig) const
Returns the file definition in fnMap that matches the file name n.
Definition filename.cpp:36
#define warn_doc_error(file, line, fmt,...)
Definition message.h:112

References FileDef::absFilePath(), DocCompoundNode::children(), CMD_MERMAIDFILE, DocDiagramFileBase::context(), DocParser::defaultHandleTitleAndSize(), FileNameLinkedMap::findFileDef(), Doxygen::mermaidFileNameLinkedMap, DocDiagramFileBase::p, DocNode::parser(), FileNameLinkedMap::showFileDefMatches(), DocNode::thisVariant(), and warn_doc_error.


The documentation for this class was generated from the following files: