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

Node representing a parameter list. More...

#include <src/docnode.h>

Inheritance diagram for DocParamList:
Collaboration diagram for DocParamList:

Public Member Functions

 DocParamList (DocParser *parser, DocNodeVariant *parent, DocParamSect::Type t, DocParamSect::Direction d)
const DocNodeListparameters () const
const DocNodeListparamTypes () const
const DocNodeListparagraphs () const
DocParamSect::Type type () const
DocParamSect::Direction direction () const
void markFirst (bool b=TRUE)
void markLast (bool b=TRUE)
bool isFirst () const
bool isLast () const
Token parse (const QCString &cmdName)
Token parseXml (const QCString &paramName)
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

DocNodeList m_paragraphs
DocNodeList m_params
DocNodeList m_paramTypes
DocParamSect::Type m_type = DocParamSect::Unknown
DocParamSect::Direction m_dir = DocParamSect::Unspecified
bool m_isFirst = false
bool m_isLast = false

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 parameter list.

Definition at line 1124 of file docnode.h.

Constructor & Destructor Documentation

◆ DocParamList()

DocParamList::DocParamList ( DocParser * parser,
DocNodeVariant * parent,
DocParamSect::Type t,
DocParamSect::Direction d )
inline

Definition at line 1127 of file docnode.h.

1128 : DocNode(parser,parent), m_type(t), m_dir(d) {}
DocNode(DocParser *parser, DocNodeVariant *parent)
Definition docnode.h:85
DocParser * parser()
Definition docnode.h:98
DocNodeVariant * parent()
Definition docnode.h:90
DocParamSect::Direction m_dir
Definition docnode.h:1146
DocParamSect::Type m_type
Definition docnode.h:1145

References DocNode::DocNode(), m_dir, m_type, DocNode::parent(), and DocNode::parser().

Member Function Documentation

◆ direction()

◆ isFirst()

bool DocParamList::isFirst ( ) const
inline

Definition at line 1136 of file docnode.h.

1136{ return m_isFirst; }
bool m_isFirst
Definition docnode.h:1147

References m_isFirst.

◆ isLast()

bool DocParamList::isLast ( ) const
inline

Definition at line 1137 of file docnode.h.

1137{ return m_isLast; }
bool m_isLast
Definition docnode.h:1148

References m_isLast.

Referenced by ManDocVisitor::operator()().

◆ markFirst()

void DocParamList::markFirst ( bool b = TRUE)
inline

Definition at line 1134 of file docnode.h.

1134{ m_isFirst=b; }

References m_isFirst, and TRUE.

Referenced by parseXml().

◆ markLast()

void DocParamList::markLast ( bool b = TRUE)
inline

Definition at line 1135 of file docnode.h.

1135{ m_isLast=b; }

References m_isLast, and TRUE.

Referenced by DocParamSect::parse(), and parseXml().

◆ paragraphs()

◆ parameters()

◆ paramTypes()

const DocNodeList & DocParamList::paramTypes ( ) const
inline

◆ parse()

Token DocParamList::parse ( const QCString & cmdName)

Definition at line 3200 of file docnode.cpp.

3201{
3202 AUTO_TRACE();
3203 Token retval = Token::make_RetVal_OK();
3204 auto ns = AutoNodeStack(parser(),thisVariant());
3205 DocPara *par=nullptr;
3206 QCString saveCmdName = cmdName;
3207
3208 Token tok=parser()->tokenizer.lex();
3209 if (!tok.is(TokenRetval::TK_WHITESPACE))
3210 {
3211 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"expected whitespace after \\{} command",
3212 saveCmdName);
3213 retval = Token::make_RetVal_EndParBlock();
3214 goto endparamlist;
3215 }
3217 tok=parser()->tokenizer.lex();
3218 while (tok.is(TokenRetval::TK_WORD)) /* there is a parameter name */
3219 {
3221 {
3222 int typeSeparator = parser()->context.token->name.find('#'); // explicit type position
3223 if (typeSeparator!=-1)
3224 {
3225 parser()->handleParameterType(thisVariant(),m_paramTypes,parser()->context.token->name.left(typeSeparator));
3226 parser()->context.token->name = parser()->context.token->name.mid(typeSeparator+1);
3229 if (parent() && std::holds_alternative<DocParamSect>(*parent()))
3230 {
3231 std::get<DocParamSect>(*parent()).m_hasTypeSpecifier=true;
3232 }
3233 }
3234 else
3235 {
3238 }
3239 }
3240 else if (m_type==DocParamSect::RetVal)
3241 {
3244 }
3245 //m_params.append(parser()->context.token->name);
3247 tok=parser()->tokenizer.lex();
3248 }
3250 if (tok.is_any_of(TokenRetval::TK_NONE,TokenRetval::TK_EOF)) // premature end of comment
3251 {
3252 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"unexpected end of comment block while parsing the "
3253 "argument of command {}",saveCmdName);
3254 retval = Token::make_RetVal_EndParBlock();
3255 goto endparamlist;
3256 }
3257 if (!tok.is(TokenRetval::TK_WHITESPACE)) /* premature end of comment block */
3258 {
3259 if (!tok.is(TokenRetval::TK_NEWPARA)) /* empty param description */
3260 {
3261 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"unexpected token {} in comment block while parsing the "
3262 "argument of command {}",tok.to_string(),saveCmdName);
3263 }
3264 retval = Token::make_RetVal_EndParBlock();
3265 goto endparamlist;
3266 }
3267
3268 m_paragraphs.append<DocPara>(parser(),thisVariant());
3269 par = m_paragraphs.get_last<DocPara>();
3270 retval = par->parse();
3271 par->markFirst();
3272 par->markLast();
3273
3274endparamlist:
3275 AUTO_TRACE_EXIT("retval={}",retval.to_string());
3276 return retval;
3277}
DocNodeVariant * thisVariant()
Definition docnode.h:93
void markLast(bool v=TRUE)
Definition docnode.h:1086
void markFirst(bool v=TRUE)
Definition docnode.h:1085
Token parse()
Definition docnode.cpp:5702
void handleLinkedWord(DocNodeVariant *parent, DocNodeList &children, bool ignoreAutoLinkFlag=FALSE)
DocTokenizer tokenizer
void handleParameterType(DocNodeVariant *parent, DocNodeList &children, const QCString &paramTypes)
void checkRetvalName()
void checkArgumentName()
DocParserContext context
void setStateParam()
void setStatePara()
int find(char c, int index=0, bool cs=TRUE) const
Definition qcstring.cpp:43
QCString mid(size_t index, size_t len=static_cast< size_t >(-1)) const
Definition qcstring.h:226
bool is(TokenRetval rv) const
TOKEN_SPECIFICATIONS RETVAL_SPECIFICATIONS const char * to_string() const
bool is_any_of(ARGS... args) const
#define AUTO_TRACE(...)
Definition docnode.cpp:46
#define AUTO_TRACE_EXIT(...)
Definition docnode.cpp:48
#define warn_doc_error(file, line, fmt,...)
Definition message.h:112
#define TRUE
Definition qcstring.h:37
TokenInfo * token
Definition docparser_p.h:93
QCString name

References AUTO_TRACE, AUTO_TRACE_EXIT, DocParser::checkArgumentName(), DocParser::checkRetvalName(), DocParser::context, QCString::find(), DocParser::handleLinkedWord(), DocParser::handleParameterType(), DocParserContext::hasParamCommand, DocParserContext::hasReturnCommand, Token::is(), Token::is_any_of(), DocTokenizer::lex(), m_paragraphs, m_params, m_paramTypes, m_type, DocPara::markFirst(), DocPara::markLast(), QCString::mid(), TokenInfo::name, DocParamSect::Param, DocNode::parent(), DocPara::parse(), DocNode::parser(), DocParamSect::RetVal, DocTokenizer::setStatePara(), DocTokenizer::setStateParam(), DocNode::thisVariant(), Token::to_string(), DocParserContext::token, DocParser::tokenizer, TRUE, and warn_doc_error.

◆ parseXml()

Token DocParamList::parseXml ( const QCString & paramName)

Definition at line 3279 of file docnode.cpp.

3280{
3281 AUTO_TRACE();
3282 Token retval = Token::make_RetVal_OK();
3283 auto ns = AutoNodeStack(parser(),thisVariant());
3284
3285 parser()->context.token->name = paramName;
3287 {
3290 }
3291 else if (m_type==DocParamSect::RetVal)
3292 {
3295 }
3296
3298
3299 do
3300 {
3301 m_paragraphs.append<DocPara>(parser(),thisVariant());
3302 DocPara *par = m_paragraphs.get_last<DocPara>();
3303 retval = par->parse();
3304 if (par->isEmpty()) // avoid adding an empty paragraph for the whitespace
3305 // after </para> and before </param>
3306 {
3307 m_paragraphs.pop_back();
3308 break;
3309 }
3310 else // append the paragraph to the list
3311 {
3312 if (!m_paragraphs.empty())
3313 {
3314 m_paragraphs.get_last<DocPara>()->markLast(FALSE);
3315 }
3316 bool markFirst = m_paragraphs.empty();
3317 par = &std::get<DocPara>(m_paragraphs.back());
3318 if (markFirst)
3319 {
3320 par->markFirst();
3321 }
3322 par->markLast();
3323 }
3324
3325 if (retval.is_any_of(TokenRetval::TK_NONE,TokenRetval::TK_EOF)) break;
3326
3327 } while (retval.is(TokenRetval::RetVal_CloseXml) &&
3328 Mappers::htmlTagMapper->map(parser()->context.token->name)!=HtmlTagType::XML_PARAM &&
3329 Mappers::htmlTagMapper->map(parser()->context.token->name)!=HtmlTagType::XML_TYPEPARAM &&
3330 Mappers::htmlTagMapper->map(parser()->context.token->name)!=HtmlTagType::XML_EXCEPTION);
3331
3332 if (retval.is_any_of(TokenRetval::TK_NONE,TokenRetval::TK_EOF)) /* premature end of comment block */
3333 {
3334 warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"unterminated param or exception tag");
3335 }
3336 else
3337 {
3338 retval = Token::make_RetVal_OK();
3339 }
3340
3341 AUTO_TRACE_EXIT("retval={}",retval.to_string());
3342 return retval;
3343}
void markFirst(bool b=TRUE)
Definition docnode.h:1134
void markLast(bool b=TRUE)
Definition docnode.h:1135
const Mapper< HtmlTagType > * htmlTagMapper
#define FALSE
Definition qcstring.h:34

References AUTO_TRACE, AUTO_TRACE_EXIT, DocParser::checkArgumentName(), DocParser::checkRetvalName(), DocParser::context, FALSE, DocParser::handleLinkedWord(), DocParserContext::hasParamCommand, DocParserContext::hasReturnCommand, Mappers::htmlTagMapper, Token::is(), Token::is_any_of(), m_paragraphs, m_params, m_type, markFirst(), markLast(), TokenInfo::name, DocParamSect::Param, DocNode::parser(), DocParamSect::RetVal, DocNode::thisVariant(), Token::to_string(), DocParserContext::token, TRUE, warn_doc_error, XML_EXCEPTION, XML_PARAM, and XML_TYPEPARAM.

◆ type()

DocParamSect::Type DocParamList::type ( ) const
inline

Definition at line 1132 of file docnode.h.

1132{ return m_type; }

References m_type.

Member Data Documentation

◆ m_dir

DocParamSect::Direction DocParamList::m_dir = DocParamSect::Unspecified
private

Definition at line 1146 of file docnode.h.

Referenced by direction(), and DocParamList().

◆ m_isFirst

bool DocParamList::m_isFirst = false
private

Definition at line 1147 of file docnode.h.

Referenced by isFirst(), and markFirst().

◆ m_isLast

bool DocParamList::m_isLast = false
private

Definition at line 1148 of file docnode.h.

Referenced by isLast(), and markLast().

◆ m_paragraphs

DocNodeList DocParamList::m_paragraphs
private

Definition at line 1142 of file docnode.h.

Referenced by paragraphs(), parse(), and parseXml().

◆ m_params

DocNodeList DocParamList::m_params
private

Definition at line 1143 of file docnode.h.

Referenced by parameters(), parse(), and parseXml().

◆ m_paramTypes

DocNodeList DocParamList::m_paramTypes
private

Definition at line 1144 of file docnode.h.

Referenced by paramTypes(), and parse().

◆ m_type

DocParamSect::Type DocParamList::m_type = DocParamSect::Unknown
private

Definition at line 1145 of file docnode.h.

Referenced by DocParamList(), parse(), parseXml(), and type().


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