Doxygen
Loading...
Searching...
No Matches
DocText Class Referencefinal

Root node of a text fragment. More...

#include <src/docnode.h>

Inheritance diagram for DocText:
Collaboration diagram for DocText:

Public Member Functions

 DocText (DocParser *parser)
void parse ()
bool empty () const
Public Member Functions inherited from DocCompoundNode
 DocCompoundNode (DocParser *parser, DocNodeVariant *parent)
DocNodeList & children ()
const DocNodeList & children () const
Public Member Functions inherited from DocNode
 DocNode (DocParser *parser, DocNodeVariant *parent)
 ~DocNode ()=default
DocNodeVariant * parent ()
const DocNodeVariant * parent () const
DocNodeVariant * thisVariant ()
const DocNodeVariant * thisVariant () const
void setThisVariant (DocNodeVariant *thisVariant)
DocParser * parser ()
const DocParser * parser () const
void setParent (DocNodeVariant *parent)
bool isPreformatted () const

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

Root node of a text fragment.

Definition at line 1308 of file docnode.h.

Constructor & Destructor Documentation

◆ DocText()

DocText::DocText ( DocParser * parser)
inline

Definition at line 1311 of file docnode.h.

1311: DocCompoundNode(parser,nullptr) {}
DocCompoundNode::DocCompoundNode
DocCompoundNode(DocParser *parser, DocNodeVariant *parent)
Definition docnode.h:141
DocNode::parser
DocParser * parser()
Definition docnode.h:97

References DocCompoundNode::DocCompoundNode(), and DocNode::parser().

Member Function Documentation

◆ empty()

bool DocText::empty ( ) const
inline

Definition at line 1313 of file docnode.h.

1313{ return children().empty(); }
DocCompoundNode::children
DocNodeList & children()
Definition docnode.h:143
GrowVector::empty
bool empty() const
checks whether the container is empty
Definition growvector.h:140

References DocCompoundNode::children(), and GrowVector< T >::empty().

◆ parse()

void DocText::parse ( )

Definition at line 6244 of file docnode.cpp.

6245{
6246 AUTO_TRACE();
6247 auto ns = AutoNodeStack(parser(),thisVariant());
6248 parser()->tokenizer.setStateText();
6249
6250 Token tok = parser()->tokenizer.lex();
6251 while (!tok.is_any_of(TokenRetval::TK_NONE, TokenRetval::TK_EOF)) // get the next token
6252 {
6253 switch(tok.value())
6254 {
6255 case TokenRetval::TK_WORD:
6256 children().append<DocWord>(parser(),thisVariant(),parser()->context.token->name);
6257 break;
6258 case TokenRetval::TK_WHITESPACE:
6259 children().append<DocWhiteSpace>(parser(),thisVariant(),parser()->context.token->chars);
6260 break;
6261 case TokenRetval::TK_SYMBOL:
6262 {
6263 HtmlEntityMapper::SymType s = DocSymbol::decodeSymbol(parser()->context.token->name);
6264 if (s!=HtmlEntityMapper::Sym_Unknown)
6265 {
6266 children().append<DocSymbol>(parser(),thisVariant(),s);
6267 }
6268 else
6269 {
6270 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unsupported symbol '{}' found",
6271 parser()->context.token->name);
6272 }
6273 }
6274 break;
6275 case TokenRetval::TK_COMMAND_AT:
6276 // fall through
6277 case TokenRetval::TK_COMMAND_BS:
6278 switch (Mappers::cmdMapper->map(parser()->context.token->name))
6279 {
6280 case CommandType::CMD_BSLASH:
6281 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_BSlash);
6282 break;
6283 case CommandType::CMD_AT:
6284 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_At);
6285 break;
6286 case CommandType::CMD_LESS:
6287 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Less);
6288 break;
6289 case CommandType::CMD_GREATER:
6290 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Greater);
6291 break;
6292 case CommandType::CMD_AMP:
6293 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Amp);
6294 break;
6295 case CommandType::CMD_DOLLAR:
6296 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Dollar);
6297 break;
6298 case CommandType::CMD_HASH:
6299 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Hash);
6300 break;
6301 case CommandType::CMD_DCOLON:
6302 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_DoubleColon);
6303 break;
6304 case CommandType::CMD_PERCENT:
6305 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Percent);
6306 break;
6307 case CommandType::CMD_NDASH:
6308 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6309 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6310 break;
6311 case CommandType::CMD_MDASH:
6312 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6313 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6314 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6315 break;
6316 case CommandType::CMD_QUOTE:
6317 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Quot);
6318 break;
6319 case CommandType::CMD_PUNT:
6320 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Dot);
6321 break;
6322 case CommandType::CMD_EXCLAMATION:
6323 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Exclam);
6324 break;
6325 case CommandType::CMD_QUESTION:
6326 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Quest);
6327 break;
6328 case CommandType::CMD_PLUS:
6329 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Plus);
6330 break;
6331 case CommandType::CMD_MINUS:
6332 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6333 break;
6334 case CommandType::CMD_EQUAL:
6335 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Equal);
6336 break;
6337 default:
6338 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unexpected command '{}' found",
6339 parser()->context.token->name);
6340 break;
6341 }
6342 break;
6343 default:
6344 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unexpected token {}",
6345 tok.to_string());
6346 break;
6347 }
6348 tok = parser()->tokenizer.lex();
6349 }
6350
6351 parser()->handleUnclosedStyleCommands();
6352
6353}
DocNode::thisVariant
DocNodeVariant * thisVariant()
Definition docnode.h:92
DocNodeList::append
void append(Args &&... args)
Append a new DocNodeVariant to the list by constructing it with type T and parameters Args.
Definition docnode.h:1404
DocParser::tokenizer
DocTokenizer tokenizer
Definition docparser_p.h:153
DocParser::context
DocParserContext context
Definition docparser_p.h:152
DocParser::handleUnclosedStyleCommands
void handleUnclosedStyleCommands()
Definition docparser.cpp:833
DocSymbol::decodeSymbol
static HtmlEntityMapper::SymType decodeSymbol(const DString &symName)
Definition docnode.cpp:160
DocTokenizer::setStateText
void setStateText()
Definition doctokenizer.l:2141
Token::to_string
TOKEN_SPECIFICATIONS RETVAL_SPECIFICATIONS const char * to_string() const
Definition doctokenizer.h:90
Token::value
TokenRetval value() const
Definition doctokenizer.h:84
Token::is_any_of
bool is_any_of(ARGS... args) const
Definition doctokenizer.h:114
TokenInfo::chars
DString chars
Definition doctokenizer.h:168
TokenInfo::name
DString name
Definition doctokenizer.h:136
AUTO_TRACE
#define AUTO_TRACE(...)
Definition docnode.cpp:53
warn_doc_error
#define warn_doc_error(file, line, fmt,...)
Definition message.h:112
Mappers::cmdMapper
const Mapper< CommandType > * cmdMapper
Definition cmdmapper.cpp:254
DocParserContext::token
TokenInfo * token
Definition docparser_p.h:94

References DocNodeList::append(), AUTO_TRACE, TokenInfo::chars, DocCompoundNode::children(), CMD_AMP, CMD_AT, CMD_BSLASH, CMD_DCOLON, CMD_DOLLAR, CMD_EQUAL, CMD_EXCLAMATION, CMD_GREATER, CMD_HASH, CMD_LESS, CMD_MDASH, CMD_MINUS, CMD_NDASH, CMD_PERCENT, CMD_PLUS, CMD_PUNT, CMD_QUESTION, CMD_QUOTE, Mappers::cmdMapper, DocParser::context, DocSymbol::decodeSymbol(), DocParser::handleUnclosedStyleCommands(), Token::is_any_of(), DocTokenizer::lex(), TokenInfo::name, DocNode::parser(), DocTokenizer::setStateText(), HtmlEntityMapper::Sym_Amp, HtmlEntityMapper::Sym_At, HtmlEntityMapper::Sym_BSlash, HtmlEntityMapper::Sym_Dollar, HtmlEntityMapper::Sym_Dot, HtmlEntityMapper::Sym_DoubleColon, HtmlEntityMapper::Sym_Equal, HtmlEntityMapper::Sym_Exclam, HtmlEntityMapper::Sym_Greater, HtmlEntityMapper::Sym_Hash, HtmlEntityMapper::Sym_Less, HtmlEntityMapper::Sym_Minus, HtmlEntityMapper::Sym_Percent, HtmlEntityMapper::Sym_Plus, HtmlEntityMapper::Sym_Quest, HtmlEntityMapper::Sym_Quot, HtmlEntityMapper::Sym_Unknown, DocNode::thisVariant(), Token::to_string(), DocParserContext::token, DocParser::tokenizer, Token::value(), and warn_doc_error.

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