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 DocNodeList &	parameters () const
const DocNodeList &	paramTypes () const
const DocNodeList &	paragraphs () 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 DString &cmdName)
Token	parseXml (const DString &paramName)
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

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 ,   Requirement }
Protected Member Functions inherited from DocNode
void	setInsidePreformatted (bool p)

Detailed Description

Node representing a parameter list.

Definition at line 1129 of file docnode.h.

Constructor & Destructor Documentation

DocParamList()

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

inline

Definition at line 1132 of file docnode.h.

      : DocNode(parser,parent), m_type(t), m_dir(d) {}

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

Member Function Documentation

direction()

DocParamSect::Direction DocParamList::direction ( ) const

inline

Definition at line 1138 of file docnode.h.

{ return m_dir; }

References m_dir.

Referenced by DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), PerlModDocVisitor::operator()(), RTFDocVisitor::operator()(), and XmlDocVisitor::operator()().

isFirst()

bool DocParamList::isFirst ( ) const

inline

Definition at line 1141 of file docnode.h.

{ return m_isFirst; }

References m_isFirst.

isLast()

bool DocParamList::isLast ( ) const

inline

Definition at line 1142 of file docnode.h.

{ return m_isLast; }

References m_isLast.

Referenced by ManDocVisitor::operator()().

markFirst()

void DocParamList::markFirst ( bool b = true )

inline

Definition at line 1139 of file docnode.h.

{ m_isFirst=b; }

References m_isFirst.

Referenced by parseXml().

markLast()

void DocParamList::markLast ( bool b = true )

inline

Definition at line 1140 of file docnode.h.

{ m_isLast=b; }

References m_isLast.

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

paragraphs()

const DocNodeList & DocParamList::paragraphs ( ) const

inline

Definition at line 1136 of file docnode.h.

{ return m_paragraphs; }

References m_paragraphs.

Referenced by DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), ManDocVisitor::operator()(), PerlModDocVisitor::operator()(), RTFDocVisitor::operator()(), and XmlDocVisitor::operator()().

parameters()

const DocNodeList & DocParamList::parameters ( ) const

inline

Definition at line 1134 of file docnode.h.

{ return m_params; }

References m_params.

Referenced by DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), ManDocVisitor::operator()(), PerlModDocVisitor::operator()(), PrintDocVisitor::operator()(), RTFDocVisitor::operator()(), and XmlDocVisitor::operator()().

paramTypes()

const DocNodeList & DocParamList::paramTypes ( ) const

inline

Definition at line 1135 of file docnode.h.

{ return m_paramTypes; }

References m_paramTypes.

Referenced by DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), RTFDocVisitor::operator()(), and XmlDocVisitor::operator()().

parse()

Token DocParamList::parse

(

const DString &

cmdName

)

Definition at line 3373 of file docnode.cpp.

{
  AUTO_TRACE();
  Token retval = Token::make_RetVal_OK();
  auto ns = AutoNodeStack(parser(),thisVariant());
  DocPara *par=nullptr;
  DString saveCmdName = cmdName;
  DocParserContext &context = parser()->context;
  DocTokenizer &tokenizer = parser()->tokenizer;
 
  Token tok=tokenizer.lex();
  if (!tok.is(TokenRetval::TK_WHITESPACE))
  {
    warn_doc_error(context.fileName,tokenizer.getLineNr(),"expected whitespace after \\{} command",
        saveCmdName);
    retval = Token::make_RetVal_EndParBlock();
    goto endparamlist;
  }
  tokenizer.setStateParam();
  tok=tokenizer.lex();
  while (tok.is(TokenRetval::TK_WORD)) /* there is a parameter name */
  {
    if (m_type==DocParamSect::Param)
    {
      size_t typeSeparator = context.token->name.find('#'); // explicit type position
      if (typeSeparator!=DString::npos)
      {
        parser()->handleParameterType(thisVariant(),m_paramTypes,context.token->name.left(typeSeparator));
        context.token->name = context.token->name.mid(typeSeparator+1);
        context.hasParamCommand=true;
        if (parent() && std::holds_alternative<DocParamSect>(*parent()))
        {
          std::get<DocParamSect>(*parent()).m_hasTypeSpecifier=true;
        }
      }
      else
      {
        context.hasParamCommand=true;
      }
      parser()->checkArgumentName();
    }
    else if (m_type==DocParamSect::RetVal)
    {
      context.hasReturnCommand=true;
      parser()->checkRetvalName();
    }
    context.inSeeBlock=true;
    parser()->handleLinkedWord(thisVariant(),m_params,m_type==DocParamSect::Param,true);
    context.inSeeBlock=false;
    tok=tokenizer.lex();
  }
  tokenizer.setStatePara();
  if (tok.is_any_of(TokenRetval::TK_NONE,TokenRetval::TK_EOF)) // premature end of comment
  {
    warn_doc_error(context.fileName,tokenizer.getLineNr(),"unexpected end of comment block while parsing the "
        "argument of command {}",saveCmdName);
    retval = Token::make_RetVal_EndParBlock();
    goto endparamlist;
  }
  if (!tok.is(TokenRetval::TK_WHITESPACE)) /* premature end of comment block */
  {
    if (!tok.is(TokenRetval::TK_NEWPARA)) /* empty param description */
    {
      warn_doc_error(context.fileName,tokenizer.getLineNr(),"unexpected token {} in comment block while parsing the "
          "argument of command {}",tok.to_string(),saveCmdName);
    }
    retval = Token::make_RetVal_EndParBlock();
    goto endparamlist;
  }
 
  m_paragraphs.append<DocPara>(parser(),thisVariant());
  par = m_paragraphs.get_last<DocPara>();
  retval = par->parse();
  par->markFirst();
  par->markLast();
 
endparamlist:
  AUTO_TRACE_EXIT("retval={}",retval.to_string());
  return retval;
}

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

parseXml()

Token DocParamList::parseXml

(

const DString &

paramName

)

Definition at line 3454 of file docnode.cpp.

{
  AUTO_TRACE();
  Token retval = Token::make_RetVal_OK();
  auto ns = AutoNodeStack(parser(),thisVariant());
 
  parser()->context.token->name = paramName;
  if (m_type==DocParamSect::Param)
  {
    parser()->context.hasParamCommand=true;
    parser()->checkArgumentName();
  }
  else if (m_type==DocParamSect::RetVal)
  {
    parser()->context.hasReturnCommand=true;
    parser()->checkRetvalName();
  }
 
  parser()->handleLinkedWord(thisVariant(),m_params);
 
  do
  {
    m_paragraphs.append<DocPara>(parser(),thisVariant());
    DocPara *par =  m_paragraphs.get_last<DocPara>();
    retval = par->parse();
    if (par->empty()) // avoid adding an empty paragraph for the whitespace
                        // after </para> and before </param>
    {
      m_paragraphs.pop_back();
      break;
    }
    else // append the paragraph to the list
    {
      if (!m_paragraphs.empty())
      {
        m_paragraphs.get_last<DocPara>()->markLast(false);
      }
      bool markFirst = m_paragraphs.empty();
      par = &std::get<DocPara>(m_paragraphs.back());
      if (markFirst)
      {
        par->markFirst();
      }
      par->markLast();
    }
 
    if (retval.is_any_of(TokenRetval::TK_NONE,TokenRetval::TK_EOF)) break;
 
  } while (retval.is(TokenRetval::RetVal_CloseXml) &&
           Mappers::htmlTagMapper->map(parser()->context.token->name)!=HtmlTagType::XML_PARAM &&
           Mappers::htmlTagMapper->map(parser()->context.token->name)!=HtmlTagType::XML_TYPEPARAM &&
           Mappers::htmlTagMapper->map(parser()->context.token->name)!=HtmlTagType::XML_EXCEPTION);
 
  if (retval.is_any_of(TokenRetval::TK_NONE,TokenRetval::TK_EOF)) /* premature end of comment block */
  {
    warn_doc_error(parser()->context.fileName,parser()->tokenizer.getLineNr(),"unterminated param or exception tag");
  }
  else
  {
    retval = Token::make_RetVal_OK();
  }
 
  AUTO_TRACE_EXIT("retval={}",retval.to_string());
  return retval;
}

References DocNodeList::append(), AUTO_TRACE, AUTO_TRACE_EXIT, GrowVector< T >::back(), DocParser::checkArgumentName(), DocParser::checkRetvalName(), DocParser::context, GrowVector< T >::empty(), DocNodeList::get_last(), 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(), GrowVector< T >::pop_back(), DocParamSect::RetVal, DocNode::thisVariant(), Token::to_string(), DocParserContext::token, warn_doc_error, XML_EXCEPTION, XML_PARAM, and XML_TYPEPARAM.

type()

DocParamSect::Type DocParamList::type ( ) const

inline

Definition at line 1137 of file docnode.h.

{ return m_type; }

References m_type.

Member Data Documentation

m_dir

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

private

Definition at line 1151 of file docnode.h.

Referenced by direction(), and DocParamList().

m_isFirst

bool DocParamList::m_isFirst = false

private

Definition at line 1152 of file docnode.h.

Referenced by isFirst(), and markFirst().

m_isLast

bool DocParamList::m_isLast = false

private

Definition at line 1153 of file docnode.h.

Referenced by isLast(), and markLast().

m_paragraphs

DocNodeList DocParamList::m_paragraphs

private

Definition at line 1147 of file docnode.h.

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

m_params

DocNodeList DocParamList::m_params

private

Definition at line 1148 of file docnode.h.

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

m_paramTypes

DocNodeList DocParamList::m_paramTypes

private

Definition at line 1149 of file docnode.h.

Referenced by paramTypes(), and parse().

m_type

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

private

Definition at line 1150 of file docnode.h.

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

---

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

• src/docnode.h
• src/docnode.cpp