dirdef.h File Reference

#include <vector>
#include <map>
#include "dstring.h"
#include "linkedmap.h"
#include "definition.h"

Include dependency graph for dirdef.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	FilePair
	Class representing a pair of FileDef objects. More...
class	FilePairLinkedMap
	A linked map of file pairs. More...
class	UsedDir
	Usage information of a directory. More...
class	DirDef
	A model of a directory symbol. More...
class	DirDef::UsedDirLinkedMap
class	DirRelation
	A usage relation between two directories. More...
class	DirLinkedMap
	A linked map of directories. More...
class	DirList
	A list of directories. More...
class	DirRelationLinkedMap

Functions
bool	compareDirDefs (const DirDef *item1, const DirDef *item2)
DirDef *	toDirDef (Definition *d)
const DirDef *	toDirDef (const Definition *d)
void	buildDirectories ()
void	generateDirDocs (OutputList &ol)
void	computeDirDependencies ()

Function Documentation

buildDirectories()

void buildDirectories

(

)

Definition at line 1095 of file dirdef.cpp.

{
  AUTO_TRACE();
  // for each input file
  for (const auto &fn : *Doxygen::inputNameLinkedMap)
  {
    for (const auto &fd : *fn)
    {
      if (fd->getReference().empty())
      {
        DirDef *dir=Doxygen::dirLinkedMap->find(fd->getPath());
        if (dir==nullptr) // new directory
        {
          dir = DirDefImpl::mergeDirectoryInTree(fd->getPath());
        }
        if (dir && !fd->isDocumentationFile()) dir->addFile(fd.get());
      }
      else
      {
        // do something for file imported via tag files.
      }
    }
  }
 
  // compute relations between directories => introduce container dirs.
  for (const auto &dir : *Doxygen::dirLinkedMap)
  {
    DString name = dir->name();
    size_t i = name.length()>=2 ? name.rfind('/',name.length()-2) : DString::npos;
    if (i!=DString::npos && i>0)
    {
      DirDef *parent = Doxygen::dirLinkedMap->find(name.left(i+1));
      //if (parent==0) parent=root;
      if (parent)
      {
        parent->addSubDir(dir.get());
        AUTO_TRACE_ADD("DirDefImpl::addSubdir(): Adding subdir {} to {}",
                        dir->displayName(), parent->displayName());
      }
    }
  }
 
  // sort the directory contents
  for (const auto &dir : *Doxygen::dirLinkedMap)
  {
    dir->sort();
  }
 
  // short the directories themselves
  std::stable_sort(Doxygen::dirLinkedMap->begin(),
            Doxygen::dirLinkedMap->end(),
            [](const auto &d1,const auto &d2)
            {
              DString s1 = d1->shortName(), s2 = d2->shortName();
              int i = dstricmp_sort(s1,s2);
              if (i==0) // if sort name are equal, sort on full path
              {
                DString n1 = d1->name(), n2 = d2->name();
                int n = dstricmp_sort(n1,n2);
                return n < 0;
              }
              return i < 0;
            });
 
  // set the directory index identifier
  int dirIndex=0;
  for (const auto &dir : *Doxygen::dirLinkedMap)
  {
    dir->setDirIndex(dirIndex++);
  }
 
  computeCommonDirPrefix();
}

References DirDef::addFile(), AUTO_TRACE, AUTO_TRACE_ADD, begin(), computeCommonDirPrefix(), Doxygen::dirLinkedMap, dstricmp_sort(), end(), LinkedMap< T, Hash, KeyEqual, Map >::find(), Doxygen::inputNameLinkedMap, DString::left(), DString::length(), DirDefImpl::mergeDirectoryInTree(), DString::npos, parent(), and DString::rfind().

Referenced by parseInput().

compareDirDefs()

bool compareDirDefs	(	const DirDef *	item1,
		const DirDef *	item2 )

Definition at line 1208 of file dirdef.cpp.

{
  return dstricmp_sort(item1->shortName(),item2->shortName()) < 0;
}

References dstricmp_sort(), and DirDef::shortName().

Referenced by DirDefImpl::sort(), and GroupDefImpl::sortMemberLists().

computeDirDependencies()

void computeDirDependencies

(

)

Definition at line 1169 of file dirdef.cpp.

{
  AUTO_TRACE();
  // compute nesting level for each directory
  for (const auto &dir : *Doxygen::dirLinkedMap)
  {
    dir->setLevel();
  }
 
  // compute uses dependencies between directories
  for (const auto &dir : *Doxygen::dirLinkedMap)
  {
    AUTO_TRACE_ADD("computeDependencies for {}: #dirs={}",dir->name(),Doxygen::dirLinkedMap->size());
    dir->computeDependencies();
  }
}

References AUTO_TRACE, AUTO_TRACE_ADD, Doxygen::dirLinkedMap, and LinkedMap< T, Hash, KeyEqual, Map >::size().

Referenced by parseInput().

generateDirDocs()

void generateDirDocs

(

OutputList &

ol

)

Definition at line 1186 of file dirdef.cpp.

{
  AUTO_TRACE();
  for (const auto &dir : *Doxygen::dirLinkedMap)
  {
    ol.pushGeneratorState();
    if (!dir->hasDocumentation())
    {
      ol.disableAllBut(OutputType::Html);
    }
    dir->writeDocumentation(ol);
    ol.popGeneratorState();
  }
  //if (Config_getBool(DIRECTORY_GRAPH))
  {
    for (const auto &dr : Doxygen::dirRelations)
    {
      dr->writeDocumentation(ol);
    }
  }
}

References AUTO_TRACE, Doxygen::dirLinkedMap, Doxygen::dirRelations, OutputList::disableAllBut(), Html, OutputList::popGeneratorState(), and OutputList::pushGeneratorState().

Referenced by generateOutput().

toDirDef() [1/2]

const DirDef * toDirDef

(

const Definition *

d

)

Definition at line 1228 of file dirdef.cpp.

{
  if (d==nullptr) return nullptr;
  if (d && typeid(*d)==typeid(DirDefImpl))
  {
    return static_cast<const DirDef*>(d);
  }
  else
  {
    return nullptr;
  }
}

toDirDef() [2/2]

DirDef * toDirDef

(

Definition *

d

)

Definition at line 1215 of file dirdef.cpp.

{
  if (d==nullptr) return nullptr;
  if (d && typeid(*d)==typeid(DirDefImpl))
  {
    return static_cast<DirDef*>(d);
  }
  else
  {
    return nullptr;
  }
}