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

Node Html heading. More...

#include <src/docnode.h>

Inheritance diagram for DocHtmlHeader:
Collaboration diagram for DocHtmlHeader:

Public Member Functions

 DocHtmlHeader (DocParser *parser, DocNodeVariant *parent, const HtmlAttribList &attribs, int level)
int level () const
const HtmlAttribListattribs () const
Token parse ()
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

int m_level = 0
HtmlAttribList m_attribs

Additional Inherited Members

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

Detailed Description

Node Html heading.

Definition at line 881 of file docnode.h.

Constructor & Destructor Documentation

◆ DocHtmlHeader()

DocHtmlHeader::DocHtmlHeader ( DocParser * parser,
DocNodeVariant * parent,
const HtmlAttribList & attribs,
int level )
inline

Definition at line 884 of file docnode.h.

884 :
DocCompoundNode(DocParser *parser, DocNodeVariant *parent)
Definition docnode.h:141
HtmlAttribList m_attribs
Definition docnode.h:892
const HtmlAttribList & attribs() const
Definition docnode.h:887
int level() const
Definition docnode.h:886
DocParser * parser()
Definition docnode.h:98
DocNodeVariant * parent()
Definition docnode.h:90

References attribs(), DocCompoundNode::DocCompoundNode(), level(), m_attribs, m_level, DocNode::parent(), and DocNode::parser().

Member Function Documentation

◆ attribs()

const HtmlAttribList & DocHtmlHeader::attribs ( ) const
inline

Definition at line 887 of file docnode.h.

887{ return m_attribs; }

References m_attribs.

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

◆ level()

◆ parse()

Token DocHtmlHeader::parse ( )

Definition at line 1378 of file docnode.cpp.

1379{
1380 AUTO_TRACE();
1381 Token retval(TokenRetval::RetVal_OK);
1382 auto ns = AutoNodeStack(parser(),thisVariant());
1383
1384 Token tok = parser()->tokenizer.lex();
1385 while (!tok.is_any_of(TokenRetval::TK_NONE, TokenRetval::TK_EOF))
1386 {
1387 if (!parser()->defaultHandleToken(thisVariant(),tok,children()))
1388 {
1389 switch (tok.value())
1390 {
1391 case TokenRetval::TK_HTMLTAG:
1392 {
1393 HtmlTagType tagId=Mappers::htmlTagMapper->map(parser()->context.token->name);
1394 if (tagId==HtmlTagType::HTML_H1 && parser()->context.token->endTag) // found </h1> tag
1395 {
1396 if (m_level!=1)
1397 {
1398 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"<h{:d}> ended with </h1>",
1399 m_level);
1400 }
1401 goto endheader;
1402 }
1403 else if (tagId==HtmlTagType::HTML_H2 && parser()->context.token->endTag) // found </h2> tag
1404 {
1405 if (m_level!=2)
1406 {
1407 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"<h{:d}> ended with </h2>",
1408 m_level);
1409 }
1410 goto endheader;
1411 }
1412 else if (tagId==HtmlTagType::HTML_H3 && parser()->context.token->endTag) // found </h3> tag
1413 {
1414 if (m_level!=3)
1415 {
1416 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"<h{:d}> ended with </h3>",
1417 m_level);
1418 }
1419 goto endheader;
1420 }
1421 else if (tagId==HtmlTagType::HTML_H4 && parser()->context.token->endTag) // found </h4> tag
1422 {
1423 if (m_level!=4)
1424 {
1425 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"<h{:d}> ended with </h4>",
1426 m_level);
1427 }
1428 goto endheader;
1429 }
1430 else if (tagId==HtmlTagType::HTML_H5 && parser()->context.token->endTag) // found </h5> tag
1431 {
1432 if (m_level!=5)
1433 {
1434 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"<h{:d}> ended with </h5>",
1435 m_level);
1436 }
1437 goto endheader;
1438 }
1439 else if (tagId==HtmlTagType::HTML_H6 && parser()->context.token->endTag) // found </h6> tag
1440 {
1441 if (m_level!=6)
1442 {
1443 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"<h{:d}> ended with </h6>",
1444 m_level);
1445 }
1446 goto endheader;
1447 }
1448 else if (tagId==HtmlTagType::HTML_A)
1449 {
1450 if (!parser()->context.token->endTag)
1451 {
1452 parser()->handleAHref(thisVariant(),children(),parser()->context.token->attribs);
1453 }
1454 }
1455 else if (tagId==HtmlTagType::HTML_BR)
1456 {
1457 children().append<DocLineBreak>(parser(),thisVariant(),parser()->context.token->attribs);
1458 }
1459 else
1460 {
1461 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unexpected html tag <{}{}> found within <h{:d}> context",
1462 parser()->context.token->endTag?"/":"",parser()->context.token->name,m_level);
1463 }
1464 }
1465 break;
1466 default:
1467 char tmp[20];
1468 qsnprintf(tmp,20,"<h%d> tag",m_level);
1470 }
1471 }
1472 tok = parser()->tokenizer.lex();
1473 }
1474 if (tok.is_any_of(TokenRetval::TK_NONE,TokenRetval::TK_EOF))
1475 {
1476 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unexpected end of comment while inside"
1477 " <h{:d}> tag",m_level);
1478 }
1479endheader:
1481 return retval;
1482}
DocNodeList & children()
Definition docnode.h:143
DocNodeVariant * thisVariant()
Definition docnode.h:93
void handlePendingStyleCommands(DocNodeVariant *parent, DocNodeList &children, size_t numberOfElementsToClose=0)
DocTokenizer tokenizer
Token handleAHref(DocNodeVariant *parent, DocNodeList &children, const HtmlAttribList &tagHtmlAttribs)
DocParserContext context
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:173
#define AUTO_TRACE(...)
Definition docnode.cpp:48
#define warn_doc_error(file, line, fmt,...)
Definition message.h:112
const Mapper< HtmlTagType > * htmlTagMapper
#define qsnprintf
Definition qcstring.h:49
void append(Args &&... args)
Append a new DocNodeVariant to the list by constructing it with type T and parameters Args.
Definition docnode.h:1404
TokenInfo * token
Definition docparser_p.h:95
HtmlAttribList attribs

References DocNodeList::append(), TokenInfo::attribs, AUTO_TRACE, DocCompoundNode::children(), DocParser::context, DocParser::errorHandleDefaultToken(), DocParser::handleAHref(), DocParser::handlePendingStyleCommands(), HTML_A, HTML_BR, HTML_H1, HTML_H2, HTML_H3, HTML_H4, HTML_H5, HTML_H6, Mappers::htmlTagMapper, Token::is_any_of(), DocTokenizer::lex(), m_level, DocNode::parser(), qsnprintf, DocNode::thisVariant(), DocParserContext::token, DocParser::tokenizer, Token::value(), and warn_doc_error.

Member Data Documentation

◆ m_attribs

HtmlAttribList DocHtmlHeader::m_attribs
private

Definition at line 892 of file docnode.h.

Referenced by attribs(), and DocHtmlHeader().

◆ m_level

int DocHtmlHeader::m_level = 0
private

Definition at line 891 of file docnode.h.

Referenced by DocHtmlHeader(), level(), and parse().


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