TemplateNodeMarkers类 参考

Class representing an 'markers' tag in a template 更多...

类 TemplateNodeMarkers 继承关系图:

TemplateNodeMarkers 的协作图:

Public 成员函数
	TemplateNodeMarkers (TemplateParser *parser, TemplateNode *parent, int line, const QCString &data)
void	render (TextStream &ts, TemplateContext *c)
Public 成员函数 继承自 TemplateNodeCreator< TemplateNodeMarkers >
	TemplateNodeCreator (TemplateParser *parser, TemplateNode *parent, int line)
TemplateImpl *	getTemplate ()
Public 成员函数 继承自 TemplateNode
	TemplateNode (TemplateNode *parent)
virtual	~TemplateNode ()
TemplateNode *	parent ()

Private 属性
TemplateNodeList	m_nodes
QCString	m_var
ExprAstPtr	m_listExpr
ExprAstPtr	m_patternExpr

额外继承的成员函数
静态 Public 成员函数 继承自 TemplateNodeCreator< TemplateNodeMarkers >
static TemplateNodePtr	createInstance (TemplateParser *parser, TemplateNode *parent, int line, const QCString &data)
Protected 成员函数 继承自 TemplateNodeCreator< TemplateNodeMarkers >
void	mkpath (const TemplateContextImpl *ci, const std::string &fileName)
Protected 属性 继承自 TemplateNodeCreator< TemplateNodeMarkers >
QCString	m_templateName
int	m_line

详细描述

Class representing an 'markers' tag in a template

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

构造及析构函数说明

TemplateNodeMarkers()

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

inline

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

      : TemplateNodeCreator<TemplateNodeMarkers>(parser,parent,line)
    {
      TRACE(("{TemplateNodeMarkers(%s)\n",qPrint(data)));
      int i = data.find(" in ");
      int w = data.find(" with ");
      if (i==-1 || w==-1 || w<i)
      {
        parser->warn(m_templateName,line,"markers tag as wrong format. Expected: markers <var> in <list> with <string_with_markers>");
      }
      else
      {
        ExpressionParser expParser(parser,line);
        m_var = data.left(i);
        m_listExpr = expParser.parse(data.mid(i+4,w-i-4));
        m_patternExpr = expParser.parse(data.right(data.length()-w-6));
      }
      StringVector stopAt = { "endmarkers" };
      parser->parse(this,line,stopAt,m_nodes);
      parser->removeNextToken(); // skip over endmarkers
      TRACE(("}TemplateNodeMarkers(%s)\n",qPrint(data)));
    }

引用了 QCString::find(), QCString::left(), QCString::length(), m_listExpr, m_nodes, m_patternExpr, TemplateNodeCreator< TemplateNodeMarkers >::m_templateName, m_var, QCString::mid(), TemplateParser::parse(), ExpressionParser::parse(), qPrint(), TemplateParser::removeNextToken(), QCString::right(), TRACE , 以及 TemplateParser::warn().

成员函数说明

render()

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

inlinevirtual

实现了 TemplateNode.

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

    {
      TemplateContextImpl *ci = dynamic_cast<TemplateContextImpl*>(c);
      if (ci==0) return; // should not happen
      ci->setLocation(m_templateName,m_line);
      if (!m_var.isEmpty() && m_listExpr && m_patternExpr)
      {
        TemplateVariant v = m_listExpr->resolve(c);
        const TemplateListIntfPtr list = v.toList();
        TemplateVariant patternStr = m_patternExpr->resolve(c);
        if (list)
        {
          if (patternStr.isString())
          {
            TemplateListIntf::ConstIteratorPtr it = list->createIterator();
            c->push();
            std::string str = patternStr.toString().str();
 
            static const reg::Ex marker(R"(@\d+)");
            reg::Iterator re_it(str,marker);
            reg::Iterator end;
            size_t index=0;
            for ( ; re_it!=end ; ++re_it)
            {
              const auto &match = *re_it;
              size_t newIndex = match.position();
              size_t matchLen = match.length();
              std::string part = str.substr(index,newIndex-index);
              if (ci->needsRecoding())
              {
                ts << ci->recode(QCString(part)); // write text before marker
              }
              else
              {
                ts << part; // write text before marker
              }
              unsigned long entryIndex = std::stoul(match.str().substr(1));
              TemplateVariant var;
              size_t i=0;
              // search for list element at position id
              for (it->toFirst(); (it->current(var)) && i<entryIndex; it->toNext(),i++) {}
              if (i==entryIndex) // found element
              {
                TemplateStructPtr s = TemplateStruct::alloc();
                s->set("id",(int)i);
                c->set("markers",std::static_pointer_cast<TemplateStructIntf>(s));
                c->set(m_var,var); // define local variable to hold element of list type
                bool wasSpaceless = ci->spacelessEnabled();
                ci->enableSpaceless(TRUE);
                m_nodes.render(ts,c);
                ci->enableSpaceless(wasSpaceless);
              }
              else if (i<entryIndex)
              {
                ci->warn(m_templateName,m_line,"markers list does not an element for marker position %d",i);
              }
              index=newIndex+matchLen; // set index just after marker
            }
            if (ci->needsRecoding())
            {
              ts << ci->recode(str.substr(index)); // write text after last marker
            }
            else
            {
              ts << str.substr(index); // write text after last marker
            }
            c->pop();
          }
          else
          {
            ci->warn(m_templateName,m_line,"markers requires a parameter of string type after 'with'!");
          }
        }
        else
        {
          ci->warn(m_templateName,m_line,"markers requires a parameter of list type after 'in'!");
        }
      }
    }

引用了 TemplateStruct::alloc(), TemplateContextImpl::enableSpaceless(), end(), QCString::isEmpty(), TemplateVariant::isString(), TemplateNodeCreator< TemplateNodeMarkers >::m_line, m_listExpr, m_nodes, m_patternExpr, TemplateNodeCreator< TemplateNodeMarkers >::m_templateName, m_var, reg::match(), TemplateContextImpl::needsRecoding(), TemplateContext::pop(), TemplateContext::push(), TemplateContextImpl::recode(), TemplateNodeList::render(), TemplateContext::set(), TemplateContextImpl::setLocation(), TemplateContextImpl::spacelessEnabled(), QCString::str(), TemplateVariant::toList(), TemplateVariant::toString(), TRUE , 以及 TemplateContextImpl::warn().

类成员变量说明

m_listExpr

ExprAstPtr TemplateNodeMarkers::m_listExpr

private

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

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

m_nodes

TemplateNodeList TemplateNodeMarkers::m_nodes

private

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

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

m_patternExpr

ExprAstPtr TemplateNodeMarkers::m_patternExpr

private

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

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

m_var

QCString TemplateNodeMarkers::m_var

private

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

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

---

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

• src/template.cpp