SearchIndexExternal Class Reference

Writes search index that should be used with an externally provided search engine, e.g. doxyindexer and doxysearch.cgi. More...

#include <src/searchindex.h>

Collaboration diagram for SearchIndexExternal:

Classes
struct	SearchDocEntry

Public Member Functions
	SearchIndexExternal ()
void	setCurrentDoc (const Definition *ctx, const DString &anchor, bool isSourceFile)
void	addWord (const DString &word, bool hiPriority)
void	write (const DString &file)

Private Attributes
std::map< std::string, SearchDocEntry >	m_docEntries
SearchDocEntry *	m_current = nullptr

Detailed Description

Writes search index that should be used with an externally provided search engine, e.g. doxyindexer and doxysearch.cgi.

Definition at line 111 of file searchindex.h.

Constructor & Destructor Documentation

SearchIndexExternal()

SearchIndexExternal::SearchIndexExternal

(

)

Definition at line 385 of file searchindex.cpp.

{
}

Member Function Documentation

addWord()

void SearchIndexExternal::addWord	(	const DString &	word,
		bool	hiPriority )

Definition at line 491 of file searchindex.cpp.

{
  std::lock_guard<std::mutex> lock(g_searchIndexMutex);
  if (word.empty() || !isId(word[0]) || m_current==nullptr) return;
  DString &text = hiPriority ? m_current->importantText : m_current->normalText;
  if (!text.empty()) text+=' ';
  text+=word;
  //printf("addWord %s\n",word);
}

References DString::empty(), g_searchIndexMutex, isId(), and m_current.

setCurrentDoc()

void SearchIndexExternal::setCurrentDoc	(	const Definition *	ctx,
		const DString &	anchor,
		bool	isSourceFile )

Definition at line 448 of file searchindex.cpp.

{
  std::lock_guard<std::mutex> lock(g_searchIndexMutex);
  DString extId = stripPath(Config_getString(EXTERNAL_SEARCH_ID));
  DString url = isSourceFile ? (toFileDef(ctx))->getSourceFileBase() : ctx->getOutputFileBase();
  addHtmlExtensionIfMissing(url);
  if (!anchor.empty()) url+=DString("#")+anchor;
  DString key = extId+";"+url;
 
  auto it = m_docEntries.find(key.str());
  if (it == m_docEntries.end())
  {
    SearchDocEntry e;
    e.type = isSourceFile ? DString("source") : definitionToName(ctx);
    e.name = ctx->qualifiedName();
    if (ctx->definitionType()==Definition::TypeMember)
    {
      e.args = (toMemberDef(ctx))->argsString();
    }
    else if (ctx->definitionType()==Definition::TypeGroup)
    {
      const GroupDef *gd = toGroupDef(ctx);
      if (!gd->groupTitle().empty())
      {
        e.name = filterTitle(gd->groupTitle());
      }
    }
    else if (ctx->definitionType()==Definition::TypePage)
    {
      const PageDef *pd = toPageDef(ctx);
      if (pd->hasTitle())
      {
        e.name = filterTitle(pd->title());
      }
    }
    e.extId = extId;
    e.url  = url;
    it = m_docEntries.emplace(key.str(),e).first;
    //printf("searchIndexExt %s : %s\n",qPrint(e->name),qPrint(e->url));
  }
  m_current = &it->second;
}

References addHtmlExtensionIfMissing(), SearchIndexExternal::SearchDocEntry::args, Config_getString, definitionToName(), Definition::definitionType(), DString::empty(), SearchIndexExternal::SearchDocEntry::extId, filterTitle(), DString::find(), g_searchIndexMutex, Definition::getOutputFileBase(), GroupDef::groupTitle(), PageDef::hasTitle(), m_current, m_docEntries, SearchIndexExternal::SearchDocEntry::name, Definition::qualifiedName(), DString::str(), stripPath(), PageDef::title(), toFileDef(), toGroupDef(), toMemberDef(), toPageDef(), SearchIndexExternal::SearchDocEntry::type, Definition::TypeGroup, Definition::TypeMember, Definition::TypePage, and SearchIndexExternal::SearchDocEntry::url.

write()

void SearchIndexExternal::write

(

const DString &

file

)

Definition at line 501 of file searchindex.cpp.

{
  std::ofstream t = Portable::openOutputStream(fileName);
  if (t.is_open())
  {
    t << "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
    t << "<add>\n";
    for (auto &[name,doc] : m_docEntries)
    {
      t << "  <doc>\n";
      t << "    <field name=\"type\">"     << doc.type << "</field>\n";
      t << "    <field name=\"name\">"     << convertToXML(doc.name) << "</field>\n";
      if (!doc.args.empty())
      {
        t << "    <field name=\"args\">"     << convertToXML(doc.args) << "</field>\n";
      }
      if (!doc.extId.empty())
      {
        t << "    <field name=\"tag\">"      << convertToXML(doc.extId)  << "</field>\n";
      }
      t << "    <field name=\"url\">"      << convertToXML(doc.url)  << "</field>\n";
      t << "    <field name=\"keywords\">" << convertToXML(doc.importantText)  << "</field>\n";
      t << "    <field name=\"text\">"     << convertToXML(doc.normalText)     << "</field>\n";
      t << "  </doc>\n";
    }
    t << "</add>\n";
  }
  else
  {
    err("Failed to open file {} for writing!\n",fileName);
  }
}

References convertToXML(), err, m_docEntries, and Portable::openOutputStream().

Member Data Documentation

m_current

SearchDocEntry* SearchIndexExternal::m_current = nullptr

private

Definition at line 131 of file searchindex.h.

Referenced by addWord(), and setCurrentDoc().

m_docEntries

std::map<std::string,SearchDocEntry> SearchIndexExternal::m_docEntries

private

Definition at line 130 of file searchindex.h.

Referenced by setCurrentDoc(), and write().

---

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

• src/searchindex.h
• src/searchindex.cpp