Doxygen
Loading...
Searching...
No Matches
xmlgen.cpp File Reference
#include <stdlib.h>
#include "textstream.h"
#include "xmlgen.h"
#include "doxygen.h"
#include "message.h"
#include "config.h"
#include "classlist.h"
#include "util.h"
#include "defargs.h"
#include "outputgen.h"
#include "outputlist.h"
#include "dot.h"
#include "dotclassgraph.h"
#include "dotincldepgraph.h"
#include "pagedef.h"
#include "filename.h"
#include "version.h"
#include "xmldocvisitor.h"
#include "docparser.h"
#include "language.h"
#include "parserintf.h"
#include "arguments.h"
#include "memberlist.h"
#include "groupdef.h"
#include "memberdef.h"
#include "namespacedef.h"
#include "membername.h"
#include "membergroup.h"
#include "dirdef.h"
#include "section.h"
#include "htmlentity.h"
#include "resourcemgr.h"
#include "dir.h"
#include "utf8.h"
#include "portable.h"
#include "moduledef.h"
Include dependency graph for xmlgen.cpp:

Go to the source code of this file.

Classes

class  TextGeneratorXMLImpl
 Implements TextGeneratorIntf for an XML stream. More...

Macros

#define XML_DB(x)

Functions

static void writeXMLDocBlock (TextStream &t, const QCString &fileName, int lineNr, const Definition *scope, const MemberDef *md, const QCString &text)
void writeXMLString (TextStream &t, const QCString &s)
void writeXMLCodeString (bool hide, TextStream &t, const QCString &str, size_t &col, size_t stripIndentAmount)
static void writeXMLHeader (TextStream &t)
static void writeCombineScript ()
void writeXMLLink (TextStream &t, const QCString &extRef, const QCString &compoundId, const QCString &anchorId, const QCString &text, const QCString &tooltip)
static void writeTemplateArgumentList (TextStream &t, const ArgumentList &al, const Definition *scope, const FileDef *fileScope, int indent)
static void writeMemberTemplateLists (const MemberDef *md, TextStream &t)
static void writeTemplateList (const ClassDef *cd, TextStream &t)
static void writeTemplateList (const ConceptDef *cd, TextStream &t)
void writeXMLCodeBlock (TextStream &t, FileDef *fd)
static void writeMemberReference (TextStream &t, const Definition *def, const MemberDef *rmd, const QCString &tagName)
static void stripAnonymousMarkers (QCString &s)
static void stripQualifiers (QCString &typeStr)
static QCString classOutputFileBase (const ClassDef *cd)
static QCString memberOutputFileBase (const MemberDef *md)
static bool stripKeyword (QCString &str, const char *keyword, bool needSpace)
static QCString extractNoExcept (QCString &argsStr)
static void generateXMLForMember (const MemberDef *md, TextStream &ti, TextStream &t, const Definition *def)
static bool memberVisible (const Definition *d, const MemberDef *md)
static void generateXMLSection (const Definition *d, TextStream &ti, TextStream &t, const MemberList *ml, const QCString &kind, const QCString &header=QCString(), const QCString &documentation=QCString())
static void writeListOfAllMembers (const ClassDef *cd, TextStream &t)
static void writeInnerClasses (const ClassLinkedRefMap &cl, TextStream &t)
static void writeInnerConcepts (const ConceptLinkedRefMap &cl, TextStream &t)
static void writeInnerModules (const ModuleLinkedRefMap &ml, TextStream &t)
static void writeInnerNamespaces (const NamespaceLinkedRefMap &nl, TextStream &t)
static void writeExports (const ImportInfoMap &exportMap, TextStream &t)
static void writeInnerFiles (const FileList &fl, TextStream &t)
static void writeInnerPages (const PageLinkedRefMap &pl, TextStream &t)
static void writeInnerGroups (const GroupList &gl, TextStream &t)
static void writeInnerDirs (const DirList *dl, TextStream &t)
static void writeIncludeInfo (const IncludeInfo *ii, TextStream &t)
static void generateXMLForClass (const ClassDef *cd, TextStream &ti)
static void generateXMLForConcept (const ConceptDef *cd, TextStream &ti)
static void generateXMLForModule (const ModuleDef *mod, TextStream &ti)
static void generateXMLForNamespace (const NamespaceDef *nd, TextStream &ti)
static void generateXMLForFile (FileDef *fd, TextStream &ti)
static void generateXMLForGroup (const GroupDef *gd, TextStream &ti)
static void generateXMLForDir (DirDef *dd, TextStream &ti)
static void generateXMLForPage (PageDef *pd, TextStream &ti, bool isExample)
void generateXML ()

Macro Definition Documentation

◆ XML_DB

Function Documentation

◆ classOutputFileBase()

QCString classOutputFileBase ( const ClassDef * cd)
static

Definition at line 572 of file xmlgen.cpp.

573{
574 //bool inlineGroupedClasses = Config_getBool(INLINE_GROUPED_CLASSES);
575 //if (inlineGroupedClasses && cd->partOfGroups()!=0)
576 return cd->getOutputFileBase();
577 //else
578 // return cd->getOutputFileBase();
579}
virtual QCString getOutputFileBase() const =0

References Definition::getOutputFileBase().

Referenced by generateXMLForClass(), and writeInnerClasses().

◆ extractNoExcept()

QCString extractNoExcept ( QCString & argsStr)
static

Definition at line 639 of file xmlgen.cpp.

640{
641 QCString expr;
642 //printf("extractNoExcept(%s)\n",qPrint(argsStr));
643 int i = argsStr.find("noexcept(");
644 if (i!=-1)
645 {
646 int bracketCount = 1;
647 size_t p = i+9;
648 bool found = false;
649 bool insideString = false;
650 bool insideChar = false;
651 char pc = 0;
652 while (!found && p<argsStr.length())
653 {
654 char c = argsStr[p++];
655 if (insideString)
656 {
657 if (c=='"' && pc!='\\') insideString=false;
658 }
659 else if (insideChar)
660 {
661 if (c=='\'' && pc!='\\') insideChar=false;
662 }
663 else
664 {
665 switch (c)
666 {
667 case '(': bracketCount++; break;
668 case ')': bracketCount--; found = bracketCount==0; break;
669 case '"': insideString = true; break;
670 case '\'': insideChar = true; break;
671 }
672 }
673 pc = c;
674 }
675 expr = argsStr.mid(i+9,p-i-10);
676 argsStr = (argsStr.left(i) + argsStr.mid(p)).stripWhiteSpace();
677 }
678 //printf("extractNoExcept -> argsStr='%s', expr='%s'\n",qPrint(argsStr),qPrint(expr));
679 return expr;
680}
This is an alternative implementation of QCString.
Definition qcstring.h:101
int find(char c, int index=0, bool cs=TRUE) const
Definition qcstring.cpp:43
size_t length() const
Returns the length of the string, not counting the 0-terminator.
Definition qcstring.h:166
QCString mid(size_t index, size_t len=static_cast< size_t >(-1)) const
Definition qcstring.h:241
QCString stripWhiteSpace() const
returns a copy of this string with leading and trailing whitespace removed
Definition qcstring.h:260
QCString left(size_t len) const
Definition qcstring.h:229

References QCString::find(), QCString::left(), QCString::length(), QCString::mid(), and QCString::stripWhiteSpace().

Referenced by generateXMLForMember().

◆ generateXML()

void generateXML ( )

Definition at line 2214 of file xmlgen.cpp.

2215{
2216 // + classes
2217 // + concepts
2218 // + namespaces
2219 // + files
2220 // + groups
2221 // + related pages
2222 // - examples
2223
2224 QCString outputDirectory = Config_getString(XML_OUTPUT);
2225 Dir xmlDir(outputDirectory.str());
2226 createSubDirs(xmlDir);
2227
2228 ResourceMgr::instance().copyResource("xml.xsd",outputDirectory);
2229 ResourceMgr::instance().copyResource("index.xsd",outputDirectory);
2230
2231 QCString fileName=outputDirectory+"/compound.xsd";
2232 std::ofstream f = Portable::openOutputStream(fileName);
2233 if (!f.is_open())
2234 {
2235 err("Cannot open file {} for writing!\n",fileName);
2236 return;
2237 }
2238 {
2239 TextStream t(&f);
2240
2241 // write compound.xsd, but replace special marker with the entities
2242 QCString compound_xsd = ResourceMgr::instance().getAsString("compound.xsd");
2243 const char *startLine = compound_xsd.data();
2244 while (*startLine)
2245 {
2246 // find end of the line
2247 const char *endLine = startLine+1;
2248 while (*endLine && *(endLine-1)!='\n') endLine++; // skip to end of the line including \n
2249 int len=static_cast<int>(endLine-startLine);
2250 if (len>0)
2251 {
2252 QCString s(startLine,len);
2253 if (s.find("<!-- Automatically insert here the HTML entities -->")!=-1)
2254 {
2256 }
2257 else
2258 {
2259 t.write(startLine,len);
2260 }
2261 }
2262 startLine=endLine;
2263 }
2264 }
2265 f.close();
2266
2267 fileName=outputDirectory+"/doxyfile.xsd";
2268 f = Portable::openOutputStream(fileName);
2269 if (!f.is_open())
2270 {
2271 err("Cannot open file {} for writing!\n",fileName);
2272 return;
2273 }
2274 {
2275 TextStream t(&f);
2276
2277 // write doxyfile.xsd, but replace special marker with the entities
2278 QCString doxyfile_xsd = ResourceMgr::instance().getAsString("doxyfile.xsd");
2279 const char *startLine = doxyfile_xsd.data();
2280 while (*startLine)
2281 {
2282 // find end of the line
2283 const char *endLine = startLine+1;
2284 while (*endLine && *(endLine-1)!='\n') endLine++; // skip to end of the line including \n
2285 int len=static_cast<int>(endLine-startLine);
2286 if (len>0)
2287 {
2288 QCString s(startLine,len);
2289 if (s.find("<!-- Automatically insert here the configuration settings -->")!=-1)
2290 {
2292 }
2293 else
2294 {
2295 t.write(startLine,len);
2296 }
2297 }
2298 startLine=endLine;
2299 }
2300 }
2301 f.close();
2302
2303 fileName=outputDirectory+"/Doxyfile.xml";
2304 f = Portable::openOutputStream(fileName);
2305 if (!f.is_open())
2306 {
2307 err("Cannot open file {} for writing\n",fileName);
2308 return;
2309 }
2310 else
2311 {
2312 TextStream t(&f);
2314 }
2315 f.close();
2316
2317 fileName=outputDirectory+"/index.xml";
2318 f = Portable::openOutputStream(fileName);
2319 if (!f.is_open())
2320 {
2321 err("Cannot open file {} for writing!\n",fileName);
2322 return;
2323 }
2324 else
2325 {
2326 TextStream t(&f);
2327
2328 // write index header
2329 t << "<?xml version='1.0' encoding='UTF-8' standalone='no'?>\n";
2330 t << "<doxygenindex xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" ";
2331 t << "xsi:noNamespaceSchemaLocation=\"index.xsd\" ";
2332 t << "version=\"" << getDoxygenVersion() << "\" ";
2333 t << "xml:lang=\"" << theTranslator->trISOLang() << "\"";
2334 t << ">\n";
2335
2336 for (const auto &cd : *Doxygen::classLinkedMap)
2337 {
2338 generateXMLForClass(cd.get(),t);
2339 }
2340 for (const auto &cd : *Doxygen::conceptLinkedMap)
2341 {
2342 msg("Generating XML output for concept {}\n",cd->displayName());
2343 generateXMLForConcept(cd.get(),t);
2344 }
2345 for (const auto &nd : *Doxygen::namespaceLinkedMap)
2346 {
2347 msg("Generating XML output for namespace {}\n",nd->displayName());
2348 generateXMLForNamespace(nd.get(),t);
2349 }
2350 for (const auto &fn : *Doxygen::inputNameLinkedMap)
2351 {
2352 for (const auto &fd : *fn)
2353 {
2354 msg("Generating XML output for file {}\n",fd->name());
2355 generateXMLForFile(fd.get(),t);
2356 }
2357 }
2358 for (const auto &gd : *Doxygen::groupLinkedMap)
2359 {
2360 msg("Generating XML output for group {}\n",gd->name());
2361 generateXMLForGroup(gd.get(),t);
2362 }
2363 for (const auto &pd : *Doxygen::pageLinkedMap)
2364 {
2365 msg("Generating XML output for page {}\n",pd->name());
2366 generateXMLForPage(pd.get(),t,FALSE);
2367 }
2368 for (const auto &dd : *Doxygen::dirLinkedMap)
2369 {
2370 msg("Generate XML output for dir {}\n",dd->name());
2371 generateXMLForDir(dd.get(),t);
2372 }
2373 for (const auto &mod : ModuleManager::instance().modules())
2374 {
2375 msg("Generating XML output for module {}\n",mod->name());
2376 generateXMLForModule(mod.get(),t);
2377 }
2378 for (const auto &pd : *Doxygen::exampleLinkedMap)
2379 {
2380 msg("Generating XML output for example {}\n",pd->name());
2381 generateXMLForPage(pd.get(),t,TRUE);
2382 }
2384 {
2385 msg("Generating XML output for the main page\n");
2387 }
2388
2389 //t << " </compoundlist>\n";
2390 t << "</doxygenindex>\n";
2391 }
2392
2394 clearSubDirs(xmlDir);
2395}
Class representing a directory in the file system.
Definition dir.h:75
static NamespaceLinkedMap * namespaceLinkedMap
Definition doxygen.h:115
static ConceptLinkedMap * conceptLinkedMap
Definition doxygen.h:98
static std::unique_ptr< PageDef > mainPage
Definition doxygen.h:101
static FileNameLinkedMap * inputNameLinkedMap
Definition doxygen.h:105
static ClassLinkedMap * classLinkedMap
Definition doxygen.h:96
static PageLinkedMap * exampleLinkedMap
Definition doxygen.h:99
static PageLinkedMap * pageLinkedMap
Definition doxygen.h:100
static DirLinkedMap * dirLinkedMap
Definition doxygen.h:129
static GroupLinkedMap * groupLinkedMap
Definition doxygen.h:114
void writeXMLSchema(TextStream &t)
static HtmlEntityMapper & instance()
Returns the one and only instance of the HTML entity mapper.
static ModuleManager & instance()
const std::string & str() const
Definition qcstring.h:552
const char * data() const
Returns a pointer to the contents of the string in the form of a 0-terminated C string.
Definition qcstring.h:172
static ResourceMgr & instance()
Returns the one and only instance of this class.
bool copyResource(const QCString &name, const QCString &targetDir) const
Copies a registered resource to a given target directory.
QCString getAsString(const QCString &name) const
Gets the resource data as a C string.
Text streaming class that buffers data.
Definition textstream.h:36
#define Config_getString(name)
Definition config.h:32
Translator * theTranslator
Definition language.cpp:71
#define msg(fmt,...)
Definition message.h:94
#define err(fmt,...)
Definition message.h:127
void writeXMLDoxyfile(TextStream &t)
void writeXSDDoxyfile(TextStream &t)
std::ofstream openOutputStream(const QCString &name, bool append=false)
Definition portable.cpp:649
#define TRUE
Definition qcstring.h:37
#define FALSE
Definition qcstring.h:34
void clearSubDirs(const Dir &d)
Definition util.cpp:3588
void createSubDirs(const Dir &d)
Definition util.cpp:3561
static void generateXMLForGroup(const GroupDef *gd, TextStream &ti)
Definition xmlgen.cpp:1949
static void generateXMLForClass(const ClassDef *cd, TextStream &ti)
Definition xmlgen.cpp:1493
static void generateXMLForFile(FileDef *fd, TextStream &ti)
Definition xmlgen.cpp:1834
static void generateXMLForNamespace(const NamespaceDef *nd, TextStream &ti)
Definition xmlgen.cpp:1761
static void generateXMLForModule(const ModuleDef *mod, TextStream &ti)
Definition xmlgen.cpp:1706
static void generateXMLForConcept(const ConceptDef *cd, TextStream &ti)
Definition xmlgen.cpp:1660
static void generateXMLForDir(DirDef *dd, TextStream &ti)
Definition xmlgen.cpp:2018
static void generateXMLForPage(PageDef *pd, TextStream &ti, bool isExample)
Definition xmlgen.cpp:2056
static void writeCombineScript()
Definition xmlgen.cpp:134

References Doxygen::classLinkedMap, clearSubDirs(), Doxygen::conceptLinkedMap, Config_getString, ResourceMgr::copyResource(), createSubDirs(), QCString::data(), Doxygen::dirLinkedMap, err, Doxygen::exampleLinkedMap, FALSE, QCString::find(), generateXMLForClass(), generateXMLForConcept(), generateXMLForDir(), generateXMLForFile(), generateXMLForGroup(), generateXMLForModule(), generateXMLForNamespace(), generateXMLForPage(), ResourceMgr::getAsString(), Doxygen::groupLinkedMap, Doxygen::inputNameLinkedMap, HtmlEntityMapper::instance(), ModuleManager::instance(), ResourceMgr::instance(), Doxygen::mainPage, msg, Doxygen::namespaceLinkedMap, Portable::openOutputStream(), Doxygen::pageLinkedMap, QCString::str(), theTranslator, TRUE, TextStream::write(), writeCombineScript(), Config::writeXMLDoxyfile(), HtmlEntityMapper::writeXMLSchema(), and Config::writeXSDDoxyfile().

Referenced by generateOutput().

◆ generateXMLForClass()

void generateXMLForClass ( const ClassDef * cd,
TextStream & ti )
static

Definition at line 1493 of file xmlgen.cpp.

1494{
1495 // + brief description
1496 // + detailed description
1497 // + template argument list(s)
1498 // - include file
1499 // + member groups
1500 // + inheritance diagram
1501 // + list of direct super classes
1502 // + list of direct sub classes
1503 // + list of inner classes
1504 // + collaboration diagram
1505 // + list of all members
1506 // + user defined member sections
1507 // + standard member sections
1508 // + detailed member documentation
1509 // - examples using the class
1510
1511 if (cd->isReference()) return; // skip external references.
1512 if (cd->isHidden()) return; // skip hidden classes.
1513 if (cd->isAnonymous()) return; // skip anonymous compounds.
1514 if (cd->isImplicitTemplateInstance()) return; // skip generated template instances.
1515 if (cd->isArtificial()) return; // skip artificially created classes
1516
1517 msg("Generating XML output for class {}\n",cd->name());
1518
1519 ti << " <compound refid=\"" << classOutputFileBase(cd)
1520 << "\" kind=\"" << cd->compoundTypeString()
1521 << "\"><name>" << convertToXML(cd->name()) << "</name>\n";
1522
1523 QCString outputDirectory = Config_getString(XML_OUTPUT);
1524 QCString fileName=outputDirectory+"/"+ classOutputFileBase(cd)+".xml";
1525 std::ofstream f = Portable::openOutputStream(fileName);
1526 if (!f.is_open())
1527 {
1528 err("Cannot open file {} for writing!\n",fileName);
1529 return;
1530 }
1531 TextStream t(&f);
1532
1533 writeXMLHeader(t);
1534 t << " <compounddef id=\""
1535 << classOutputFileBase(cd) << "\" kind=\""
1536 << cd->compoundTypeString() << "\" language=\""
1537 << langToString(cd->getLanguage()) << "\" prot=\"";
1538 t << to_string_lower(cd->protection());
1539 if (cd->isFinal()) t << "\" final=\"yes";
1540 if (cd->isSealed()) t << "\" sealed=\"yes";
1541 if (cd->isAbstract()) t << "\" abstract=\"yes";
1542 t << "\">\n";
1543 t << " <compoundname>";
1544 QCString nameStr = cd->name();
1545 stripAnonymousMarkers(nameStr);
1546 writeXMLString(t,nameStr);
1547 t << "</compoundname>\n";
1548 for (const auto &bcd : cd->baseClasses())
1549 {
1550 t << " <basecompoundref ";
1551 if (bcd.classDef->isLinkable())
1552 {
1553 t << "refid=\"" << classOutputFileBase(bcd.classDef) << "\" ";
1554 }
1555 if (bcd.prot == Protection::Package) ASSERT(0);
1556 t << "prot=\"";
1557 t << to_string_lower(bcd.prot);
1558 t << "\" virt=\"";
1559 t << to_string_lower(bcd.virt);
1560 t << "\">";
1561 if (!bcd.templSpecifiers.isEmpty())
1562 {
1563 t << convertToXML(
1565 bcd.classDef->name(),bcd.templSpecifiers)
1566 );
1567 }
1568 else
1569 {
1570 t << convertToXML(bcd.classDef->displayName());
1571 }
1572 t << "</basecompoundref>\n";
1573 }
1574 for (const auto &bcd : cd->subClasses())
1575 {
1576 if (bcd.prot == Protection::Package) ASSERT(0);
1577 t << " <derivedcompoundref refid=\""
1578 << classOutputFileBase(bcd.classDef)
1579 << "\" prot=\"";
1580 t << to_string_lower(bcd.prot);
1581 t << "\" virt=\"";
1582 t << to_string_lower(bcd.virt);
1583 t << "\">" << convertToXML(bcd.classDef->displayName())
1584 << "</derivedcompoundref>\n";
1585 }
1586
1588
1590
1591 writeTemplateList(cd,t);
1592 for (const auto &mg : cd->getMemberGroups())
1593 {
1594 generateXMLSection(cd,ti,t,&mg->members(),"user-defined",mg->header(),
1595 mg->documentation());
1596 }
1597
1598 for (const auto &ml : cd->getMemberLists())
1599 {
1600 if (!ml->listType().isDetailed())
1601 {
1602 generateXMLSection(cd,ti,t,ml.get(),ml->listType().toXML());
1603 }
1604 }
1605
1606 if (!cd->requiresClause().isEmpty())
1607 {
1608 t << " <requiresclause>";
1609 linkifyText(TextGeneratorXMLImpl(t),cd,cd->getFileDef(),nullptr,cd->requiresClause());
1610 t << " </requiresclause>\n";
1611 }
1612
1613 for (const auto &qcd : cd->getQualifiers())
1614 {
1615 t << " <qualifier>" << convertToXML(qcd) << "</qualifier>\n";
1616 }
1617
1618 t << " <briefdescription>\n";
1619 writeXMLDocBlock(t,cd->briefFile(),cd->briefLine(),cd,nullptr,cd->briefDescription());
1620 t << " </briefdescription>\n";
1621 t << " <detaileddescription>\n";
1622 writeXMLDocBlock(t,cd->docFile(),cd->docLine(),cd,nullptr,cd->documentation());
1623 t << " </detaileddescription>\n";
1624 DotClassGraph inheritanceGraph(cd,GraphType::Inheritance);
1625 if (!inheritanceGraph.isTrivial())
1626 {
1627 t << " <inheritancegraph>\n";
1628 inheritanceGraph.writeXML(t);
1629 t << " </inheritancegraph>\n";
1630 }
1631 DotClassGraph collaborationGraph(cd,GraphType::Collaboration);
1632 if (!collaborationGraph.isTrivial())
1633 {
1634 t << " <collaborationgraph>\n";
1635 collaborationGraph.writeXML(t);
1636 t << " </collaborationgraph>\n";
1637 }
1638 t << " <location file=\""
1639 << convertToXML(stripFromPath(cd->getDefFileName())) << "\" line=\""
1640 << cd->getDefLine() << "\"" << " column=\""
1641 << cd->getDefColumn() << "\"" ;
1642 if (cd->getStartBodyLine()!=-1)
1643 {
1644 const FileDef *bodyDef = cd->getBodyDef();
1645 if (bodyDef)
1646 {
1647 t << " bodyfile=\"" << convertToXML(stripFromPath(bodyDef->absFilePath())) << "\"";
1648 }
1649 t << " bodystart=\"" << cd->getStartBodyLine() << "\" bodyend=\""
1650 << cd->getEndBodyLine() << "\"";
1651 }
1652 t << "/>\n";
1654 t << " </compounddef>\n";
1655 t << "</doxygen>\n";
1656
1657 ti << " </compound>\n";
1658}
virtual bool isAbstract() const =0
Returns TRUE if there is at least one pure virtual member in this class.
virtual bool isFinal() const =0
Returns TRUE if this class is marked as final.
virtual QCString compoundTypeString() const =0
Returns the type of compound as a string.
virtual const MemberLists & getMemberLists() const =0
Returns the list containing the list of members sorted per type.
virtual const BaseClassList & baseClasses() const =0
Returns the list of base classes from which this class directly inherits.
virtual bool isSealed() const =0
Returns TRUE if this class is marked as sealed.
virtual StringVector getQualifiers() const =0
virtual Protection protection() const =0
Return the protection level (Public,Protected,Private) in which this compound was found.
virtual bool isImplicitTemplateInstance() const =0
virtual const MemberGroupList & getMemberGroups() const =0
Returns the member groups defined for this class.
virtual ClassLinkedRefMap getClasses() const =0
returns the classes nested into this class
virtual FileDef * getFileDef() const =0
Returns the namespace this compound is in, or 0 if it has a global scope.
virtual const IncludeInfo * includeInfo() const =0
virtual QCString requiresClause() const =0
virtual const BaseClassList & subClasses() const =0
Returns the list of sub classes that directly derive from this class.
virtual QCString docFile() const =0
virtual int getEndBodyLine() const =0
virtual SrcLangExt getLanguage() const =0
Returns the programming language this definition was written in.
virtual int docLine() const =0
virtual QCString getDefFileName() const =0
virtual int getDefLine() const =0
virtual const FileDef * getBodyDef() const =0
virtual int briefLine() const =0
virtual QCString briefDescription(bool abbreviate=FALSE) const =0
virtual bool isAnonymous() const =0
virtual bool isHidden() const =0
virtual QCString documentation() const =0
virtual bool isArtificial() const =0
virtual QCString briefFile() const =0
virtual int getStartBodyLine() const =0
virtual int getDefColumn() const =0
virtual bool isReference() const =0
virtual const QCString & name() const =0
Representation of a class inheritance or dependency graph.
A model of a file symbol.
Definition filedef.h:99
virtual QCString absFilePath() const =0
bool isEmpty() const
Returns TRUE iff the string is empty.
Definition qcstring.h:163
Implements TextGeneratorIntf for an XML stream.
Definition xmlgen.cpp:181
@ Collaboration
Definition dotgraph.h:31
@ Inheritance
Definition dotgraph.h:31
#define ASSERT(x)
Definition qcstring.h:39
static const char * to_string_lower(Protection prot)
Definition types.h:50
QCString insertTemplateSpecifierInScope(const QCString &scope, const QCString &templ)
Definition util.cpp:3667
static QCString stripFromPath(const QCString &p, const StringVector &l)
Definition util.cpp:307
QCString convertToXML(const QCString &s, bool keepEntities)
Definition util.cpp:3833
QCString langToString(SrcLangExt lang)
Returns a string representation of lang.
Definition util.cpp:5803
void linkifyText(const TextGeneratorIntf &out, const Definition *scope, const FileDef *fileScope, const Definition *self, const QCString &text, bool autoBreak, bool external, bool keepSpaces, int indentLevel)
Definition util.cpp:902
static QCString classOutputFileBase(const ClassDef *cd)
Definition xmlgen.cpp:572
static void writeXMLDocBlock(TextStream &t, const QCString &fileName, int lineNr, const Definition *scope, const MemberDef *md, const QCString &text)
Definition xmlgen.cpp:447
static void writeListOfAllMembers(const ClassDef *cd, TextStream &t)
Definition xmlgen.cpp:1330
static void stripAnonymousMarkers(QCString &s)
Definition xmlgen.cpp:531
static void writeTemplateList(const ClassDef *cd, TextStream &t)
Definition xmlgen.cpp:437
static void writeIncludeInfo(const IncludeInfo *ii, TextStream &t)
Definition xmlgen.cpp:1473
static void writeXMLHeader(TextStream &t)
Definition xmlgen.cpp:124
void writeXMLString(TextStream &t, const QCString &s)
Definition xmlgen.cpp:70
static void generateXMLSection(const Definition *d, TextStream &ti, TextStream &t, const MemberList *ml, const QCString &kind, const QCString &header=QCString(), const QCString &documentation=QCString())
Definition xmlgen.cpp:1293
static void writeInnerClasses(const ClassLinkedRefMap &cl, TextStream &t)
Definition xmlgen.cpp:1357

References FileDef::absFilePath(), ASSERT, ClassDef::baseClasses(), Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), classOutputFileBase(), Collaboration, ClassDef::compoundTypeString(), Config_getString, convertToXML(), Definition::docFile(), Definition::docLine(), Definition::documentation(), err, generateXMLSection(), Definition::getBodyDef(), ClassDef::getClasses(), Definition::getDefColumn(), Definition::getDefFileName(), Definition::getDefLine(), Definition::getEndBodyLine(), ClassDef::getFileDef(), Definition::getLanguage(), ClassDef::getMemberGroups(), ClassDef::getMemberLists(), ClassDef::getQualifiers(), Definition::getStartBodyLine(), ClassDef::includeInfo(), Inheritance, insertTemplateSpecifierInScope(), ClassDef::isAbstract(), Definition::isAnonymous(), Definition::isArtificial(), MemberListType::isDetailed(), QCString::isEmpty(), ClassDef::isFinal(), Definition::isHidden(), ClassDef::isImplicitTemplateInstance(), Definition::isReference(), ClassDef::isSealed(), DotClassGraph::isTrivial(), langToString(), linkifyText(), MemberList::listType(), msg, Definition::name(), Portable::openOutputStream(), ClassDef::protection(), ClassDef::requiresClause(), stripAnonymousMarkers(), stripFromPath(), ClassDef::subClasses(), to_string_lower(), MemberListType::toXML(), writeIncludeInfo(), writeInnerClasses(), writeListOfAllMembers(), writeTemplateList(), DotClassGraph::writeXML(), writeXMLDocBlock(), writeXMLHeader(), and writeXMLString().

Referenced by generateXML().

◆ generateXMLForConcept()

void generateXMLForConcept ( const ConceptDef * cd,
TextStream & ti )
static

Definition at line 1660 of file xmlgen.cpp.

1661{
1662 if (cd->isReference() || cd->isHidden()) return; // skip external references.
1663
1664 ti << " <compound refid=\"" << cd->getOutputFileBase()
1665 << "\" kind=\"concept\"" << "><name>"
1666 << convertToXML(cd->name()) << "</name>\n";
1667
1668 QCString outputDirectory = Config_getString(XML_OUTPUT);
1669 QCString fileName=outputDirectory+"/"+cd->getOutputFileBase()+".xml";
1670 std::ofstream f = Portable::openOutputStream(fileName);
1671 if (!f.is_open())
1672 {
1673 err("Cannot open file {} for writing!\n",fileName);
1674 return;
1675 }
1676 TextStream t(&f);
1677 writeXMLHeader(t);
1678 t << " <compounddef id=\"" << cd->getOutputFileBase()
1679 << "\" kind=\"concept\">\n";
1680 t << " <compoundname>";
1681 QCString nameStr = cd->name();
1682 stripAnonymousMarkers(nameStr);
1683 writeXMLString(t,nameStr);
1684 t << "</compoundname>\n";
1686 writeTemplateList(cd,t);
1687 t << " <initializer>";
1688 linkifyText(TextGeneratorXMLImpl(t),cd,cd->getFileDef(),nullptr,cd->initializer());
1689 t << " </initializer>\n";
1690 t << " <briefdescription>\n";
1691 writeXMLDocBlock(t,cd->briefFile(),cd->briefLine(),cd,nullptr,cd->briefDescription());
1692 t << " </briefdescription>\n";
1693 t << " <detaileddescription>\n";
1694 writeXMLDocBlock(t,cd->docFile(),cd->docLine(),cd,nullptr,cd->documentation());
1695 t << " </detaileddescription>\n";
1696 t << " <location file=\""
1697 << convertToXML(stripFromPath(cd->getDefFileName())) << "\" line=\""
1698 << cd->getDefLine() << "\"" << " column=\""
1699 << cd->getDefColumn() << "\"/>\n" ;
1700 t << " </compounddef>\n";
1701 t << "</doxygen>\n";
1702
1703 ti << " </compound>\n";
1704}
virtual QCString initializer() const =0
virtual const IncludeInfo * includeInfo() const =0
virtual const FileDef * getFileDef() const =0

References Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), Config_getString, convertToXML(), Definition::docFile(), Definition::docLine(), Definition::documentation(), err, Definition::getDefColumn(), Definition::getDefFileName(), Definition::getDefLine(), ConceptDef::getFileDef(), Definition::getOutputFileBase(), ConceptDef::includeInfo(), ConceptDef::initializer(), Definition::isHidden(), Definition::isReference(), linkifyText(), Definition::name(), Portable::openOutputStream(), stripAnonymousMarkers(), stripFromPath(), writeIncludeInfo(), writeTemplateList(), writeXMLDocBlock(), writeXMLHeader(), and writeXMLString().

Referenced by generateXML().

◆ generateXMLForDir()

void generateXMLForDir ( DirDef * dd,
TextStream & ti )
static

Definition at line 2018 of file xmlgen.cpp.

2019{
2020 if (dd->isReference()) return; // skip external references
2021 ti << " <compound refid=\"" << dd->getOutputFileBase()
2022 << "\" kind=\"dir\"><name>" << convertToXML(dd->displayName())
2023 << "</name>\n";
2024
2025 QCString outputDirectory = Config_getString(XML_OUTPUT);
2026 QCString fileName=outputDirectory+"/"+dd->getOutputFileBase()+".xml";
2027 std::ofstream f = Portable::openOutputStream(fileName);
2028 if (!f.is_open())
2029 {
2030 err("Cannot open file {} for writing!\n",fileName);
2031 return;
2032 }
2033 TextStream t(&f);
2034
2035 writeXMLHeader(t);
2036 t << " <compounddef id=\""
2037 << dd->getOutputFileBase() << "\" kind=\"dir\">\n";
2038 t << " <compoundname>" << convertToXML(dd->displayName()) << "</compoundname>\n";
2039
2040 writeInnerDirs(&dd->subDirs(),t);
2041 writeInnerFiles(dd->getFiles(),t);
2042
2043 t << " <briefdescription>\n";
2044 writeXMLDocBlock(t,dd->briefFile(),dd->briefLine(),dd,nullptr,dd->briefDescription());
2045 t << " </briefdescription>\n";
2046 t << " <detaileddescription>\n";
2047 writeXMLDocBlock(t,dd->docFile(),dd->docLine(),dd,nullptr,dd->documentation());
2048 t << " </detaileddescription>\n";
2049 t << " <location file=\"" << convertToXML(stripFromPath(dd->name())) << "\"/>\n";
2050 t << " </compounddef>\n";
2051 t << "</doxygen>\n";
2052
2053 ti << " </compound>\n";
2054}
virtual QCString displayName(bool includeScope=TRUE) const =0
virtual const DirList & subDirs() const =0
virtual const FileList & getFiles() const =0
static void writeInnerDirs(const DirList *dl, TextStream &t)
Definition xmlgen.cpp:1461
static void writeInnerFiles(const FileList &fl, TextStream &t)
Definition xmlgen.cpp:1429

References Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), Config_getString, convertToXML(), Definition::displayName(), Definition::docFile(), Definition::docLine(), Definition::documentation(), err, DirDef::getFiles(), Definition::getOutputFileBase(), Definition::isReference(), Definition::name(), Portable::openOutputStream(), stripFromPath(), DirDef::subDirs(), writeInnerDirs(), writeInnerFiles(), writeXMLDocBlock(), and writeXMLHeader().

Referenced by generateXML().

◆ generateXMLForFile()

void generateXMLForFile ( FileDef * fd,
TextStream & ti )
static

Definition at line 1834 of file xmlgen.cpp.

1835{
1836 // + includes files
1837 // + includedby files
1838 // + include graph
1839 // + included by graph
1840 // + contained class definitions
1841 // + contained namespace definitions
1842 // + member groups
1843 // + normal members
1844 // + brief desc
1845 // + detailed desc
1846 // + source code
1847 // + location
1848 // - number of lines
1849
1850 if (fd->isReference()) return; // skip external references
1851
1852 ti << " <compound refid=\"" << fd->getOutputFileBase()
1853 << "\" kind=\"file\"><name>" << convertToXML(fd->name())
1854 << "</name>\n";
1855
1856 QCString outputDirectory = Config_getString(XML_OUTPUT);
1857 QCString fileName=outputDirectory+"/"+fd->getOutputFileBase()+".xml";
1858 std::ofstream f = Portable::openOutputStream(fileName);
1859 if (!f.is_open())
1860 {
1861 err("Cannot open file {} for writing!\n",fileName);
1862 return;
1863 }
1864 TextStream t(&f);
1865
1866 writeXMLHeader(t);
1867 t << " <compounddef id=\"" << fd->getOutputFileBase()
1868 << "\" kind=\"file\" language=\""
1869 << langToString(fd->getLanguage()) << "\">\n";
1870 t << " <compoundname>";
1871 writeXMLString(t,fd->name());
1872 t << "</compoundname>\n";
1873
1874 for (const auto &inc : fd->includeFileList())
1875 {
1876 t << " <includes";
1877 if (inc.fileDef && !inc.fileDef->isReference()) // TODO: support external references
1878 {
1879 t << " refid=\"" << inc.fileDef->getOutputFileBase() << "\"";
1880 }
1881 t << " local=\"" << ((inc.kind & IncludeKind_LocalMask) ? "yes" : "no") << "\">";
1882 t << convertToXML(inc.includeName);
1883 t << "</includes>\n";
1884 }
1885
1886 for (const auto &inc : fd->includedByFileList())
1887 {
1888 t << " <includedby";
1889 if (inc.fileDef && !inc.fileDef->isReference()) // TODO: support external references
1890 {
1891 t << " refid=\"" << inc.fileDef->getOutputFileBase() << "\"";
1892 }
1893 t << " local=\"" << ((inc.kind &IncludeKind_LocalMask) ? "yes" : "no") << "\">";
1894 t << convertToXML(inc.includeName);
1895 t << "</includedby>\n";
1896 }
1897
1898 DotInclDepGraph incDepGraph(fd,FALSE);
1899 if (!incDepGraph.isTrivial())
1900 {
1901 t << " <incdepgraph>\n";
1902 incDepGraph.writeXML(t);
1903 t << " </incdepgraph>\n";
1904 }
1905
1906 DotInclDepGraph invIncDepGraph(fd,TRUE);
1907 if (!invIncDepGraph.isTrivial())
1908 {
1909 t << " <invincdepgraph>\n";
1910 invIncDepGraph.writeXML(t);
1911 t << " </invincdepgraph>\n";
1912 }
1913
1917
1918 for (const auto &mg : fd->getMemberGroups())
1919 {
1920 generateXMLSection(fd,ti,t,&mg->members(),"user-defined",mg->header(),
1921 mg->documentation());
1922 }
1923
1924 for (const auto &ml : fd->getMemberLists())
1925 {
1926 if (ml->listType().isDeclaration())
1927 {
1928 generateXMLSection(fd,ti,t,ml.get(),ml->listType().toXML());
1929 }
1930 }
1931
1932 t << " <briefdescription>\n";
1933 writeXMLDocBlock(t,fd->briefFile(),fd->briefLine(),fd,nullptr,fd->briefDescription());
1934 t << " </briefdescription>\n";
1935 t << " <detaileddescription>\n";
1936 writeXMLDocBlock(t,fd->docFile(),fd->docLine(),fd,nullptr,fd->documentation());
1937 t << " </detaileddescription>\n";
1938 if (Config_getBool(XML_PROGRAMLISTING))
1939 {
1940 writeXMLCodeBlock(t,fd);
1941 }
1942 t << " <location file=\"" << convertToXML(stripFromPath(fd->getDefFileName())) << "\"/>\n";
1943 t << " </compounddef>\n";
1944 t << "</doxygen>\n";
1945
1946 ti << " </compound>\n";
1947}
Representation of an include dependency graph.
virtual const NamespaceLinkedRefMap & getNamespaces() const =0
virtual const MemberGroupList & getMemberGroups() const =0
virtual const ClassLinkedRefMap & getClasses() const =0
virtual const IncludeInfoList & includeFileList() const =0
virtual const MemberLists & getMemberLists() const =0
virtual const ConceptLinkedRefMap & getConcepts() const =0
virtual const IncludeInfoList & includedByFileList() const =0
#define Config_getBool(name)
Definition config.h:33
constexpr uint32_t IncludeKind_LocalMask
Definition filedef.h:63
static void writeInnerConcepts(const ConceptLinkedRefMap &cl, TextStream &t)
Definition xmlgen.cpp:1370
void writeXMLCodeBlock(TextStream &t, FileDef *fd)
Definition xmlgen.cpp:480
static void writeInnerNamespaces(const NamespaceLinkedRefMap &nl, TextStream &t)
Definition xmlgen.cpp:1394

References Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), Config_getBool, Config_getString, convertToXML(), Definition::docFile(), Definition::docLine(), Definition::documentation(), err, FALSE, generateXMLSection(), FileDef::getClasses(), FileDef::getConcepts(), Definition::getDefFileName(), Definition::getLanguage(), FileDef::getMemberGroups(), FileDef::getMemberLists(), FileDef::getNamespaces(), Definition::getOutputFileBase(), FileDef::includedByFileList(), FileDef::includeFileList(), IncludeKind_LocalMask, MemberListType::isDeclaration(), Definition::isReference(), DotInclDepGraph::isTrivial(), langToString(), MemberList::listType(), Definition::name(), Portable::openOutputStream(), stripFromPath(), MemberListType::toXML(), TRUE, writeInnerClasses(), writeInnerConcepts(), writeInnerNamespaces(), DotInclDepGraph::writeXML(), writeXMLCodeBlock(), writeXMLDocBlock(), writeXMLHeader(), and writeXMLString().

Referenced by generateXML().

◆ generateXMLForGroup()

void generateXMLForGroup ( const GroupDef * gd,
TextStream & ti )
static

Definition at line 1949 of file xmlgen.cpp.

1950{
1951 // + members
1952 // + member groups
1953 // + files
1954 // + classes
1955 // + namespaces
1956 // - packages
1957 // + pages
1958 // + child groups
1959 // - examples
1960 // + brief description
1961 // + detailed description
1962
1963 if (gd->isReference()) return; // skip external references
1964
1965 ti << " <compound refid=\"" << gd->getOutputFileBase()
1966 << "\" kind=\"group\"><name>" << convertToXML(gd->name()) << "</name>\n";
1967
1968 QCString outputDirectory = Config_getString(XML_OUTPUT);
1969 QCString fileName=outputDirectory+"/"+gd->getOutputFileBase()+".xml";
1970 std::ofstream f = Portable::openOutputStream(fileName);
1971 if (!f.is_open())
1972 {
1973 err("Cannot open file {} for writing!\n",fileName);
1974 return;
1975 }
1976 TextStream t(&f);
1977
1978 writeXMLHeader(t);
1979 t << " <compounddef id=\""
1980 << gd->getOutputFileBase() << "\" kind=\"group\">\n";
1981 t << " <compoundname>" << convertToXML(gd->name()) << "</compoundname>\n";
1982 t << " <title>" << convertToXML(gd->groupTitle()) << "</title>\n";
1983
1985 writeInnerFiles(gd->getFiles(),t);
1989 writeInnerPages(gd->getPages(),t);
1991
1992 for (const auto &mg : gd->getMemberGroups())
1993 {
1994 generateXMLSection(gd,ti,t,&mg->members(),"user-defined",mg->header(),
1995 mg->documentation());
1996 }
1997
1998 for (const auto &ml : gd->getMemberLists())
1999 {
2000 if (ml->listType().isDeclaration())
2001 {
2002 generateXMLSection(gd,ti,t,ml.get(),ml->listType().toXML());
2003 }
2004 }
2005
2006 t << " <briefdescription>\n";
2007 writeXMLDocBlock(t,gd->briefFile(),gd->briefLine(),gd,nullptr,gd->briefDescription());
2008 t << " </briefdescription>\n";
2009 t << " <detaileddescription>\n";
2010 writeXMLDocBlock(t,gd->docFile(),gd->docLine(),gd,nullptr,gd->documentation());
2011 t << " </detaileddescription>\n";
2012 t << " </compounddef>\n";
2013 t << "</doxygen>\n";
2014
2015 ti << " </compound>\n";
2016}
virtual const GroupList & getSubGroups() const =0
virtual QCString groupTitle() const =0
virtual const FileList & getFiles() const =0
virtual const MemberLists & getMemberLists() const =0
virtual const MemberGroupList & getMemberGroups() const =0
virtual const ConceptLinkedRefMap & getConcepts() const =0
virtual const PageLinkedRefMap & getPages() const =0
virtual const NamespaceLinkedRefMap & getNamespaces() const =0
virtual const ClassLinkedRefMap & getClasses() const =0
virtual const ModuleLinkedRefMap & getModules() const =0
static void writeInnerGroups(const GroupList &gl, TextStream &t)
Definition xmlgen.cpp:1451
static void writeInnerPages(const PageLinkedRefMap &pl, TextStream &t)
Definition xmlgen.cpp:1438
static void writeInnerModules(const ModuleLinkedRefMap &ml, TextStream &t)
Definition xmlgen.cpp:1382

References Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), Config_getString, convertToXML(), Definition::docFile(), Definition::docLine(), Definition::documentation(), err, generateXMLSection(), GroupDef::getClasses(), GroupDef::getConcepts(), GroupDef::getFiles(), GroupDef::getMemberGroups(), GroupDef::getMemberLists(), GroupDef::getModules(), GroupDef::getNamespaces(), Definition::getOutputFileBase(), GroupDef::getPages(), GroupDef::getSubGroups(), GroupDef::groupTitle(), MemberListType::isDeclaration(), Definition::isReference(), MemberList::listType(), Definition::name(), Portable::openOutputStream(), MemberListType::toXML(), writeInnerClasses(), writeInnerConcepts(), writeInnerFiles(), writeInnerGroups(), writeInnerModules(), writeInnerNamespaces(), writeInnerPages(), writeXMLDocBlock(), and writeXMLHeader().

Referenced by generateXML().

◆ generateXMLForMember()

void generateXMLForMember ( const MemberDef * md,
TextStream & ti,
TextStream & t,
const Definition * def )
static

Definition at line 683 of file xmlgen.cpp.

684{
685
686 // + declaration/definition arg lists
687 // + reimplements
688 // + reimplementedBy
689 // + exceptions
690 // + const/volatile specifiers
691 // - examples
692 // + source definition
693 // + source references
694 // + source referenced by
695 // - body code
696 // + template arguments
697 // (templateArguments(), definitionTemplateParameterLists())
698 // - call graph
699
700 // enum values are written as part of the enum
701 if (md->memberType()==MemberType::EnumValue) return;
702 if (md->isHidden()) return;
703
704 // group members are only visible in their group
705 bool groupMember = md->getGroupDef() && def->definitionType()!=Definition::TypeGroup;
706
707 QCString memType;
708 bool isFunc=FALSE;
709 switch (md->memberType())
710 {
711 case MemberType::Define: memType="define"; break;
712 case MemberType::Function: memType="function"; isFunc=TRUE; break;
713 case MemberType::Variable: memType="variable"; break;
714 case MemberType::Typedef: memType="typedef"; break;
715 case MemberType::Enumeration: memType="enum"; break;
716 case MemberType::EnumValue: ASSERT(0); break;
717 case MemberType::Signal: memType="signal"; isFunc=TRUE; break;
718 case MemberType::Slot: memType="slot"; isFunc=TRUE; break;
719 case MemberType::Friend: memType="friend"; isFunc=TRUE; break;
720 case MemberType::DCOP: memType="dcop"; isFunc=TRUE; break;
721 case MemberType::Property: memType="property"; break;
722 case MemberType::Event: memType="event"; break;
723 case MemberType::Interface: memType="interface"; break;
724 case MemberType::Service: memType="service"; break;
725 case MemberType::Sequence: memType="sequence"; break;
726 case MemberType::Dictionary: memType="dictionary"; break;
727 }
728
729 QCString nameStr = md->name();
730 QCString typeStr = md->typeString();
731 QCString argsStr = md->argsString();
732 QCString defStr = md->definition();
733 defStr.stripPrefix("constexpr ");
734 defStr.stripPrefix("consteval ");
735 defStr.stripPrefix("constinit ");
736 stripAnonymousMarkers(typeStr);
737 stripQualifiers(typeStr);
738 if (typeStr=="auto")
739 {
740 int i=argsStr.findRev("->");
741 if (i!=-1) // move trailing return type into type and strip it from argsStr
742 {
743 typeStr=argsStr.mid(i+2).stripWhiteSpace();
744 argsStr=argsStr.left(i).stripWhiteSpace();
745 if (stripKeyword(typeStr, "override", true))
746 {
747 argsStr += " override";
748 }
749 if (stripKeyword(typeStr, "final", true))
750 {
751 argsStr += " final";
752 }
753 if (stripKeyword(typeStr, "=0", false))
754 {
755 argsStr += "=0";
756 }
757 if (stripKeyword(typeStr, "=default", false))
758 {
759 argsStr += "=default";
760 }
761 if (stripKeyword(typeStr, "=delete", false))
762 {
763 argsStr += "=delete";
764 }
765 i=defStr.find("auto ");
766 if (i!=-1)
767 {
768 defStr=defStr.left(i)+typeStr+defStr.mid(i+4);
769 }
770 }
771 }
772 QCString noExceptExpr = extractNoExcept(argsStr);
773
774 stripAnonymousMarkers(nameStr);
775 ti << " <member refid=\"" << memberOutputFileBase(md)
776 << "_1" << md->anchor() << "\" kind=\"" << memType << "\"><name>"
777 << convertToXML(nameStr) << "</name></member>\n";
778
779 if (groupMember)
780 {
781 t << " <member refid=\""
783 << "_1" << md->anchor() << "\" kind=\"" << memType << "\"><name>"
784 << convertToXML(nameStr) << "</name></member>\n";
785 return;
786 }
787 else
788 {
789 t << " <memberdef kind=\"";
790 t << memType << "\" id=\"";
791 t << memberOutputFileBase(md);
792 t << "_1" // encoded ':' character (see util.cpp:convertNameToFile)
793 << md->anchor();
794 }
795 //enum { define_t,variable_t,typedef_t,enum_t,function_t } xmlType = function_t;
796
797 t << "\" prot=\"" << to_string_lower(md->protection());
798 t << "\"";
799
800 t << " static=\"";
801 if (md->isStatic()) t << "yes"; else t << "no";
802 t << "\"";
803
804 if (md->isNoDiscard())
805 {
806 t << " nodiscard=\"yes\"";
807 }
808
809 if (md->isConstExpr())
810 {
811 t << " constexpr=\"yes\"";
812 }
813
814 if (md->isConstEval())
815 {
816 t << " consteval=\"yes\"";
817 }
818
819 if (md->isConstInit())
820 {
821 t << " constinit=\"yes\"";
822 }
823
824 if (md->isExternal())
825 {
826 t << " extern=\"yes\"";
827 }
828
829 if (isFunc)
830 {
831 const ArgumentList &al = md->argumentList();
832 t << " const=\"";
833 if (al.constSpecifier()) t << "yes"; else t << "no";
834 t << "\"";
835
836 t << " explicit=\"";
837 if (md->isExplicit()) t << "yes"; else t << "no";
838 t << "\"";
839
840 t << " inline=\"";
841 if (md->isInline()) t << "yes"; else t << "no";
842 t << "\"";
843
845 {
846 t << " refqual=\"";
847 if (al.refQualifier()==RefQualifierType::LValue) t << "lvalue"; else t << "rvalue";
848 t << "\"";
849 }
850
851 if (md->isFinal())
852 {
853 t << " final=\"yes\"";
854 }
855
856 if (md->isSealed())
857 {
858 t << " sealed=\"yes\"";
859 }
860
861 if (md->isNew())
862 {
863 t << " new=\"yes\"";
864 }
865
866 if (md->isOptional())
867 {
868 t << " optional=\"yes\"";
869 }
870
871 if (md->isRequired())
872 {
873 t << " required=\"yes\"";
874 }
875
876 if (md->isNoExcept())
877 {
878 t << " noexcept=\"yes\"";
879 }
880
881 if (!noExceptExpr.isEmpty())
882 {
883 t << " noexceptexpression=\"" << convertToXML(noExceptExpr) << "\"";
884 }
885
886 if (al.volatileSpecifier())
887 {
888 t << " volatile=\"yes\"";
889 }
890
891 t << " virt=\"" << to_string_lower(md->virtualness());
892 t << "\"";
893 }
894
896 {
897 t << " strong=\"";
898 if (md->isStrong()) t << "yes"; else t << "no";
899 t << "\"";
900 }
901
902 if (md->memberType() == MemberType::Variable)
903 {
904 //ArgumentList *al = md->argumentList();
905 //t << " volatile=\"";
906 //if (al && al->volatileSpecifier) t << "yes"; else t << "no";
907
908 t << " mutable=\"";
909 if (md->isMutable()) t << "yes"; else t << "no";
910 t << "\"";
911
912 if (md->isThreadLocal())
913 {
914 t << " thread_local=\"yes\"";
915 }
916
917 if (md->isInitonly())
918 {
919 t << " initonly=\"yes\"";
920 }
921 if (md->isAttribute())
922 {
923 t << " attribute=\"yes\"";
924 }
925 if (md->isUNOProperty())
926 {
927 t << " property=\"yes\"";
928 }
929 if (md->isReadonly())
930 {
931 t << " readonly=\"yes\"";
932 }
933 if (md->isBound())
934 {
935 t << " bound=\"yes\"";
936 }
937 if (md->isRemovable())
938 {
939 t << " removable=\"yes\"";
940 }
941 if (md->isConstrained())
942 {
943 t << " constrained=\"yes\"";
944 }
945 if (md->isTransient())
946 {
947 t << " transient=\"yes\"";
948 }
949 if (md->isMaybeVoid())
950 {
951 t << " maybevoid=\"yes\"";
952 }
953 if (md->isMaybeDefault())
954 {
955 t << " maybedefault=\"yes\"";
956 }
957 if (md->isMaybeAmbiguous())
958 {
959 t << " maybeambiguous=\"yes\"";
960 }
961 }
962 else if (md->memberType() == MemberType::Property)
963 {
964 t << " readable=\"";
965 if (md->isReadable()) t << "yes"; else t << "no";
966 t << "\"";
967
968 t << " writable=\"";
969 if (md->isWritable()) t << "yes"; else t << "no";
970 t << "\"";
971
972 t << " gettable=\"";
973 if (md->isGettable()) t << "yes"; else t << "no";
974 t << "\"";
975
976 t << " privategettable=\"";
977 if (md->isPrivateGettable()) t << "yes"; else t << "no";
978 t << "\"";
979
980 t << " protectedgettable=\"";
981 if (md->isProtectedGettable()) t << "yes"; else t << "no";
982 t << "\"";
983
984 t << " settable=\"";
985 if (md->isSettable()) t << "yes"; else t << "no";
986 t << "\"";
987
988 t << " privatesettable=\"";
989 if (md->isPrivateSettable()) t << "yes"; else t << "no";
990 t << "\"";
991
992 t << " protectedsettable=\"";
993 if (md->isProtectedSettable()) t << "yes"; else t << "no";
994 t << "\"";
995
996 if (md->isAssign() || md->isCopy() || md->isRetain() || md->isStrong() || md->isWeak())
997 {
998 t << " accessor=\"";
999 if (md->isAssign()) t << "assign";
1000 else if (md->isCopy()) t << "copy";
1001 else if (md->isRetain()) t << "retain";
1002 else if (md->isStrong()) t << "strong";
1003 else if (md->isWeak()) t << "weak";
1004 t << "\"";
1005 }
1006 }
1007 else if (md->memberType() == MemberType::Event)
1008 {
1009 t << " add=\"";
1010 if (md->isAddable()) t << "yes"; else t << "no";
1011 t << "\"";
1012
1013 t << " remove=\"";
1014 if (md->isRemovable()) t << "yes"; else t << "no";
1015 t << "\"";
1016
1017 t << " raise=\"";
1018 if (md->isRaisable()) t << "yes"; else t << "no";
1019 t << "\"";
1020 }
1021
1022 t << ">\n";
1023
1024 if (md->memberType()!=MemberType::Define &&
1026 )
1027 {
1029 t << " <type>";
1030 linkifyText(TextGeneratorXMLImpl(t),def,md->getBodyDef(),md,typeStr);
1031 t << "</type>\n";
1032 if (md->isTypeAlias())
1033 {
1034 defStr+=" = "+md->initializer();
1035 }
1036 stripAnonymousMarkers(defStr);
1037 t << " <definition>" << convertToXML(defStr) << "</definition>\n";
1038 t << " <argsstring>" << convertToXML(argsStr) << "</argsstring>\n";
1039 }
1040
1042 {
1043 t << " <type>";
1045 t << "</type>\n";
1046 }
1047
1048 QCString qualifiedNameStr = md->qualifiedName();
1049 stripAnonymousMarkers(qualifiedNameStr);
1050 t << " <name>" << convertToXML(nameStr) << "</name>\n";
1051 if (nameStr!=qualifiedNameStr)
1052 {
1053 t << " <qualifiedname>" << convertToXML(qualifiedNameStr) << "</qualifiedname>\n";
1054 }
1055
1056 if (md->memberType() == MemberType::Property)
1057 {
1058 if (md->isReadable())
1059 t << " <read>" << convertToXML(md->getReadAccessor()) << "</read>\n";
1060 if (md->isWritable())
1061 t << " <write>" << convertToXML(md->getWriteAccessor()) << "</write>\n";
1062 }
1063
1065 {
1066 QCString bitfield = md->bitfieldString();
1067 if (bitfield.at(0)==':') bitfield=bitfield.mid(1);
1068 t << " <bitfield>" << convertToXML(bitfield) << "</bitfield>\n";
1069 }
1070
1071 const MemberDef *rmd = md->reimplements();
1072 if (rmd)
1073 {
1074 t << " <reimplements refid=\""
1075 << memberOutputFileBase(rmd) << "_1" << rmd->anchor() << "\">"
1076 << convertToXML(rmd->name()) << "</reimplements>\n";
1077 }
1078 for (const auto &rbmd : md->reimplementedBy())
1079 {
1080 t << " <reimplementedby refid=\""
1081 << memberOutputFileBase(rbmd) << "_1" << rbmd->anchor() << "\">"
1082 << convertToXML(rbmd->name()) << "</reimplementedby>\n";
1083 }
1084
1085 for (const auto &qmd : md->getQualifiers())
1086 {
1087 t << " <qualifier>" << convertToXML(qmd) << "</qualifier>\n";
1088 }
1089
1090 if (md->isFriendClass()) // for friend classes we show a link to the class as a "parameter"
1091 {
1092 t << " <param>\n";
1093 t << " <type>";
1094 linkifyText(TextGeneratorXMLImpl(t),def,md->getBodyDef(),md,nameStr);
1095 t << "</type>\n";
1096 t << " </param>\n";
1097 }
1098 else if (isFunc) //function
1099 {
1100 const ArgumentList &declAl = md->declArgumentList();
1101 const ArgumentList &defAl = md->argumentList();
1102 bool isFortran = md->getLanguage()==SrcLangExt::Fortran;
1103 if (declAl.hasParameters())
1104 {
1105 auto defIt = defAl.begin();
1106 for (const Argument &a : declAl)
1107 {
1108 //const Argument *defArg = defAli.current();
1109 const Argument *defArg = nullptr;
1110 if (defIt!=defAl.end())
1111 {
1112 defArg = &(*defIt);
1113 ++defIt;
1114 }
1115 t << " <param>\n";
1116 if (!a.attrib.isEmpty())
1117 {
1118 t << " <attributes>";
1119 writeXMLString(t,a.attrib);
1120 t << "</attributes>\n";
1121 }
1122 if (isFortran && defArg && !defArg->type.isEmpty())
1123 {
1124 t << " <type>";
1125 linkifyText(TextGeneratorXMLImpl(t),def,md->getBodyDef(),md,defArg->type);
1126 t << "</type>\n";
1127 }
1128 else if (!a.type.isEmpty())
1129 {
1130 t << " <type>";
1131 linkifyText(TextGeneratorXMLImpl(t),def,md->getBodyDef(),md,a.type);
1132 t << "</type>\n";
1133 }
1134 if (!a.name.isEmpty())
1135 {
1136 t << " <declname>";
1137 writeXMLString(t,a.name);
1138 t << "</declname>\n";
1139 }
1140 if (defArg && !defArg->name.isEmpty() && defArg->name!=a.name)
1141 {
1142 t << " <defname>";
1143 writeXMLString(t,defArg->name);
1144 t << "</defname>\n";
1145 }
1146 if (!a.array.isEmpty())
1147 {
1148 t << " <array>";
1149 writeXMLString(t,a.array);
1150 t << "</array>\n";
1151 }
1152 if (!a.defval.isEmpty())
1153 {
1154 t << " <defval>";
1155 linkifyText(TextGeneratorXMLImpl(t),def,md->getBodyDef(),md,a.defval);
1156 t << "</defval>\n";
1157 }
1158 if (defArg && defArg->hasDocumentation())
1159 {
1160 t << " <briefdescription>";
1162 md->getOuterScope(),md,defArg->docs);
1163 t << "</briefdescription>\n";
1164 }
1165 t << " </param>\n";
1166 }
1167 }
1168 }
1169 else if (md->memberType()==MemberType::Define &&
1170 !md->argsString().isEmpty()) // define
1171 {
1172 if (md->argumentList().empty()) // special case for "foo()" to
1173 // distinguish it from "foo".
1174 {
1175 t << " <param></param>\n";
1176 }
1177 else
1178 {
1179 for (const Argument &a : md->argumentList())
1180 {
1181 t << " <param><defname>" << a.type << "</defname></param>\n";
1182 }
1183 }
1184 }
1185 if (!md->requiresClause().isEmpty())
1186 {
1187 t << " <requiresclause>";
1189 t << " </requiresclause>\n";
1190 }
1191
1192 if (!md->isTypeAlias() && (md->hasOneLineInitializer() || md->hasMultiLineInitializer()))
1193 {
1194 t << " <initializer>";
1196 t << "</initializer>\n";
1197 }
1198
1199 if (!md->excpString().isEmpty())
1200 {
1201 t << " <exceptions>";
1203 t << "</exceptions>\n";
1204 }
1205
1206 if (md->memberType()==MemberType::Enumeration) // enum
1207 {
1208 for (const auto &emd : md->enumFieldList())
1209 {
1210 ti << " <member refid=\"" << memberOutputFileBase(md)
1211 << "_1" << emd->anchor() << "\" kind=\"enumvalue\"><name>"
1212 << convertToXML(emd->name()) << "</name></member>\n";
1213
1214 t << " <enumvalue id=\"" << memberOutputFileBase(md) << "_1"
1215 << emd->anchor() << "\" prot=\"" << to_string_lower(emd->protection());
1216 t << "\">\n";
1217 t << " <name>";
1218 writeXMLString(t,emd->name());
1219 t << "</name>\n";
1220 if (!emd->initializer().isEmpty())
1221 {
1222 t << " <initializer>";
1223 writeXMLString(t,emd->initializer());
1224 t << "</initializer>\n";
1225 }
1226 t << " <briefdescription>\n";
1227 writeXMLDocBlock(t,emd->briefFile(),emd->briefLine(),emd->getOuterScope(),emd,emd->briefDescription());
1228 t << " </briefdescription>\n";
1229 t << " <detaileddescription>\n";
1230 writeXMLDocBlock(t,emd->docFile(),emd->docLine(),emd->getOuterScope(),emd,emd->documentation());
1231 t << " </detaileddescription>\n";
1232 t << " </enumvalue>\n";
1233 }
1234 }
1235 t << " <briefdescription>\n";
1237 t << " </briefdescription>\n";
1238 t << " <detaileddescription>\n";
1239 writeXMLDocBlock(t,md->docFile(),md->docLine(),md->getOuterScope(),md,md->documentation());
1240 t << " </detaileddescription>\n";
1241 t << " <inbodydescription>\n";
1243 t << " </inbodydescription>\n";
1244 if (md->getDefLine()!=-1)
1245 {
1246 t << " <location file=\""
1247 << convertToXML(stripFromPath(md->getDefFileName())) << "\" line=\""
1248 << md->getDefLine() << "\" column=\""
1249 << md->getDefColumn() << "\"" ;
1250 if (md->getStartBodyLine()!=-1)
1251 {
1252 const FileDef *bodyDef = md->getBodyDef();
1253 if (bodyDef)
1254 {
1255 t << " bodyfile=\"" << convertToXML(stripFromPath(bodyDef->absFilePath())) << "\"";
1256 }
1257 t << " bodystart=\"" << md->getStartBodyLine() << "\" bodyend=\""
1258 << md->getEndBodyLine() << "\"";
1259 }
1260 if (md->getDeclLine()!=-1)
1261 {
1262 t << " declfile=\"" << convertToXML(stripFromPath(md->getDeclFileName())) << "\" declline=\""
1263 << md->getDeclLine() << "\" declcolumn=\""
1264 << md->getDeclColumn() << "\"";
1265 }
1266 t << "/>\n";
1267 }
1268
1269 //printf("md->getReferencesMembers()=%p\n",md->getReferencesMembers());
1270 auto refList = md->getReferencesMembers();
1271 for (const auto &refmd : refList)
1272 {
1273 writeMemberReference(t,def,refmd,"references");
1274 }
1275 auto refByList = md->getReferencedByMembers();
1276 for (const auto &refmd : refByList)
1277 {
1278 writeMemberReference(t,def,refmd,"referencedby");
1279 }
1280
1281 t << " </memberdef>\n";
1282}
This class represents an function or template argument list.
Definition arguments.h:65
RefQualifierType refQualifier() const
Definition arguments.h:116
iterator end()
Definition arguments.h:94
bool hasParameters() const
Definition arguments.h:76
bool constSpecifier() const
Definition arguments.h:111
bool empty() const
Definition arguments.h:99
iterator begin()
Definition arguments.h:93
bool volatileSpecifier() const
Definition arguments.h:112
virtual DefType definitionType() const =0
virtual QCString anchor() const =0
virtual int inbodyLine() const =0
virtual QCString qualifiedName() const =0
virtual Definition * getOuterScope() const =0
virtual const MemberVector & getReferencedByMembers() const =0
virtual const MemberVector & getReferencesMembers() const =0
virtual QCString inbodyDocumentation() const =0
A model of a class/file/namespace member symbol.
Definition memberdef.h:48
virtual QCString typeString() const =0
virtual bool isConstExpr() const =0
virtual bool isConstEval() const =0
virtual bool isInitonly() const =0
virtual bool isNoExcept() const =0
virtual QCString requiresClause() const =0
virtual bool isAssign() const =0
virtual bool isExplicit() const =0
virtual bool isNew() const =0
virtual bool isMaybeVoid() const =0
virtual bool isSealed() const =0
virtual QCString definition() const =0
virtual QCString enumBaseType() const =0
virtual bool isConstInit() const =0
virtual QCString excpString() const =0
virtual GroupDef * getGroupDef()=0
virtual bool isSettable() const =0
virtual bool isRetain() const =0
virtual bool isAddable() const =0
virtual const MemberVector & enumFieldList() const =0
virtual const FileDef * getFileDef() const =0
virtual bool isInline() const =0
virtual const ArgumentList & argumentList() const =0
virtual bool isWritable() const =0
virtual bool isMaybeAmbiguous() const =0
virtual bool isPrivateGettable() const =0
virtual const MemberVector & reimplementedBy() const =0
virtual bool isRequired() const =0
virtual bool isAttribute() const =0
virtual bool isExternal() const =0
virtual bool isCopy() const =0
virtual int getDeclLine() const =0
virtual bool isTypeAlias() const =0
virtual int getDeclColumn() const =0
virtual bool isStatic() const =0
virtual const MemberDef * reimplements() const =0
virtual bool isMaybeDefault() const =0
virtual QCString getWriteAccessor() const =0
virtual bool isPrivateSettable() const =0
virtual StringVector getQualifiers() const =0
virtual QCString bitfieldString() const =0
virtual bool isRaisable() const =0
virtual bool isRemovable() const =0
virtual bool isConstrained() const =0
virtual bool isReadonly() const =0
virtual bool isBound() const =0
virtual bool isThreadLocal() const =0
virtual QCString getDeclFileName() const =0
virtual bool isProtectedSettable() const =0
virtual bool isProtectedGettable() const =0
virtual bool hasOneLineInitializer() const =0
virtual bool isTransient() const =0
virtual bool hasMultiLineInitializer() const =0
virtual Protection protection() const =0
virtual bool isOptional() const =0
virtual QCString getReadAccessor() const =0
virtual bool isGettable() const =0
virtual MemberType memberType() const =0
virtual bool isReadable() const =0
virtual bool isWeak() const =0
virtual bool isNoDiscard() const =0
virtual bool isStrong() const =0
virtual QCString argsString() const =0
virtual Specifier virtualness(int count=0) const =0
virtual bool isUNOProperty() const =0
virtual bool isFinal() const =0
virtual const ArgumentList & declArgumentList() const =0
virtual bool isMutable() const =0
virtual bool isFriendClass() const =0
virtual const QCString & initializer() const =0
char & at(size_t i)
Returns a reference to the character at index i.
Definition qcstring.h:593
int findRev(char c, int index=-1, bool cs=TRUE) const
Definition qcstring.cpp:96
bool stripPrefix(const QCString &prefix)
Definition qcstring.h:213
This class contains the information about the argument of a function or template.
Definition arguments.h:27
QCString type
Definition arguments.h:42
QCString name
Definition arguments.h:44
QCString docs
Definition arguments.h:47
bool hasDocumentation() const
Definition arguments.h:31
@ Enumeration
Definition types.h:557
@ EnumValue
Definition types.h:558
@ Dictionary
Definition types.h:568
@ Interface
Definition types.h:565
@ Sequence
Definition types.h:567
@ Variable
Definition types.h:555
@ Property
Definition types.h:563
@ Typedef
Definition types.h:556
@ Function
Definition types.h:554
@ Service
Definition types.h:566
static void writeMemberReference(TextStream &t, const Definition *def, const MemberDef *rmd, const QCString &tagName)
Definition xmlgen.cpp:506
static QCString memberOutputFileBase(const MemberDef *md)
Definition xmlgen.cpp:581
static void writeMemberTemplateLists(const MemberDef *md, TextStream &t)
Definition xmlgen.cpp:432
static bool stripKeyword(QCString &str, const char *keyword, bool needSpace)
Definition xmlgen.cpp:595
static void stripQualifiers(QCString &typeStr)
Definition xmlgen.cpp:556
static QCString extractNoExcept(QCString &argsStr)
Definition xmlgen.cpp:639

References FileDef::absFilePath(), Definition::anchor(), MemberDef::argsString(), MemberDef::argumentList(), ASSERT, QCString::at(), ArgumentList::begin(), MemberDef::bitfieldString(), Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), ArgumentList::constSpecifier(), convertToXML(), DCOP, MemberDef::declArgumentList(), Define, MemberDef::definition(), Definition::definitionType(), Dictionary, Definition::docFile(), Definition::docLine(), Argument::docs, Definition::documentation(), ArgumentList::empty(), ArgumentList::end(), MemberDef::enumBaseType(), Enumeration, MemberDef::enumFieldList(), EnumValue, Event, MemberDef::excpString(), extractNoExcept(), FALSE, QCString::find(), QCString::findRev(), Friend, Function, Definition::getBodyDef(), MemberDef::getDeclColumn(), MemberDef::getDeclFileName(), MemberDef::getDeclLine(), Definition::getDefColumn(), Definition::getDefFileName(), Definition::getDefLine(), Definition::getEndBodyLine(), MemberDef::getFileDef(), MemberDef::getGroupDef(), Definition::getLanguage(), Definition::getOuterScope(), Definition::getOutputFileBase(), MemberDef::getQualifiers(), MemberDef::getReadAccessor(), Definition::getReferencedByMembers(), Definition::getReferencesMembers(), Definition::getStartBodyLine(), MemberDef::getWriteAccessor(), Argument::hasDocumentation(), MemberDef::hasMultiLineInitializer(), MemberDef::hasOneLineInitializer(), ArgumentList::hasParameters(), Definition::inbodyDocumentation(), Definition::inbodyLine(), MemberDef::initializer(), Interface, MemberDef::isAddable(), MemberDef::isAssign(), MemberDef::isAttribute(), MemberDef::isBound(), MemberDef::isConstEval(), MemberDef::isConstExpr(), MemberDef::isConstInit(), MemberDef::isConstrained(), MemberDef::isCopy(), QCString::isEmpty(), MemberDef::isExplicit(), MemberDef::isExternal(), MemberDef::isFinal(), MemberDef::isFriendClass(), MemberDef::isGettable(), Definition::isHidden(), MemberDef::isInitonly(), MemberDef::isInline(), MemberDef::isMaybeAmbiguous(), MemberDef::isMaybeDefault(), MemberDef::isMaybeVoid(), MemberDef::isMutable(), MemberDef::isNew(), MemberDef::isNoDiscard(), MemberDef::isNoExcept(), MemberDef::isOptional(), MemberDef::isPrivateGettable(), MemberDef::isPrivateSettable(), MemberDef::isProtectedGettable(), MemberDef::isProtectedSettable(), MemberDef::isRaisable(), MemberDef::isReadable(), MemberDef::isReadonly(), MemberDef::isRemovable(), MemberDef::isRequired(), MemberDef::isRetain(), MemberDef::isSealed(), MemberDef::isSettable(), MemberDef::isStatic(), MemberDef::isStrong(), MemberDef::isThreadLocal(), MemberDef::isTransient(), MemberDef::isTypeAlias(), MemberDef::isUNOProperty(), MemberDef::isWeak(), MemberDef::isWritable(), QCString::left(), linkifyText(), LValue, memberOutputFileBase(), MemberDef::memberType(), QCString::mid(), Argument::name, Definition::name(), None, Property, MemberDef::protection(), Definition::qualifiedName(), ArgumentList::refQualifier(), MemberDef::reimplementedBy(), MemberDef::reimplements(), MemberDef::requiresClause(), Sequence, Service, Signal, Slot, stripAnonymousMarkers(), stripFromPath(), stripKeyword(), QCString::stripPrefix(), stripQualifiers(), QCString::stripWhiteSpace(), to_string_lower(), TRUE, Argument::type, Typedef, Definition::TypeGroup, MemberDef::typeString(), Variable, MemberDef::virtualness(), ArgumentList::volatileSpecifier(), writeMemberReference(), writeMemberTemplateLists(), writeXMLDocBlock(), and writeXMLString().

Referenced by generateXMLSection().

◆ generateXMLForModule()

void generateXMLForModule ( const ModuleDef * mod,
TextStream & ti )
static

Definition at line 1706 of file xmlgen.cpp.

1707{
1708 if (mod->isReference() || mod->isHidden() || !mod->isPrimaryInterface()) return;
1709 ti << " <compound refid=\"" << mod->getOutputFileBase()
1710 << "\" kind=\"module\"" << "><name>"
1711 << convertToXML(mod->name()) << "</name>\n";
1712
1713 QCString outputDirectory = Config_getString(XML_OUTPUT);
1714 QCString fileName=outputDirectory+"/"+mod->getOutputFileBase()+".xml";
1715 std::ofstream f = Portable::openOutputStream(fileName);
1716 if (!f.is_open())
1717 {
1718 err("Cannot open file {} for writing!\n",fileName);
1719 return;
1720 }
1721 TextStream t(&f);
1722 writeXMLHeader(t);
1723 t << " <compounddef id=\"" << mod->getOutputFileBase()
1724 << "\" kind=\"module\">\n";
1725 t << " <compoundname>";
1726 writeXMLString(t,mod->name());
1727 t << "</compoundname>\n";
1728 writeInnerFiles(mod->getUsedFiles(),t);
1729 writeInnerClasses(mod->getClasses(),t);
1731 for (const auto &ml : mod->getMemberLists())
1732 {
1733 if (ml->listType().isDeclaration())
1734 {
1735 generateXMLSection(mod,ti,t,ml.get(),ml->listType().toXML());
1736 }
1737 }
1738 for (const auto &mg : mod->getMemberGroups())
1739 {
1740 generateXMLSection(mod,ti,t,&mg->members(),"user-defined",mg->header(),
1741 mg->documentation());
1742 }
1743 t << " <briefdescription>\n";
1744 writeXMLDocBlock(t,mod->briefFile(),mod->briefLine(),mod,nullptr,mod->briefDescription());
1745 t << " </briefdescription>\n";
1746 t << " <detaileddescription>\n";
1747 writeXMLDocBlock(t,mod->docFile(),mod->docLine(),mod,nullptr,mod->documentation());
1748 t << " </detaileddescription>\n";
1749 writeExports(mod->getExports(),t);
1750 t << " <location file=\""
1751 << convertToXML(stripFromPath(mod->getDefFileName())) << "\" line=\""
1752 << mod->getDefLine() << "\"" << " column=\""
1753 << mod->getDefColumn() << "\"/>\n" ;
1754 t << " </compounddef>\n";
1755 t << "</doxygen>\n";
1756
1757 ti << " </compound>\n";
1758
1759}
virtual const MemberGroupList & getMemberGroups() const =0
virtual bool isPrimaryInterface() const =0
virtual const MemberLists & getMemberLists() const =0
virtual FileList getUsedFiles() const =0
virtual const ImportInfoMap & getExports() const =0
virtual const ConceptLinkedRefMap & getConcepts() const =0
virtual const ClassLinkedRefMap & getClasses() const =0
static void writeExports(const ImportInfoMap &exportMap, TextStream &t)
Definition xmlgen.cpp:1407

References Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), Config_getString, convertToXML(), Definition::docFile(), Definition::docLine(), Definition::documentation(), err, generateXMLSection(), ModuleDef::getClasses(), ModuleDef::getConcepts(), Definition::getDefColumn(), Definition::getDefFileName(), Definition::getDefLine(), ModuleDef::getExports(), ModuleDef::getMemberGroups(), ModuleDef::getMemberLists(), Definition::getOutputFileBase(), ModuleDef::getUsedFiles(), MemberListType::isDeclaration(), Definition::isHidden(), ModuleDef::isPrimaryInterface(), Definition::isReference(), MemberList::listType(), Definition::name(), Portable::openOutputStream(), stripFromPath(), MemberListType::toXML(), writeExports(), writeInnerClasses(), writeInnerConcepts(), writeInnerFiles(), writeXMLDocBlock(), writeXMLHeader(), and writeXMLString().

Referenced by generateXML().

◆ generateXMLForNamespace()

void generateXMLForNamespace ( const NamespaceDef * nd,
TextStream & ti )
static

Definition at line 1761 of file xmlgen.cpp.

1762{
1763 // + contained class definitions
1764 // + contained namespace definitions
1765 // + member groups
1766 // + normal members
1767 // + brief desc
1768 // + detailed desc
1769 // + location
1770 // - files containing (parts of) the namespace definition
1771
1772 if (nd->isReference() || nd->isHidden()) return; // skip external references
1773
1774 ti << " <compound refid=\"" << nd->getOutputFileBase()
1775 << "\" kind=\"namespace\"" << "><name>"
1776 << convertToXML(nd->name()) << "</name>\n";
1777
1778 QCString outputDirectory = Config_getString(XML_OUTPUT);
1779 QCString fileName=outputDirectory+"/"+nd->getOutputFileBase()+".xml";
1780 std::ofstream f = Portable::openOutputStream(fileName);
1781 if (!f.is_open())
1782 {
1783 err("Cannot open file {} for writing!\n",fileName);
1784 return;
1785 }
1786 TextStream t(&f);
1787
1788 writeXMLHeader(t);
1789 t << " <compounddef id=\"" << nd->getOutputFileBase()
1790 << "\" kind=\"namespace\" "
1791 << (nd->isInline()?"inline=\"yes\" ":"")
1792 << "language=\""
1793 << langToString(nd->getLanguage()) << "\">\n";
1794 t << " <compoundname>";
1795 QCString nameStr = nd->name();
1796 stripAnonymousMarkers(nameStr);
1797 writeXMLString(t,nameStr);
1798 t << "</compoundname>\n";
1799
1803
1804 for (const auto &mg : nd->getMemberGroups())
1805 {
1806 generateXMLSection(nd,ti,t,&mg->members(),"user-defined",mg->header(),
1807 mg->documentation());
1808 }
1809
1810 for (const auto &ml : nd->getMemberLists())
1811 {
1812 if (ml->listType().isDeclaration())
1813 {
1814 generateXMLSection(nd,ti,t,ml.get(),ml->listType().toXML());
1815 }
1816 }
1817
1818 t << " <briefdescription>\n";
1819 writeXMLDocBlock(t,nd->briefFile(),nd->briefLine(),nd,nullptr,nd->briefDescription());
1820 t << " </briefdescription>\n";
1821 t << " <detaileddescription>\n";
1822 writeXMLDocBlock(t,nd->docFile(),nd->docLine(),nd,nullptr,nd->documentation());
1823 t << " </detaileddescription>\n";
1824 t << " <location file=\""
1825 << convertToXML(stripFromPath(nd->getDefFileName())) << "\" line=\""
1826 << nd->getDefLine() << "\"" << " column=\""
1827 << nd->getDefColumn() << "\"/>\n" ;
1828 t << " </compounddef>\n";
1829 t << "</doxygen>\n";
1830
1831 ti << " </compound>\n";
1832}
virtual ConceptLinkedRefMap getConcepts() const =0
virtual const MemberLists & getMemberLists() const =0
virtual NamespaceLinkedRefMap getNamespaces() const =0
virtual bool isInline() const =0
virtual ClassLinkedRefMap getClasses() const =0
virtual const MemberGroupList & getMemberGroups() const =0

References Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), Config_getString, convertToXML(), Definition::docFile(), Definition::docLine(), Definition::documentation(), err, generateXMLSection(), NamespaceDef::getClasses(), NamespaceDef::getConcepts(), Definition::getDefColumn(), Definition::getDefFileName(), Definition::getDefLine(), Definition::getLanguage(), NamespaceDef::getMemberGroups(), NamespaceDef::getMemberLists(), NamespaceDef::getNamespaces(), Definition::getOutputFileBase(), MemberListType::isDeclaration(), Definition::isHidden(), NamespaceDef::isInline(), Definition::isReference(), langToString(), MemberList::listType(), Definition::name(), Portable::openOutputStream(), stripAnonymousMarkers(), stripFromPath(), MemberListType::toXML(), writeInnerClasses(), writeInnerConcepts(), writeInnerNamespaces(), writeXMLDocBlock(), writeXMLHeader(), and writeXMLString().

Referenced by generateXML().

◆ generateXMLForPage()

void generateXMLForPage ( PageDef * pd,
TextStream & ti,
bool isExample )
static

Definition at line 2056 of file xmlgen.cpp.

2057{
2058 // + name
2059 // + title
2060 // + documentation
2061 // + location
2062
2063 const char *kindName = isExample ? "example" : "page";
2064
2065 if (pd->isReference()) return;
2066
2067 QCString pageName = pd->getOutputFileBase();
2068 if (pd->getGroupDef())
2069 {
2070 pageName+=QCString("_")+pd->name();
2071 }
2072 if (pageName=="index") pageName="indexpage"; // to prevent overwriting the generated index page.
2073
2074 ti << " <compound refid=\"" << pageName
2075 << "\" kind=\"" << kindName << "\"><name>" << convertToXML(pd->name())
2076 << "</name>\n";
2077
2078 QCString outputDirectory = Config_getString(XML_OUTPUT);
2079 QCString fileName=outputDirectory+"/"+pageName+".xml";
2080 std::ofstream f = Portable::openOutputStream(fileName);
2081 if (!f.is_open())
2082 {
2083 err("Cannot open file {} for writing!\n",fileName);
2084 return;
2085 }
2086 TextStream t(&f);
2087
2088 writeXMLHeader(t);
2089 t << " <compounddef id=\"" << pageName;
2090 t << "\" kind=\"" << kindName << "\">\n";
2091 t << " <compoundname>" << convertToXML(pd->name())
2092 << "</compoundname>\n";
2093
2094 if (pd==Doxygen::mainPage.get()) // main page is special
2095 {
2096 QCString title;
2097 if (mainPageHasTitle())
2098 {
2100 }
2101 else
2102 {
2103 title = Config_getString(PROJECT_NAME);
2104 }
2105 t << " <title>" << convertToXML(convertCharEntitiesToUTF8(title))
2106 << "</title>\n";
2107 }
2108 else
2109 {
2110 const SectionInfo *si = SectionManager::instance().find(pd->name());
2111 if (si)
2112 {
2113 t << " <title>" << convertToXML(filterTitle(convertCharEntitiesToUTF8(si->title())))
2114 << "</title>\n";
2115 }
2116 }
2118 const SectionRefs &sectionRefs = pd->getSectionRefs();
2119 if (pd->localToc().isXmlEnabled() && !sectionRefs.empty())
2120 {
2121 int level=1;
2122 int indent=0;
2123 auto writeIndent = [&]() { for (int i=0;i<4+indent*2;i++) t << " "; };
2124 auto incIndent = [&](const char *text) { writeIndent(); t << text << "\n"; indent++; };
2125 auto decIndent = [&](const char *text) { indent--; writeIndent(); t << text << "\n"; };
2126 incIndent("<tableofcontents>");
2127 int maxLevel = pd->localToc().xmlLevel();
2128 BoolVector inLi(maxLevel+1,false);
2129 for (const SectionInfo *si : sectionRefs)
2130 {
2131 if (si->type().isSection())
2132 {
2133 //printf(" level=%d title=%s\n",level,qPrint(si->title));
2134 int nextLevel = si->type().level();
2135 if (nextLevel>level)
2136 {
2137 for (int l=level;l<nextLevel;l++)
2138 {
2139 if (l < maxLevel) incIndent("<tableofcontents>");
2140 }
2141 }
2142 else if (nextLevel<level)
2143 {
2144 for (int l=level;l>nextLevel;l--)
2145 {
2146 if (l <= maxLevel && inLi[l]) decIndent("</tocsect>");
2147 inLi[l]=false;
2148 if (l <= maxLevel) decIndent("</tableofcontents>");
2149 }
2150 }
2151 if (nextLevel <= maxLevel)
2152 {
2153 if (inLi[nextLevel])
2154 {
2155 decIndent("</tocsect>");
2156 }
2157 else if (level>nextLevel)
2158 {
2159 decIndent("</tableofcontents>");
2160 incIndent("<tableofcontents>");
2161 }
2162 QCString titleDoc = convertToXML(si->title());
2163 QCString label = convertToXML(si->label());
2164 if (titleDoc.isEmpty()) titleDoc = label;
2165 incIndent("<tocsect>");
2166 writeIndent(); t << "<name>" << titleDoc << "</name>\n"; // kept for backwards compatibility
2167 writeIndent(); t << "<docs>";
2168 if (!si->title().isEmpty())
2169 {
2170 writeXMLDocBlock(t,pd->docFile(),pd->docLine(),pd,nullptr,si->title());
2171 }
2172 t << "</docs>\n";
2173 writeIndent(); t << "<reference>" << convertToXML(pageName) << "_1" << label << "</reference>\n";
2174 inLi[nextLevel]=true;
2175 level = nextLevel;
2176 }
2177 }
2178 }
2179 while (level>1 && level <= maxLevel)
2180 {
2181 if (inLi[level]) decIndent("</tocsect>");
2182 inLi[level]=false;
2183 decIndent("</tableofcontents>");
2184 level--;
2185 }
2186 if (level <= maxLevel && inLi[level]) decIndent("</tocsect>");
2187 inLi[level]=false;
2188 decIndent("</tableofcontents>");
2189 }
2190 t << " <briefdescription>\n";
2191 writeXMLDocBlock(t,pd->briefFile(),pd->briefLine(),pd,nullptr,pd->briefDescription());
2192 t << " </briefdescription>\n";
2193 t << " <detaileddescription>\n";
2194 if (isExample)
2195 {
2196 writeXMLDocBlock(t,pd->docFile(),pd->docLine(),pd,nullptr,
2197 pd->documentation()+"\n\\include "+pd->name());
2198 }
2199 else
2200 {
2201 writeXMLDocBlock(t,pd->docFile(),pd->docLine(),pd,nullptr,
2202 pd->documentation());
2203 }
2204 t << " </detaileddescription>\n";
2205
2206 t << " <location file=\"" << convertToXML(stripFromPath(pd->getDefFileName())) << "\"/>\n";
2207
2208 t << " </compounddef>\n";
2209 t << "</doxygen>\n";
2210
2211 ti << " </compound>\n";
2212}
virtual const SectionRefs & getSectionRefs() const =0
returns the section dictionary, only of importance for pagedef
const T * find(const std::string &key) const
Definition linkedmap.h:47
bool isXmlEnabled() const
Definition types.h:617
int xmlLevel() const
Definition types.h:622
virtual const PageLinkedRefMap & getSubPages() const =0
virtual LocalToc localToc() const =0
virtual const GroupDef * getGroupDef() const =0
class that provide information about a section.
Definition section.h:57
QCString label() const
Definition section.h:68
QCString title() const
Definition section.h:69
SectionType type() const
Definition section.h:70
static SectionManager & instance()
returns a reference to the singleton
Definition section.h:178
class that represents a list of constant references to sections.
Definition section.h:102
bool empty() const
Definition section.h:124
constexpr bool isSection() const
Definition section.h:46
constexpr int level() const
Definition section.h:45
std::vector< bool > BoolVector
Definition containers.h:36
static void writeIndent(TextStream &t, int indent)
Definition qhp.cpp:37
bool mainPageHasTitle()
Definition util.cpp:6194
QCString filterTitle(const QCString &title)
Definition util.cpp:5526
QCString convertCharEntitiesToUTF8(const QCString &str)
Definition util.cpp:3968

References Definition::briefDescription(), Definition::briefFile(), Definition::briefLine(), Config_getString, convertCharEntitiesToUTF8(), convertToXML(), Definition::docFile(), Definition::docLine(), Definition::documentation(), SectionRefs::empty(), err, filterTitle(), LinkedMap< T, Hash, KeyEqual, Map >::find(), Definition::getDefFileName(), PageDef::getGroupDef(), Definition::getOutputFileBase(), Definition::getSectionRefs(), PageDef::getSubPages(), SectionManager::instance(), QCString::isEmpty(), Definition::isReference(), LocalToc::isXmlEnabled(), PageDef::localToc(), Doxygen::mainPage, mainPageHasTitle(), Definition::name(), Portable::openOutputStream(), stripFromPath(), PageDef::title(), SectionInfo::title(), writeIndent(), writeInnerPages(), writeXMLDocBlock(), writeXMLHeader(), and LocalToc::xmlLevel().

Referenced by generateXML().

◆ generateXMLSection()

void generateXMLSection ( const Definition * d,
TextStream & ti,
TextStream & t,
const MemberList * ml,
const QCString & kind,
const QCString & header = QCString(),
const QCString & documentation = QCString() )
static

Definition at line 1293 of file xmlgen.cpp.

1296{
1297 if (ml==nullptr) return;
1298 int count=0;
1299 for (const auto &md : *ml)
1300 {
1301 if (memberVisible(d,md) && (md->memberType()!=MemberType::EnumValue) &&
1302 !md->isHidden())
1303 {
1304 count++;
1305 }
1306 }
1307 if (count==0) return; // empty list
1308
1309 t << " <sectiondef kind=\"" << kind << "\">\n";
1310 if (!header.isEmpty())
1311 {
1312 t << " <header>" << convertToXML(header) << "</header>\n";
1313 }
1314 if (!documentation.isEmpty())
1315 {
1316 t << " <description>";
1317 writeXMLDocBlock(t,d->docFile(),d->docLine(),d,nullptr,documentation);
1318 t << "</description>\n";
1319 }
1320 for (const auto &md : *ml)
1321 {
1322 if (memberVisible(d,md))
1323 {
1324 generateXMLForMember(md,ti,t,d);
1325 }
1326 }
1327 t << " </sectiondef>\n";
1328}
static bool memberVisible(const Definition *d, const MemberDef *md)
Definition xmlgen.cpp:1286
static void generateXMLForMember(const MemberDef *md, TextStream &ti, TextStream &t, const Definition *def)
Definition xmlgen.cpp:683

References convertToXML(), Definition::docFile(), Definition::docLine(), EnumValue, generateXMLForMember(), memberVisible(), and writeXMLDocBlock().

Referenced by generateXMLForClass(), generateXMLForFile(), generateXMLForGroup(), generateXMLForModule(), and generateXMLForNamespace().

◆ memberOutputFileBase()

QCString memberOutputFileBase ( const MemberDef * md)
static

Definition at line 581 of file xmlgen.cpp.

582{
583 //bool inlineGroupedClasses = Config_getBool(INLINE_GROUPED_CLASSES);
584 //if (inlineGroupedClasses && md->getClassDef() && md->getClassDef()->partOfGroups()!=0)
585 // return md->getClassDef()->getXmlOutputFileBase();
586 //else
587 // return md->getOutputFileBase();
588 return md->getOutputFileBase();
589}

References Definition::getOutputFileBase().

Referenced by generateXMLForMember(), and writeListOfAllMembers().

◆ memberVisible()

bool memberVisible ( const Definition * d,
const MemberDef * md )
static

Definition at line 1286 of file xmlgen.cpp.

1287{
1288 return Config_getBool(XML_NS_MEMB_FILE_SCOPE) ||
1290 md->getNamespaceDef()==nullptr;
1291}
virtual const NamespaceDef * getNamespaceDef() const =0

References Config_getBool, Definition::definitionType(), MemberDef::getNamespaceDef(), and Definition::TypeFile.

Referenced by generateXMLSection().

◆ stripAnonymousMarkers()

void stripAnonymousMarkers ( QCString & s)
static

Definition at line 531 of file xmlgen.cpp.

532{
533 auto isDigit = [](char c) { return c>='0' && c<='9'; };
534 int len = static_cast<int>(s.length());
535 int i=0,j=0;
536 if (len>0)
537 {
538 while (i<len)
539 {
540 if (i<len-1 && s[i]=='@' && isDigit(s[i+1])) // found pattern '@\d+'
541 {
542 if (j>=2 && i>=2 && s[i-2]==':' && s[i-1]==':') j-=2; // found pattern '::@\d+'
543 i+=2; // skip over @ and first digit
544 while (i<len && isDigit(s[i])) i++; // skip additional digits
545 }
546 else // copy characters
547 {
548 s[j++]=s[i++];
549 }
550 }
551 // resize resulting string
552 s.resize(j);
553 }
554}
void resize(size_t newlen)
Definition qcstring.h:180

References QCString::length(), and QCString::resize().

Referenced by generateXMLForClass(), generateXMLForConcept(), generateXMLForMember(), and generateXMLForNamespace().

◆ stripKeyword()

bool stripKeyword ( QCString & str,
const char * keyword,
bool needSpace )
static

Definition at line 595 of file xmlgen.cpp.

596{
597 bool found = false;
598 int searchStart = 0;
599 int len = static_cast<int>(strlen(keyword));
600 int searchEnd = static_cast<int>(str.size());
601 while (searchStart<searchEnd)
602 {
603 int index = str.find(keyword, searchStart);
604 if (index==-1)
605 {
606 break; // no more occurrences found
607 }
608 int end = index + len;
609 if (needSpace)
610 {
611 if ((index>0 && str[index-1]!=' ') || // at the start of the string or preceded by a space, or
612 (end!=searchEnd && str[end] !=' ') // at the end of the string or followed by a space.
613 )
614 {
615 searchStart = end;
616 continue; // no a standalone word
617 }
618 }
619 if (needSpace && index>0) // strip with space before keyword
620 {
621 str.remove(index-1, len+1);
622 searchEnd -= (len+1);
623 }
624 else if (needSpace && end<searchEnd) // strip with space after string starting with keyword
625 {
626 str.remove(index, len+1);
627 searchEnd -= (len+1);
628 }
629 else // strip just keyword
630 {
631 str.remove(index, len);
632 searchEnd -= len;
633 }
634 found = true;
635 }
636 return found;
637}
QCString & remove(size_t index, size_t len)
Definition qcstring.h:442
size_t size() const
Returns the length of the string, not counting the 0-terminator.
Definition qcstring.h:169
DirIterator end(const DirIterator &) noexcept
Definition dir.cpp:175

References end(), QCString::find(), QCString::remove(), and QCString::size().

Referenced by generateXMLForMember().

◆ stripQualifiers()

void stripQualifiers ( QCString & typeStr)
static

Definition at line 556 of file xmlgen.cpp.

557{
558 bool done=false;
559 typeStr.stripPrefix("friend ");
560 while (!done)
561 {
562 if (typeStr.stripPrefix("static ")) {}
563 else if (typeStr.stripPrefix("constexpr ")) {}
564 else if (typeStr.stripPrefix("consteval ")) {}
565 else if (typeStr.stripPrefix("constinit ")) {}
566 else if (typeStr.stripPrefix("virtual ")) {}
567 else if (typeStr=="virtual") typeStr="";
568 else done=TRUE;
569 }
570}

References QCString::stripPrefix(), and TRUE.

Referenced by generateXMLForMember().

◆ writeCombineScript()

void writeCombineScript ( )
static

Definition at line 134 of file xmlgen.cpp.

135{
136 QCString outputDirectory = Config_getString(XML_OUTPUT);
137 QCString fileName=outputDirectory+"/combine.xslt";
138 std::ofstream t = Portable::openOutputStream(fileName);
139 if (!t.is_open())
140 {
141 err("Cannot open file {} for writing!\n",fileName);
142 return;
143 }
144
145 t <<
146 "<!-- XSLT script to combine the generated output into a single file. \n"
147 " If you have xsltproc you could use:\n"
148 " xsltproc combine.xslt index.xml >all.xml\n"
149 "-->\n"
150 "<xsl:stylesheet xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\" version=\"1.0\">\n"
151 " <xsl:output method=\"xml\" version=\"1.0\" indent=\"no\" standalone=\"yes\" />\n"
152 " <xsl:template match=\"/\">\n"
153 " <doxygen version=\"{doxygenindex/@version}\" xml:lang=\"{doxygenindex/@xml:lang}\">\n"
154 " <!-- Load all doxygen generated xml files -->\n"
155 " <xsl:for-each select=\"doxygenindex/compound\">\n"
156 " <xsl:copy-of select=\"document( concat( @refid, '.xml' ) )/doxygen/*\" />\n"
157 " </xsl:for-each>\n"
158 " </doxygen>\n"
159 " </xsl:template>\n"
160 "</xsl:stylesheet>\n";
161
162}

References Config_getString, err, and Portable::openOutputStream().

Referenced by generateXML().

◆ writeExports()

void writeExports ( const ImportInfoMap & exportMap,
TextStream & t )
static

Definition at line 1407 of file xmlgen.cpp.

1408{
1409 if (exportMap.empty()) return;
1410 t << " <exports>\n";
1411 for (const auto &[moduleName,importInfoList] : exportMap)
1412 {
1413 for (const auto &importInfo : importInfoList)
1414 {
1415 t << " <export";
1416 ModuleDef *mod = ModuleManager::instance().getPrimaryInterface(importInfo.importName);
1417 if (mod && mod->isLinkableInProject())
1418 {
1419 t << " refid=\"" << mod->getOutputFileBase() << "\"";
1420 }
1421 t << ">";
1422 t << importInfo.importName;
1423 t << "</export>\n";
1424 }
1425 }
1426 t << " </exports>\n";
1427}
virtual bool isLinkableInProject() const =0
ModuleDef * getPrimaryInterface(const QCString &moduleName) const

References Definition::getOutputFileBase(), ModuleManager::getPrimaryInterface(), ModuleManager::instance(), and Definition::isLinkableInProject().

Referenced by generateXMLForModule().

◆ writeIncludeInfo()

void writeIncludeInfo ( const IncludeInfo * ii,
TextStream & t )
static

Definition at line 1473 of file xmlgen.cpp.

1474{
1475 if (ii)
1476 {
1477 QCString nm = ii->includeName;
1478 if (nm.isEmpty() && ii->fileDef) nm = ii->fileDef->docName();
1479 if (!nm.isEmpty())
1480 {
1481 t << " <includes";
1482 if (ii->fileDef && !ii->fileDef->isReference()) // TODO: support external references
1483 {
1484 t << " refid=\"" << ii->fileDef->getOutputFileBase() << "\"";
1485 }
1486 t << " local=\"" << ((ii->kind & IncludeKind_LocalMask) ? "yes" : "no") << "\">";
1487 t << nm;
1488 t << "</includes>\n";
1489 }
1490 }
1491}
virtual const QCString & docName() const =0
QCString includeName
Definition filedef.h:80
IncludeKind kind
Definition filedef.h:81
const FileDef * fileDef
Definition filedef.h:79

References FileDef::docName(), IncludeInfo::fileDef, Definition::getOutputFileBase(), IncludeKind_LocalMask, IncludeInfo::includeName, QCString::isEmpty(), Definition::isReference(), and IncludeInfo::kind.

Referenced by generateXMLForClass(), and generateXMLForConcept().

◆ writeInnerClasses()

void writeInnerClasses ( const ClassLinkedRefMap & cl,
TextStream & t )
static

Definition at line 1357 of file xmlgen.cpp.

1358{
1359 for (const auto &cd : cl)
1360 {
1361 if (!cd->isHidden() && !cd->isAnonymous())
1362 {
1363 t << " <innerclass refid=\"" << classOutputFileBase(cd)
1364 << "\" prot=\"" << to_string_lower(cd->protection());
1365 t << "\">" << convertToXML(cd->name()) << "</innerclass>\n";
1366 }
1367 }
1368}

References classOutputFileBase(), convertToXML(), and to_string_lower().

Referenced by generateXMLForClass(), generateXMLForFile(), generateXMLForGroup(), generateXMLForModule(), and generateXMLForNamespace().

◆ writeInnerConcepts()

void writeInnerConcepts ( const ConceptLinkedRefMap & cl,
TextStream & t )
static

Definition at line 1370 of file xmlgen.cpp.

1371{
1372 for (const auto &cd : cl)
1373 {
1374 if (cd->isHidden())
1375 {
1376 t << " <innerconcept refid=\"" << cd->getOutputFileBase()
1377 << "\">" << convertToXML(cd->name()) << "</innerconcept>\n";
1378 }
1379 }
1380}

References convertToXML().

Referenced by generateXMLForFile(), generateXMLForGroup(), generateXMLForModule(), and generateXMLForNamespace().

◆ writeInnerDirs()

void writeInnerDirs ( const DirList * dl,
TextStream & t )
static

Definition at line 1461 of file xmlgen.cpp.

1462{
1463 if (dl)
1464 {
1465 for(const auto subdir : *dl)
1466 {
1467 t << " <innerdir refid=\"" << subdir->getOutputFileBase()
1468 << "\">" << convertToXML(subdir->displayName()) << "</innerdir>\n";
1469 }
1470 }
1471}

References convertToXML().

Referenced by generateXMLForDir().

◆ writeInnerFiles()

void writeInnerFiles ( const FileList & fl,
TextStream & t )
static

Definition at line 1429 of file xmlgen.cpp.

1430{
1431 for (const auto &fd : fl)
1432 {
1433 t << " <innerfile refid=\"" << fd->getOutputFileBase()
1434 << "\">" << convertToXML(fd->name()) << "</innerfile>\n";
1435 }
1436}

References convertToXML().

Referenced by generateXMLForDir(), generateXMLForGroup(), and generateXMLForModule().

◆ writeInnerGroups()

void writeInnerGroups ( const GroupList & gl,
TextStream & t )
static

Definition at line 1451 of file xmlgen.cpp.

1452{
1453 for (const auto &sgd : gl)
1454 {
1455 t << " <innergroup refid=\"" << sgd->getOutputFileBase()
1456 << "\">" << convertToXML(sgd->groupTitle())
1457 << "</innergroup>\n";
1458 }
1459}

References convertToXML().

Referenced by generateXMLForGroup().

◆ writeInnerModules()

void writeInnerModules ( const ModuleLinkedRefMap & ml,
TextStream & t )
static

Definition at line 1382 of file xmlgen.cpp.

1383{
1384 for (const auto &mod : ml)
1385 {
1386 if (mod->isHidden())
1387 {
1388 t << " <innermodule refid=\"" << mod->getOutputFileBase()
1389 << "\">" << convertToXML(mod->name()) << "</innermodule>\n";
1390 }
1391 }
1392}

References convertToXML().

Referenced by generateXMLForGroup().

◆ writeInnerNamespaces()

void writeInnerNamespaces ( const NamespaceLinkedRefMap & nl,
TextStream & t )
static

Definition at line 1394 of file xmlgen.cpp.

1395{
1396 for (const auto &nd : nl)
1397 {
1398 if (!nd->isHidden() && !nd->isAnonymous())
1399 {
1400 t << " <innernamespace refid=\"" << nd->getOutputFileBase()
1401 << "\"" << (nd->isInline() ? " inline=\"yes\"" : "")
1402 << ">" << convertToXML(nd->name()) << "</innernamespace>\n";
1403 }
1404 }
1405}

References convertToXML().

Referenced by generateXMLForFile(), generateXMLForGroup(), and generateXMLForNamespace().

◆ writeInnerPages()

void writeInnerPages ( const PageLinkedRefMap & pl,
TextStream & t )
static

Definition at line 1438 of file xmlgen.cpp.

1439{
1440 for (const auto &pd : pl)
1441 {
1442 t << " <innerpage refid=\"" << pd->getOutputFileBase();
1443 if (pd->getGroupDef())
1444 {
1445 t << "_" << pd->name();
1446 }
1447 t << "\">" << convertToXML(pd->title()) << "</innerpage>\n";
1448 }
1449}

References convertToXML().

Referenced by generateXMLForGroup(), and generateXMLForPage().

◆ writeListOfAllMembers()

void writeListOfAllMembers ( const ClassDef * cd,
TextStream & t )
static

Definition at line 1330 of file xmlgen.cpp.

1331{
1332 t << " <listofallmembers>\n";
1333 for (auto &mni : cd->memberNameInfoLinkedMap())
1334 {
1335 for (auto &mi : *mni)
1336 {
1337 const MemberDef *md=mi->memberDef();
1338 if (!md->isAnonymous())
1339 {
1340 Protection prot = mi->prot();
1341 Specifier virt=md->virtualness();
1342 t << " <member refid=\"" << memberOutputFileBase(md) << "_1" <<
1343 md->anchor() << "\" prot=\"" << to_string_lower(prot);
1344 t << "\" virt=\"" << to_string_lower(virt) << "\"";
1345 if (!mi->ambiguityResolutionScope().isEmpty())
1346 {
1347 t << " ambiguityscope=\"" << convertToXML(mi->ambiguityResolutionScope()) << "\"";
1348 }
1349 t << "><scope>" << convertToXML(cd->name()) << "</scope><name>" <<
1350 convertToXML(md->name()) << "</name></member>\n";
1351 }
1352 }
1353 }
1354 t << " </listofallmembers>\n";
1355}
virtual const MemberNameInfoLinkedMap & memberNameInfoLinkedMap() const =0
Returns a dictionary of all members.
Protection
Definition types.h:32
Specifier
Definition types.h:80

References Definition::anchor(), convertToXML(), Definition::isAnonymous(), ClassDef::memberNameInfoLinkedMap(), memberOutputFileBase(), Definition::name(), to_string_lower(), and MemberDef::virtualness().

Referenced by generateXMLForClass().

◆ writeMemberReference()

void writeMemberReference ( TextStream & t,
const Definition * def,
const MemberDef * rmd,
const QCString & tagName )
static

Definition at line 506 of file xmlgen.cpp.

507{
508 QCString scope = rmd->getScopeString();
509 QCString name = rmd->name();
510 if (!scope.isEmpty() && scope!=def->name())
511 {
513 }
514 t << " <" << tagName << " refid=\"";
515 t << rmd->getOutputFileBase() << "_1" << rmd->anchor() << "\"";
516 if (rmd->getStartBodyLine()!=-1 && rmd->getBodyDef())
517 {
518 t << " compoundref=\"" << rmd->getBodyDef()->getOutputFileBase() << "\"";
519 t << " startline=\"" << rmd->getStartBodyLine() << "\"";
520 if (rmd->getEndBodyLine()!=-1)
521 {
522 t << " endline=\"" << rmd->getEndBodyLine() << "\"";
523 }
524 }
525 t << ">" << convertToXML(name) << "</" << tagName << ">\n";
526
527}
virtual QCString getScopeString() const =0
QCString & prepend(const char *s)
Definition qcstring.h:422
QCString getLanguageSpecificSeparator(SrcLangExt lang, bool classScope)
Returns the scope separator to use given the programming language lang.
Definition util.cpp:5809

References Definition::anchor(), convertToXML(), Definition::getBodyDef(), Definition::getEndBodyLine(), Definition::getLanguage(), getLanguageSpecificSeparator(), Definition::getOutputFileBase(), MemberDef::getScopeString(), Definition::getStartBodyLine(), QCString::isEmpty(), Definition::name(), and QCString::prepend().

Referenced by generateXMLForMember().

◆ writeMemberTemplateLists()

void writeMemberTemplateLists ( const MemberDef * md,
TextStream & t )
static

Definition at line 432 of file xmlgen.cpp.

433{
435}
virtual const ClassDef * getClassDef() const =0
virtual const ArgumentList & templateArguments() const =0
static void writeTemplateArgumentList(TextStream &t, const ArgumentList &al, const Definition *scope, const FileDef *fileScope, int indent)
Definition xmlgen.cpp:375

References MemberDef::getClassDef(), MemberDef::getFileDef(), MemberDef::templateArguments(), and writeTemplateArgumentList().

Referenced by generateXMLForMember().

◆ writeTemplateArgumentList()

void writeTemplateArgumentList ( TextStream & t,
const ArgumentList & al,
const Definition * scope,
const FileDef * fileScope,
int indent )
static

Definition at line 375 of file xmlgen.cpp.

380{
381 QCString indentStr;
382 indentStr.fill(' ',indent);
383 if (al.hasParameters())
384 {
385 t << indentStr << "<templateparamlist>\n";
386 for (const Argument &a : al)
387 {
388 t << indentStr << " <param>\n";
389 if (!a.type.isEmpty())
390 {
391 t << indentStr << " <type>";
392 linkifyText(TextGeneratorXMLImpl(t),scope,fileScope,nullptr,a.type);
393 t << "</type>\n";
394 }
395 if (!a.name.isEmpty())
396 {
397 t << indentStr << " <declname>" << convertToXML(a.name) << "</declname>\n";
398 t << indentStr << " <defname>" << convertToXML(a.name) << "</defname>\n";
399 }
400 if (!a.defval.isEmpty())
401 {
402 t << indentStr << " <defval>";
403 linkifyText(TextGeneratorXMLImpl(t),scope,fileScope,nullptr,a.defval);
404 t << "</defval>\n";
405 }
406 if (!a.typeConstraint.isEmpty())
407 {
408 t << indentStr << " <typeconstraint>";
409 linkifyText(TextGeneratorXMLImpl(t),scope,fileScope,nullptr,a.typeConstraint);
410 t << "</typeconstraint>\n";
411 }
412 if (a.hasTemplateDocumentation())
413 {
414 t << indentStr << " <briefdescription>\n";
415 t << indentStr << " ";
416 if (scope)
417 {
418 writeXMLDocBlock(t,scope->briefFile(),scope->briefLine(),scope,nullptr,a.docs);
419 }
420 else
421 {
422 writeXMLDocBlock(t,fileScope->briefFile(),fileScope->briefLine(),fileScope,nullptr,a.docs);
423 }
424 t << indentStr << " </briefdescription>\n";
425 }
426 t << indentStr << " </param>\n";
427 }
428 t << indentStr << "</templateparamlist>\n";
429 }
430}
QCString fill(char c, int len=-1)
Fills a string with a predefined character.
Definition qcstring.h:193

References Definition::briefFile(), Definition::briefLine(), convertToXML(), QCString::fill(), ArgumentList::hasParameters(), linkifyText(), and writeXMLDocBlock().

Referenced by writeMemberTemplateLists(), writeTemplateList(), and writeTemplateList().

◆ writeTemplateList() [1/2]

void writeTemplateList ( const ClassDef * cd,
TextStream & t )
static

Definition at line 437 of file xmlgen.cpp.

438{
440}
virtual const ArgumentList & templateArguments() const =0
Returns the template arguments of this class.

References ClassDef::getFileDef(), ClassDef::templateArguments(), and writeTemplateArgumentList().

Referenced by generateXMLForClass(), and generateXMLForConcept().

◆ writeTemplateList() [2/2]

void writeTemplateList ( const ConceptDef * cd,
TextStream & t )
static

Definition at line 442 of file xmlgen.cpp.

443{
445}
virtual ArgumentList getTemplateParameterList() const =0

References ConceptDef::getFileDef(), ConceptDef::getTemplateParameterList(), and writeTemplateArgumentList().

◆ writeXMLCodeBlock()

void writeXMLCodeBlock ( TextStream & t,
FileDef * fd )

Definition at line 480 of file xmlgen.cpp.

481{
482 auto intf=Doxygen::parserManager->getCodeParser(fd->getDefFileExtension());
484 intf->resetCodeParserState();
485 OutputCodeList xmlList;
486 xmlList.add<XMLCodeGenerator>(&t);
487 xmlList.startCodeFragment("DoxyCode");
488 intf->parseCode(xmlList, // codeOutList
489 QCString(), // scopeName
490 fileToString(fd->absFilePath(),Config_getBool(FILTER_SOURCE_FILES)),
491 langExt, // lang
492 Config_getBool(STRIP_CODE_COMMENTS),
493 FALSE, // isExampleBlock
494 QCString(), // exampleName
495 fd, // fileDef
496 -1, // startLine
497 -1, // endLine
498 FALSE, // inlineFragment
499 nullptr, // memberDef
500 TRUE // showLineNumbers
501 );
502 //xmlList.get<XMLCodeGenerator>(OutputType::XML)->finish();
503 xmlList.endCodeFragment("DoxyCode");
504}
virtual QCString getDefFileExtension() const =0
static ParserManager * parserManager
Definition doxygen.h:131
Class representing a list of different code generators.
Definition outputlist.h:165
void add(OutputCodeIntfPtr &&p)
Definition outputlist.h:195
void endCodeFragment(const QCString &style)
Definition outputlist.h:282
void startCodeFragment(const QCString &style)
Definition outputlist.h:279
SrcLangExt
Definition types.h:207
SrcLangExt getLanguageFromFileName(const QCString &fileName, SrcLangExt defLang)
Definition util.cpp:5107
QCString fileToString(const QCString &name, bool filter, bool isSourceCode)
Definition util.cpp:1439

References FileDef::absFilePath(), OutputCodeList::add(), Config_getBool, OutputCodeList::endCodeFragment(), FALSE, fileToString(), Definition::getDefFileExtension(), getLanguageFromFileName(), Doxygen::parserManager, OutputCodeList::startCodeFragment(), and TRUE.

Referenced by generateXMLForFile().

◆ writeXMLCodeString()

void writeXMLCodeString ( bool hide,
TextStream & t,
const QCString & str,
size_t & col,
size_t stripIndentAmount )
inline

Definition at line 75 of file xmlgen.cpp.

76{
77 if (str.isEmpty()) return;
78 const int tabSize = Config_getInt(TAB_SIZE);
79 const char *s = str.data();
80 char c=0;
81 if (hide) // only update column count
82 {
83 col=updateColumnCount(s,col);
84 }
85 else // actually output content and keep track of m_col
86 {
87 while ((c=*s++))
88 {
89 switch(c)
90 {
91 case '\t':
92 {
93 int spacesToNextTabStop = tabSize - (col%tabSize);
94 while (spacesToNextTabStop--)
95 {
96 if (col>=stripIndentAmount) t << "<sp/>";
97 col++;
98 }
99 break;
100 }
101 case ' ':
102 if (col>=stripIndentAmount) t << "<sp/>";
103 col++;
104 break;
105 case '<': t << "&lt;"; col++; break;
106 case '>': t << "&gt;"; col++; break;
107 case '&': t << "&amp;"; col++; break;
108 case '\'': t << "&apos;"; col++; break;
109 case '"': t << "&quot;"; col++; break;
110 case 1: case 2: case 3: case 4: case 5: case 6: case 7: case 8:
111 case 11: case 12: case 13: case 14: case 15: case 16: case 17: case 18:
112 case 19: case 20: case 21: case 22: case 23: case 24: case 25: case 26:
113 case 27: case 28: case 29: case 30: case 31:
114 // encode invalid XML characters (see http://www.w3.org/TR/2000/REC-xml-20001006#NT-Char)
115 t << "<sp value=\"" << int(c) << "\"/>";
116 break;
117 default: s=writeUTF8Char(t,s-1); col++; break;
118 }
119 }
120 }
121}
#define Config_getInt(name)
Definition config.h:34
const char * writeUTF8Char(TextStream &t, const char *s)
Writes the UTF8 character pointed to by s to stream t and returns a pointer to the next character.
Definition utf8.cpp:197
size_t updateColumnCount(const char *s, size_t col)
Definition util.cpp:6790

References Config_getInt, QCString::data(), QCString::isEmpty(), updateColumnCount(), and writeUTF8Char().

Referenced by XMLCodeGenerator::codify().

◆ writeXMLDocBlock()

void writeXMLDocBlock ( TextStream & t,
const QCString & fileName,
int lineNr,
const Definition * scope,
const MemberDef * md,
const QCString & text )
static

Definition at line 447 of file xmlgen.cpp.

453{
454 QCString stext = text.stripWhiteSpace();
455 if (stext.isEmpty()) return;
456 // convert the documentation string into an abstract syntax tree
457 auto parser { createDocParser() };
458 auto ast { validatingParseDoc(*parser.get(),
459 fileName,
460 lineNr,
461 scope,
462 md,
463 text,
464 DocOptions())
465 };
466 auto astImpl = dynamic_cast<const DocNodeAST*>(ast.get());
467 if (astImpl)
468 {
469 // create a code generator
470 OutputCodeList xmlCodeList;
471 xmlCodeList.add<XMLCodeGenerator>(&t);
472 // create a parse tree visitor for XML
473 XmlDocVisitor visitor(t,xmlCodeList,scope?scope->getDefFileExtension():QCString(""));
474 // visit all nodes
475 std::visit(visitor,astImpl->root);
476 // clean up
477 }
478}
Class representing the abstract syntax tree of a documentation block.
Definition docnode.h:1466
Concrete visitor implementation for XML output.
IDocNodeASTPtr validatingParseDoc(IDocParser &parserIntf, const QCString &fileName, int startLine, const Definition *ctx, const MemberDef *md, const QCString &input, const DocOptions &options)
IDocParserPtr createDocParser()
factory function to create a parser
Definition docparser.cpp:55

References OutputCodeList::add(), createDocParser(), Definition::getDefFileExtension(), QCString::isEmpty(), QCString::stripWhiteSpace(), and validatingParseDoc().

Referenced by generateXMLForClass(), generateXMLForConcept(), generateXMLForDir(), generateXMLForFile(), generateXMLForGroup(), generateXMLForMember(), generateXMLForModule(), generateXMLForNamespace(), generateXMLForPage(), generateXMLSection(), and writeTemplateArgumentList().

◆ writeXMLHeader()

void writeXMLHeader ( TextStream & t)
static

Definition at line 124 of file xmlgen.cpp.

125{
126 t << "<?xml version='1.0' encoding='UTF-8' standalone='no'?>\n";
127 t << "<doxygen xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" ";
128 t << "xsi:noNamespaceSchemaLocation=\"compound.xsd\" ";
129 t << "version=\"" << getDoxygenVersion() << "\" ";
130 t << "xml:lang=\"" << theTranslator->trISOLang() << "\"";
131 t << ">\n";
132}

References theTranslator.

Referenced by generateXMLForClass(), generateXMLForConcept(), generateXMLForDir(), generateXMLForFile(), generateXMLForGroup(), generateXMLForModule(), generateXMLForNamespace(), and generateXMLForPage().

◆ writeXMLLink()

void writeXMLLink ( TextStream & t,
const QCString & extRef,
const QCString & compoundId,
const QCString & anchorId,
const QCString & text,
const QCString & tooltip )

Definition at line 164 of file xmlgen.cpp.

166{
167 t << "<ref refid=\"" << compoundId;
168 if (!anchorId.isEmpty()) t << "_1" << anchorId;
169 t << "\" kindref=\"";
170 if (!anchorId.isEmpty()) t << "member"; else t << "compound";
171 t << "\"";
172 if (!extRef.isEmpty()) t << " external=\"" << extRef << "\"";
173 if (!tooltip.isEmpty()) t << " tooltip=\"" << convertToXML(tooltip) << "\"";
174 t << ">";
175 writeXMLString(t,text);
176 t << "</ref>";
177}

References convertToXML(), QCString::isEmpty(), and writeXMLString().

Referenced by XMLCodeGenerator::writeCodeLink(), and TextGeneratorXMLImpl::writeLink().

◆ writeXMLString()