A helper class for HtmlHelp that manages a two level index in alphabetical order. More...

Collaboration diagram for HtmlHelpIndex:

Public Member Functions
	HtmlHelpIndex (HtmlHelpRecoder &recoder)
	~HtmlHelpIndex ()
void	addItem (const DString &first, const DString &second, const DString &url, const DString &anchor, bool hasLink, bool reversed)
void	writeFields (std::ostream &t)
size_t	size () const

Private Attributes
LinkedMap< IndexField >	m_map
HtmlHelpRecoder &	m_recoder

Detailed Description

A helper class for HtmlHelp that manages a two level index in alphabetical order.

Definition at line 113 of file htmlhelp.cpp.

Constructor & Destructor Documentation

◆ HtmlHelpIndex()

HtmlHelpIndex::HtmlHelpIndex ( HtmlHelpRecoder & recoder )

Constructs a new HtmlHelp index

Definition at line 130 of file htmlhelp.cpp.

                                                     : m_recoder(recoder)
{
}

References m_recoder.

Referenced by ~HtmlHelpIndex().

◆ ~HtmlHelpIndex()

HtmlHelpIndex::~HtmlHelpIndex ( )

default

Destroys the HtmlHelp index

References addItem(), HtmlHelpIndex(), NON_COPYABLE, and writeFields().

Member Function Documentation

◆ addItem()

void HtmlHelpIndex::addItem	(	const DString &	level1,
		const DString &	level2,
		const DString &	url,
		const DString &	anchor,
		bool	hasLink,
		bool	reversed )

Stores an item in the index if it is not already present. Items are stored in alphabetical order, by sorting on the concatenation of level1 and level2 (if present).

Parameters

level1	the string at level 1 in the index.
level2	the string at level 2 in the index (or 0 if not applicable).
url	the url of the documentation (without .html extension).
anchor	the anchor of the documentation within the page.
hasLink	if true, the url (without anchor) can be used in the level1 item, when writing the header of a list of level2 items.
reversed	true if level1 is the member name and level2 the compound name.

Definition at line 151 of file htmlhelp.cpp.

{
  static const reg::Ex re(R"(@\d+)");
  DString key = substitute(level1,"?","&quest;");
  if (!level2.empty()) key+= "?" + substitute(level2,"?","&quest;");
  if (reg::search(key.str(),re)) // skip anonymous stuff
  {
    return;
  }
  DString key_anchor = key;
  if (!anchor.empty())
  {
    key_anchor += anchor;
  }
  m_map.add(key_anchor,key,url,anchor,hasLink,reversed);
}

References LinkedMap< T, Hash, KeyEqual, Map >::add(), DString::empty(), m_map, reg::search(), DString::str(), and substitute().

Referenced by ~HtmlHelpIndex().

◆ size()

size_t HtmlHelpIndex::size ( ) const

inline

Definition at line 123 of file htmlhelp.cpp.

123{ return m_map.size(); }

LinkedMap::size

size_t size() const

Definition linkedmap.h:210

References m_map, and LinkedMap< T, Hash, KeyEqual, Map >::size().

Referenced by HtmlHelp::Private::createProjectFile().

◆ writeFields()

void HtmlHelpIndex::writeFields ( std::ostream & t )

Writes the sorted list of index items into a html like list.

An list of calls with name = level1,level2 as follows:

  a1,b1
  a1,b2
  a2,b1
  a2,b2
  a3
  a4,b1

Will result in the following list:

  a1       -> link to url if hasLink==true
    b1     -> link to url#anchor
    b2     -> link to url#anchor
  a2       -> link to url if hasLink==true
    b1     -> link to url#anchor
    b2     -> link to url#anchor
  a3       -> link to url if hasLink==true
  a4       -> link to url if hasLink==true
    b1     -> link to url#anchor

Definition at line 234 of file htmlhelp.cpp.

{
  std::stable_sort(std::begin(m_map),
            std::end(m_map),
            [](const auto &e1,const auto &e2) { return dstricmp_sort(e1->name,e2->name)<0; }
           );
  DString prevLevel1;
  bool level2Started=false;
  for (auto it = std::begin(m_map); it!=std::end(m_map); ++it)
  {
    auto &f = *it;
    DString level1,level2;
    if (size_t i = f->name.find('?'); i!=DString::npos)
    {
      level1 = f->name.left(i);
      level2 = f->name.mid(i+1);
    }
    else
    {
      level1  = f->name;
    }
 
    { // finish old list at level 2
      if (level2Started) t << "  </UL>\n";
      level2Started=false;
 
      // <Antony>
      // Added this code so that an item with only one subitem is written
      // without any subitem.
      // For example:
      //   a1, b1 -> will create only a1, not separate subitem for b1
      //   a2, b2
      //   a2, b3
      DString nextLevel1;
      auto it_next = std::next(it);
      if (it_next!=std::end(m_map))
      {
        auto &fnext = *it_next;
        size_t j = fnext->name.find('?');
        if (j==DString::npos) j=0;
        nextLevel1 = fnext->name.left(j);
      }
      if (!(level1 == prevLevel1 || level1 == nextLevel1))
      {
        level2 = "";
      }
      prevLevel1 = level1;
      // </Antony>
 
      if (level2.empty())
      {
        t << "  <LI><OBJECT type=\"text/sitemap\">";
        t << "<param name=\"Local\" value=\"" << field2URL(f.get(),false);
        t << "\">";
        t << "<param name=\"Name\" value=\"" << convertToHtmlAndTruncate(m_recoder.recode(level1)) << "\">"
           "</OBJECT>\n";
      }
      else
      {
        if (f->link)
        {
          t << "  <LI><OBJECT type=\"text/sitemap\">";
          t << "<param name=\"Local\" value=\"" << field2URL(f.get(),true);
          t << "\">";
          t << "<param name=\"Name\" value=\"" << convertToHtmlAndTruncate(m_recoder.recode(level1)) << "\">"
               "</OBJECT>\n";
        }
        else
        {
          t << "  <LI><OBJECT type=\"text/sitemap\">";
          t << "<param name=\"See Also\" value=\"" << convertToHtml(m_recoder.recode(level1)) << "\">";
          t << "<param name=\"Name\" value=\"" << convertToHtmlAndTruncate(m_recoder.recode(level1)) << "\">"
               "</OBJECT>\n";
        }
      }
    }
    if (!level2Started && !level2.empty())
    { // start new list at level 2
      t << "  <UL>\n";
      level2Started=true;
    }
    else if (level2Started && level2.empty())
    { // end list at level 2
      t << "  </UL>\n";
      level2Started=false;
    }
    if (level2Started)
    {
      t << "    <LI><OBJECT type=\"text/sitemap\">";
      t << "<param name=\"Local\" value=\"" << field2URL(f.get(),false);
      t << "\">";
      t << "<param name=\"Name\" value=\"" << convertToHtmlAndTruncate(m_recoder.recode(level2)) << "\">"
         "</OBJECT>\n";
    }
  }
  if (level2Started) t << "  </UL>\n";
}