Doxygen
Loading...
Searching...
No Matches
DocHtmlCaption Class Reference

Node representing a HTML table caption. More...

#include <src/docnode.h>

Inheritance diagram for DocHtmlCaption:
Collaboration diagram for DocHtmlCaption:

Public Member Functions

 DocHtmlCaption (DocParser *parser, DocNodeVariant *parent, const HtmlAttribList &attribs)
const HtmlAttribListattribs () const
Token parse ()
bool hasCaptionId () const
QCString file () const
QCString anchor () const
Public Member Functions inherited from DocCompoundNode
 DocCompoundNode (DocParser *parser, DocNodeVariant *parent)
DocNodeListchildren ()
const DocNodeListchildren () const
Public Member Functions inherited from DocNode
 DocNode (DocParser *parser, DocNodeVariant *parent)
 ~DocNode ()=default
DocNodeVariantparent ()
const DocNodeVariantparent () const
DocNodeVariantthisVariant ()
const DocNodeVariantthisVariant () const
void setThisVariant (DocNodeVariant *thisVariant)
DocParserparser ()
const DocParserparser () const
void setParent (DocNodeVariant *parent)
bool isPreformatted () const

Private Attributes

HtmlAttribList m_attribs
bool m_hasCaptionId = false
QCString m_file
QCString m_anchor

Additional Inherited Members

Protected Types inherited from DocNode
enum  RefType { Unknown , Anchor , Section , Table }
Protected Member Functions inherited from DocNode
void setInsidePreformatted (bool p)

Detailed Description

Node representing a HTML table caption.

Definition at line 1227 of file docnode.h.

Constructor & Destructor Documentation

◆ DocHtmlCaption()

DocHtmlCaption::DocHtmlCaption ( DocParser * parser,
DocNodeVariant * parent,
const HtmlAttribList & attribs )

Definition at line 1709 of file docnode.cpp.

1711{
1713 for (const auto &opt : attribs)
1714 {
1715 if (opt.name=="id" && !opt.value.isEmpty()) // interpret id attribute as an anchor
1716 {
1717 const SectionInfo *sec = SectionManager::instance().find(opt.value);
1718 if (sec)
1719 {
1720 //printf("Found anchor %s\n",qPrint(id));
1721 m_file = sec->fileName();
1722 m_anchor = sec->label();
1724 }
1725 else
1726 {
1727 warn_doc_error(parser->context.fileName,parser->tokenizer.getLineNr(),"Invalid caption id '{}'",opt.value);
1728 }
1729 }
1730 else // copy attribute
1731 {
1732 m_attribs.push_back(opt);
1733 }
1734 }
1735}
DocCompoundNode(DocParser *parser, DocNodeVariant *parent)
Definition docnode.h:141
HtmlAttribList m_attribs
Definition docnode.h:1238
bool m_hasCaptionId
Definition docnode.h:1239
QCString m_file
Definition docnode.h:1240
const HtmlAttribList & attribs() const
Definition docnode.h:1231
QCString m_anchor
Definition docnode.h:1241
DocParser * parser()
Definition docnode.h:98
DocNodeVariant * parent()
Definition docnode.h:90
const T * find(const std::string &key) const
Definition linkedmap.h:47
QCString label() const
Definition section.h:68
QCString fileName() const
Definition section.h:73
static SectionManager & instance()
returns a reference to the singleton
Definition section.h:178
#define warn_doc_error(file, line, fmt,...)
Definition message.h:112
#define TRUE
Definition qcstring.h:37
#define FALSE
Definition qcstring.h:34

References attribs(), DocCompoundNode::DocCompoundNode(), FALSE, SectionInfo::fileName(), LinkedMap< T, Hash, KeyEqual, Map >::find(), SectionManager::instance(), SectionInfo::label(), m_anchor, m_attribs, m_file, m_hasCaptionId, DocNode::parent(), DocNode::parser(), TRUE, and warn_doc_error.

Member Function Documentation

◆ anchor()

QCString DocHtmlCaption::anchor ( ) const
inline

◆ attribs()

const HtmlAttribList & DocHtmlCaption::attribs ( ) const
inline

Definition at line 1231 of file docnode.h.

1231{ return m_attribs; }

References m_attribs.

Referenced by DocHtmlCaption(), and HtmlDocVisitor::operator()().

◆ file()

QCString DocHtmlCaption::file ( ) const
inline

◆ hasCaptionId()

bool DocHtmlCaption::hasCaptionId ( ) const
inline

Definition at line 1233 of file docnode.h.

1233{ return m_hasCaptionId; }

References m_hasCaptionId.

◆ parse()

Token DocHtmlCaption::parse ( )

Definition at line 1737 of file docnode.cpp.

1738{
1739 AUTO_TRACE();
1740 Token retval = Token::make_TK_NONE();
1741 auto ns = AutoNodeStack(parser(),thisVariant());
1742 Token tok = parser()->tokenizer.lex();
1743 while (!tok.is_any_of(TokenRetval::TK_NONE, TokenRetval::TK_EOF))
1744 {
1745 if (!parser()->defaultHandleToken(thisVariant(),tok,children()))
1746 {
1747 switch (tok.value())
1748 {
1749 case TokenRetval::TK_HTMLTAG:
1750 {
1751 HtmlTagType tagId=Mappers::htmlTagMapper->map(parser()->context.token->name);
1752 if (tagId==HtmlTagType::HTML_CAPTION && parser()->context.token->endTag) // found </caption> tag
1753 {
1754 retval = Token::make_RetVal_OK();
1755 goto endcaption;
1756 }
1757 else
1758 {
1759 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unexpected html tag <{}{}> found within <caption> context",
1760 parser()->context.token->endTag?"/":"",parser()->context.token->name);
1761 }
1762 }
1763 break;
1764 default:
1765 parser()->errorHandleDefaultToken(thisVariant(),tok,children(),"<caption> tag");
1766 break;
1767 }
1768 }
1769 tok = parser()->tokenizer.lex();
1770 }
1771 if (tok.is_any_of(TokenRetval::TK_NONE,TokenRetval::TK_EOF))
1772 {
1773 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unexpected end of comment while inside"
1774 " <caption> tag");
1775 }
1776endcaption:
1778 return retval;
1779}
DocNodeList & children()
Definition docnode.h:143
DocNodeVariant * thisVariant()
Definition docnode.h:93
DocTokenizer tokenizer
void handlePendingStyleCommands(DocNodeVariant *parent, DocNodeList &children)
void errorHandleDefaultToken(DocNodeVariant *parent, Token tok, DocNodeList &children, const QCString &txt)
TokenRetval value() const
bool is_any_of(ARGS... args) const
HtmlTagType
Definition cmdmapper.h:169
#define AUTO_TRACE(...)
Definition docnode.cpp:46
const Mapper< HtmlTagType > * htmlTagMapper

References AUTO_TRACE, DocCompoundNode::children(), DocParser::errorHandleDefaultToken(), DocParser::handlePendingStyleCommands(), HTML_CAPTION, Mappers::htmlTagMapper, Token::is_any_of(), DocTokenizer::lex(), DocNode::parser(), DocNode::thisVariant(), DocParser::tokenizer, Token::value(), and warn_doc_error.

Member Data Documentation

◆ m_anchor

QCString DocHtmlCaption::m_anchor
private

Definition at line 1241 of file docnode.h.

Referenced by anchor(), and DocHtmlCaption().

◆ m_attribs

HtmlAttribList DocHtmlCaption::m_attribs
private

Definition at line 1238 of file docnode.h.

Referenced by attribs(), and DocHtmlCaption().

◆ m_file

QCString DocHtmlCaption::m_file
private

Definition at line 1240 of file docnode.h.

Referenced by DocHtmlCaption(), and file().

◆ m_hasCaptionId

bool DocHtmlCaption::m_hasCaptionId = false
private

Definition at line 1239 of file docnode.h.

Referenced by DocHtmlCaption(), and hasCaptionId().


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