Htags结构体 参考

This class is a namespace for HTAGS related functions 更多...

#include <htags.h>

静态 Public 成员函数
static bool	loadFilemap (const QCString &htmldir)
static QCString	path2URL (const QCString &path)
static bool	execute (const QCString &htmldir)

静态 Public 属性
static bool	useHtags = FALSE

详细描述

This class is a namespace for HTAGS related functions

在文件 htags.h 第 21 行定义.

成员函数说明

execute()

bool Htags::execute ( const QCString &  htmldir )

static

constructs command line of htags(1) and executes it.

返回值

TRUE	success
FALSE	an error has occurred.

在文件 htags.cpp 第 38 行定义.

{
  const StringVector &inputSource = Config_getList(INPUT);
  bool quiet = Config_getBool(QUIET);
  bool warnings = Config_getBool(WARNINGS);
  QCString htagsOptions = ""; //Config_getString(HTAGS_OPTIONS);
  QCString projectName = Config_getString(PROJECT_NAME);
  QCString projectNumber = Config_getString(PROJECT_NUMBER);
 
  if (inputSource.empty())
  {
    g_inputDir.setPath(Dir::currentDirPath());
  }
  else if (inputSource.size()==1)
  {
    g_inputDir.setPath(inputSource.back());
    if (!g_inputDir.exists())
      err("Cannot find directory %s. "
          "Check the value of the INPUT tag in the configuration file.\n",
          inputSource.back().c_str()
         );
  }
  else
  {
    err("If you use USE_HTAGS then INPUT should specify a single directory.\n");
    return FALSE;
  }
 
  /*
   * Construct command line for htags(1).
   */
  QCString commandLine = " -g -s -a -n ";
  if (!quiet)   commandLine += "-v ";
  if (warnings) commandLine += "-w ";
  if (!htagsOptions.isEmpty())
  {
    commandLine += ' ';
    commandLine += htagsOptions;
  }
  if (!projectName.isEmpty())
  {
    commandLine += "-t \"";
    commandLine += projectName;
    if (!projectNumber.isEmpty())
    {
      commandLine += '-';
      commandLine += projectNumber;
    }
    commandLine += "\" ";
  }
  commandLine += " \"" + htmldir + "\"";
  std::string oldDir = Dir::currentDirPath();
  Dir::setCurrent(g_inputDir.absPath());
  //printf("CommandLine=[%s]\n",qPrint(commandLine));
  Portable::sysTimerStart();
  bool result=Portable::system("htags",commandLine,FALSE)==0;
  if (!result)
  {
    err("Problems running %s. Check your installation\n", "htags");
  }
  Portable::sysTimerStop();
  Dir::setCurrent(oldDir);
  return result;
}

引用了 Dir::absPath(), Config_getBool, Config_getList, Config_getString, Dir::currentDirPath(), err(), Dir::exists(), FALSE, g_inputDir, QCString::isEmpty(), Dir::setCurrent(), Dir::setPath(), Portable::system(), Portable::sysTimerStart() , 以及 Portable::sysTimerStop().

被这些函数引用 generateOutput().

loadFilemap()

bool Htags::loadFilemap ( const QCString &  htmlDir )

static

load filemap and make index.

参数

htmlDir

of HTML directory generated by htags(1).

返回值

TRUE	success
FALSE	error

在文件 htags.cpp 第 109 行定义.

{
  QCString fileMapName = htmlDir+"/HTML/FILEMAP";
  FileInfo fi(fileMapName.str());
  /*
   * Construct FILEMAP dictionary.
   *
   * In FILEMAP, URL includes 'html' suffix but we cut it off according
   * to the method of FileDef class.
   *
   * FILEMAP format:
   * <NAME>\t<HREF>.html\n
   * QDICT:
   * dict[<NAME>] = <HREF>
   */
  if (fi.exists() && fi.isReadable())
  {
    std::ifstream f(fileMapName.str(),std::ifstream::in);
    if (f.is_open())
    {
      std::string lineStr;
      while (getline(f,lineStr))
      {
        QCString line(lineStr);
        //printf("Read line: %s",qPrint(line));
        int sep = line.find('\t');
        if (sep!=-1)
        {
          QCString key   = line.left(sep).stripWhiteSpace();
          QCString value = line.mid(sep+1).stripWhiteSpace();
          int ext=value.findRev('.');
          if (ext!=-1) value=value.left(ext); // strip extension
          g_symbolMap.insert(std::make_pair(key.str(),value.str()));
          //printf("Key/Value=(%s,%s)\n",qPrint(key),qPrint(value));
        }
      }
      return true;
    }
    else
    {
      err("file %s cannot be opened\n",qPrint(fileMapName));
    }
  }
  return false;
}

引用了 err(), FileInfo::exists(), QCString::find(), QCString::findRev(), g_symbolMap, FileInfo::isReadable(), QCString::left(), QCString::mid(), qPrint(), QCString::str() , 以及 QCString::stripWhiteSpace().

被这些函数引用 generateOutput().

path2URL()

QCString Htags::path2URL ( const QCString &  path )

static

convert path name into the url in the hypertext generated by htags.

参数

path

path name

返回

URL NULL: not found.

在文件 htags.cpp 第 159 行定义.

{
  QCString url,symName=path;
  QCString dir = g_inputDir.absPath();
  int dl=dir.length();
  if ((int)symName.length()>dl+1)
  {
    symName = symName.mid(dl+1);
  }
  if (!symName.isEmpty())
  {
    auto it = g_symbolMap.find(symName.str());
    //printf("path2URL=%s symName=%s result=%p\n",qPrint(path),qPrint(symName),result);
    if (it!=g_symbolMap.end())
    {
      url = QCString("HTML/"+it->second);
    }
  }
  return url;
}

引用了 Dir::absPath(), g_inputDir, g_symbolMap, QCString::isEmpty(), QCString::length(), QCString::mid() , 以及 QCString::str().

被这些函数引用 FileDefImpl::getSourceFileBase().

类成员变量说明

useHtags

bool Htags::useHtags = FALSE

static

在文件 htags.h 第 23 行定义.

被这些函数引用 generateFileSources(), generateOutput(), DefinitionImpl::getSourceAnchor() , 以及 FileDefImpl::getSourceFileBase().

---

该结构体的文档由以下文件生成:

• src/htags.h
• src/htags.cpp