Class representing a 'range' tag in a template 更多...

类 TemplateNodeRange 继承关系图:

TemplateNodeRange 的协作图:

Public 成员函数
	TemplateNodeRange (TemplateParser parser, TemplateNode parent, int line, const QCString &data)

void	render (TextStream &ts, TemplateContext *c)

Public 成员函数继承自 TemplateNodeCreator< TemplateNodeRange >
	TemplateNodeCreator (TemplateParser parser, TemplateNode parent, int line)

TemplateImpl *	getTemplate ()

Public 成员函数继承自 TemplateNode
	TemplateNode (TemplateNode *parent)

virtual	~TemplateNode ()

TemplateNode *	parent ()

Private 属性
bool	m_down = false

ExprAstPtr	m_startExpr

ExprAstPtr	m_endExpr

QCString	m_var

TemplateNodeList	m_loopNodes

额外继承的成员函数
静态 Public 成员函数继承自 TemplateNodeCreator< TemplateNodeRange >
static TemplateNodePtr	createInstance (TemplateParser parser, TemplateNode parent, int line, const QCString &data)

Protected 成员函数继承自 TemplateNodeCreator< TemplateNodeRange >
void	mkpath (const TemplateContextImpl *ci, const std::string &fileName)

Protected 属性继承自 TemplateNodeCreator< TemplateNodeRange >
QCString	m_templateName

int	m_line

详细描述

Class representing a 'range' tag in a template

在文件 template.cpp 第 3246 行定义.

构造及析构函数说明

◆ TemplateNodeRange()

TemplateNodeRange::TemplateNodeRange	(	TemplateParser *	parser,
		TemplateNode *	parent,
		int	line,
		const QCString &	data
	)

inline

在文件 template.cpp 第 3249 行定义.

       : TemplateNodeCreator<TemplateNodeRange>(parser,parent,line), m_down(FALSE)
     {
       TRACE(("{TemplateNodeRange(%s)\n",qPrint(data)));
       QCString start,end;
       int i1 = data.find(" from ");
       int i2 = data.find(" to ");
       int i3 = data.find(" downto ");
       if (i1==-1)
       {
         if (data.endsWith(" from"))
         {
           parser->warn(m_templateName,line,"range missing after 'from' keyword");
         }
         else if (data=="from")
         {
           parser->warn(m_templateName,line,"range needs an iterator variable and a range");
         }
         else
         {
           parser->warn(m_templateName,line,"range is missing 'from' keyword");
         }
       }
       else if (i2==-1 && i3==-1)
       {
         if (data.endsWith(" to"))
         {
           parser->warn(m_templateName,line,"range is missing end value after 'to' keyword");
         }
         else if (data.endsWith(" downto"))
         {
           parser->warn(m_templateName,line,"range is missing end value after 'downto' keyword");
         }
         else
         {
           parser->warn(m_templateName,line,"range is missing 'to' or 'downto' keyword");
         }
       }
       else
       {
         m_var = data.left(i1).stripWhiteSpace();
         if (m_var.isEmpty())
         {
           parser->warn(m_templateName,line,"range needs an iterator variable");
         }
         start = data.mid(i1+6,i2-i1-6).stripWhiteSpace();
         if (i2!=-1)
         {
           end = data.right(data.length()-i2-4).stripWhiteSpace();
           m_down = FALSE;
         }
         else if (i3!=-1)
         {
           end = data.right(data.length()-i3-8).stripWhiteSpace();
           m_down = TRUE;
         }
       }
       ExpressionParser expParser(parser,line);
       m_startExpr = expParser.parse(start);
       m_endExpr   = expParser.parse(end);
  
       StringVector stopAt = { "endrange" };
       parser->parse(this,line,stopAt,m_loopNodes);
       parser->removeNextToken(); // skip over endrange
       TRACE(("}TemplateNodeRange(%s)\n",qPrint(data)));
     }

引用了 end(), QCString::endsWith(), FALSE, QCString::find(), QCString::isEmpty(), QCString::left(), QCString::length(), m_down, m_endExpr, m_loopNodes, m_startExpr, TemplateNodeCreator< TemplateNodeRange >::m_templateName, m_var, QCString::mid(), TemplateParser::parse(), ExpressionParser::parse(), qPrint(), TemplateParser::removeNextToken(), QCString::right(), QCString::stripWhiteSpace(), TRACE, TRUE , 以及 TemplateParser::warn().

成员函数说明

◆ render()

void TemplateNodeRange::render	(	TextStream &	ts,
		TemplateContext *	c
	)

inlinevirtual

实现了 TemplateNode.

在文件 template.cpp 第 3316 行定义.

     {
       TemplateContextImpl* ci = dynamic_cast<TemplateContextImpl*>(c);
       if (ci==0) return; // should not happen
       ci->setLocation(m_templateName,m_line);
       //printf("TemplateNodeRange::render #loopNodes=%d\n",
       //    m_loopNodes.count());
       if (m_startExpr && m_endExpr)
       {
         TemplateVariant vs = m_startExpr->resolve(c);
         TemplateVariant ve = m_endExpr->resolve(c);
         if (vs.isInt() && ve.isInt())
         {
           int s = vs.toInt();
           int e = ve.toInt();
           int l = m_down ? s-e+1 : e-s+1;
           if (l>0)
           {
             c->push();
             //int index = m_reversed ? list.count() : 0;
             const TemplateVariant *parentLoop = c->getRef("forloop");
             uint index = 0;
             int i = m_down ? e : s;
             bool done=false;
             while (!done)
             {
               // set the forloop meta-data variable
               TemplateStructPtr ls = TemplateStruct::alloc();
               ls->set("counter0",    (int)index);
               ls->set("counter",     (int)(index+1));
               ls->set("revcounter",  (int)(l-index));
               ls->set("revcounter0", (int)(l-index-1));
               ls->set("first",index==0);
               ls->set("last", (int)index==l-1);
               ls->set("parentloop",parentLoop ? *parentLoop : TemplateVariant());
               c->set("forloop",std::static_pointer_cast<TemplateStructIntf>(ls));
  
               // set the iterator variable
               c->set(m_var,i);
  
               // render all items for this iteration of the loop
               m_loopNodes.render(ts,c);
  
               index++;
               if (m_down)
               {
                 i--;
                 done = i<e;
               }
               else
               {
                 i++;
                 done = i>e;
               }
             }
             c->pop();
           }
           else
           {
             ci->warn(m_templateName,m_line,"range %d %s %d is empty!",
                 s,m_down?"downto":"to",e);
           }
         }
         else if (!vs.isInt())
         {
           ci->warn(m_templateName,m_line,"range requires a start value of integer type!");
         }
         else if (!ve.isInt())
         {
           ci->warn(m_templateName,m_line,"range requires an end value of integer type!");
         }
       }
       else if (!m_startExpr)
       {
         ci->warn(m_templateName,m_line,"range has empty start value");
       }
       else if (!m_endExpr)
       {
         ci->warn(m_templateName,m_line,"range has empty end value");
       }
     }

引用了 TemplateStruct::alloc(), TemplateContext::getRef(), TemplateVariant::isInt(), m_down, m_endExpr, TemplateNodeCreator< TemplateNodeRange >::m_line, m_loopNodes, m_startExpr, TemplateNodeCreator< TemplateNodeRange >::m_templateName, m_var, TemplateContext::pop(), TemplateContext::push(), TemplateNodeList::render(), TemplateContext::set(), TemplateContextImpl::setLocation(), TemplateVariant::toInt() , 以及 TemplateContextImpl::warn().

类成员变量说明

◆ m_down

bool TemplateNodeRange::m_down = false

private

在文件 template.cpp 第 3399 行定义.

被这些函数引用 render() , 以及 TemplateNodeRange().

◆ m_endExpr

ExprAstPtr TemplateNodeRange::m_endExpr

private

在文件 template.cpp 第 3401 行定义.

被这些函数引用 render() , 以及 TemplateNodeRange().

◆ m_loopNodes

TemplateNodeList TemplateNodeRange::m_loopNodes

private

在文件 template.cpp 第 3403 行定义.

被这些函数引用 render() , 以及 TemplateNodeRange().

◆ m_startExpr

ExprAstPtr TemplateNodeRange::m_startExpr

private

在文件 template.cpp 第 3400 行定义.

被这些函数引用 render() , 以及 TemplateNodeRange().

◆ m_var

QCString TemplateNodeRange::m_var

private

在文件 template.cpp 第 3402 行定义.

被这些函数引用 render() , 以及 TemplateNodeRange().

该类的文档由以下文件生成:

src/template.cpp

Public 成员函数

Private 属性

额外继承的成员函数

详细描述

构造及析构函数说明

◆ TemplateNodeRange()

成员函数说明

◆ render()

类成员变量说明

◆ m_down

◆ m_endExpr

◆ m_loopNodes

◆ m_startExpr

◆ m_var