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().

Referenced by validatingParseText().

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 6163 of file docnode.cpp.

6164{
6165 AUTO_TRACE();
6166 auto ns = AutoNodeStack(parser(),thisVariant());
6167 parser()->tokenizer.setStateText();
6168
6169 Token tok = parser()->tokenizer.lex();
6170 while (!tok.is_any_of(TokenRetval::TK_NONE, TokenRetval::TK_EOF)) // get the next token
6171 {
6172 switch(tok.value())
6173 {
6174 case TokenRetval::TK_WORD:
6175 children().append<DocWord>(parser(),thisVariant(),parser()->context.token->name);
6176 break;
6177 case TokenRetval::TK_WHITESPACE:
6178 children().append<DocWhiteSpace>(parser(),thisVariant(),parser()->context.token->chars);
6179 break;
6180 case TokenRetval::TK_SYMBOL:
6181 {
6182 HtmlEntityMapper::SymType s = DocSymbol::decodeSymbol(parser()->context.token->name);
6183 if (s!=HtmlEntityMapper::Sym_Unknown)
6184 {
6185 children().append<DocSymbol>(parser(),thisVariant(),s);
6186 }
6187 else
6188 {
6189 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unsupported symbol '{}' found",
6190 parser()->context.token->name);
6191 }
6192 }
6193 break;
6194 case TokenRetval::TK_COMMAND_AT:
6195 // fall through
6196 case TokenRetval::TK_COMMAND_BS:
6197 switch (Mappers::cmdMapper->map(parser()->context.token->name))
6198 {
6199 case CommandType::CMD_BSLASH:
6200 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_BSlash);
6201 break;
6202 case CommandType::CMD_AT:
6203 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_At);
6204 break;
6205 case CommandType::CMD_LESS:
6206 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Less);
6207 break;
6208 case CommandType::CMD_GREATER:
6209 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Greater);
6210 break;
6211 case CommandType::CMD_AMP:
6212 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Amp);
6213 break;
6214 case CommandType::CMD_DOLLAR:
6215 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Dollar);
6216 break;
6217 case CommandType::CMD_HASH:
6218 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Hash);
6219 break;
6220 case CommandType::CMD_DCOLON:
6221 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_DoubleColon);
6222 break;
6223 case CommandType::CMD_PERCENT:
6224 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Percent);
6225 break;
6226 case CommandType::CMD_NDASH:
6227 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6228 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6229 break;
6230 case CommandType::CMD_MDASH:
6231 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6232 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6233 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6234 break;
6235 case CommandType::CMD_QUOTE:
6236 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Quot);
6237 break;
6238 case CommandType::CMD_PUNT:
6239 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Dot);
6240 break;
6241 case CommandType::CMD_EXCLAMATION:
6242 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Exclam);
6243 break;
6244 case CommandType::CMD_QUESTION:
6245 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Quest);
6246 break;
6247 case CommandType::CMD_PLUS:
6248 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Plus);
6249 break;
6250 case CommandType::CMD_MINUS:
6251 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Minus);
6252 break;
6253 case CommandType::CMD_EQUAL:
6254 children().append<DocSymbol>(parser(),thisVariant(),HtmlEntityMapper::Sym_Equal);
6255 break;
6256 default:
6257 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unexpected command '{}' found",
6258 parser()->context.token->name);
6259 break;
6260 }
6261 break;
6262 default:
6263 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"Unexpected token {}",
6264 tok.to_string());
6265 break;
6266 }
6267 tok = parser()->tokenizer.lex();
6268 }
6269
6270 parser()->handleUnclosedStyleCommands();
6271
6272}
AutoNodeStack::AutoNodeStack
AutoNodeStack(DocParser *parser, DocNodeVariant *node)
Definition docparser_p.h:165
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:826
DocSymbol::decodeSymbol
static HtmlEntityMapper::SymType decodeSymbol(const DString &symName)
Definition docnode.cpp:158
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:51
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, AutoNodeStack::AutoNodeStack(), 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: