TemplateParser Class Reference

Parser for templates. More...

Public Member Functions
	TemplateParser (const TemplateEngine *engine, const QCString &templateName, QList< TemplateToken > &tokens)
void	parse (TemplateNode *parent, int line, const QStrList &stopAt, QList< TemplateNode > &nodes)
bool	hasNextToken () const
TemplateToken *	takeNextToken ()
void	removeNextToken ()
void	prependToken (const TemplateToken *token)
const TemplateToken *	currentToken () const
QCString	templateName () const
void	warn (const char *fileName, int line, const char *fmt,...) const

Private Attributes
const TemplateEngine *	m_engine
QCString	m_templateName
QList< TemplateToken > &	m_tokens

Detailed Description

Parser for templates.

Definition at line 1656 of file template.cpp.

Constructor & Destructor Documentation

TemplateParser::TemplateParser	(	const TemplateEngine *	engine,
		const QCString &	templateName,
		QList< TemplateToken > &	tokens
	)

Definition at line 4661 of file template.cpp.

                                                             :
   m_engine(engine), m_templateName(templateName), m_tokens(tokens)
{
}

Member Function Documentation

const TemplateToken * TemplateParser::currentToken

(

)

const

Definition at line 4757 of file template.cpp.

{
  return m_tokens.getFirst();
};

bool TemplateParser::hasNextToken

(

)

const

Definition at line 4747 of file template.cpp.

{
  return !m_tokens.isEmpty();
}

void TemplateParser::parse	(	TemplateNode *	parent,
		int	line,
		const QStrList &	stopAt,
		QList< TemplateNode > &	nodes
	)

Definition at line 4668 of file template.cpp.

{
  TRACE(("{TemplateParser::parse\n"));
  // process the tokens. Build node list
  while (hasNextToken())
  {
    TemplateToken *tok = takeNextToken();
    //printf("%p:Token type=%d data='%s' line=%d\n",
    //       parent,tok->type,tok->data.data(),tok->line);
    switch(tok->type)
    {
      case TemplateToken::Text:
        nodes.append(new TemplateNodeText(this,parent,tok->line,tok->data));
        break;
      case TemplateToken::Variable: // {{ var }}
        nodes.append(new TemplateNodeVariable(this,parent,tok->line,tok->data));
        break;
      case TemplateToken::Block:    // {% tag %}
        {
          QCString command = tok->data;
          int sep = command.find(' ');
          if (sep!=-1)
          {
            command=command.left(sep);
          }
          if (stopAt.contains(command))
          {
            prependToken(tok);
            TRACE(("}TemplateParser::parse: stop\n"));
            return;
          }
          QCString arg;
          if (sep!=-1)
          {
            arg = tok->data.mid(sep+1);
          }
          TemplateNode *node = TemplateNodeFactory::instance()->
                               create(command,this,parent,tok->line,arg);
          if (node)
          {
            nodes.append(node);
          }
          else if (command=="empty"          || command=="else"         ||
                   command=="endif"          || command=="endfor"       ||
                   command=="endblock"       || command=="endwith"      ||
                   command=="endrecursetree" || command=="endspaceless" ||
                   command=="endmarkers"     || command=="endmsg"       ||
                   command=="endrepeat"      || command=="elif"         ||
                   command=="endrange"       || command=="endtabbing")
          {
            warn(m_templateName,tok->line,"Found tag '%s' without matching start tag",command.data());
          }
          else
          {
            warn(m_templateName,tok->line,"Unknown tag '%s'",command.data());
          }
        }
        break;
    }
    delete tok;
  }
  if (!stopAt.isEmpty())
  {
    QStrListIterator it(stopAt);
    const char *s;
    QCString options;
    for (it.toFirst();(s=it.current());++it)
    {
      if (!options.isEmpty()) options+=", ";
      options+=s;
    }
    warn(m_templateName,line,"Unclosed tag in template, expected one of: %s",
        options.data());
  }
  TRACE(("}TemplateParser::parse: last token\n"));
}

void TemplateParser::prependToken

(

const TemplateToken *

token

)

Definition at line 4767 of file template.cpp.

{
  m_tokens.prepend(token);
}

void TemplateParser::removeNextToken

(

)

Definition at line 4762 of file template.cpp.

{
  m_tokens.removeFirst();
}

TemplateToken * TemplateParser::takeNextToken

(

)

Definition at line 4752 of file template.cpp.

{
  return m_tokens.take(0);
}

QCString TemplateParser::templateName ( ) const

inline

Definition at line 1668 of file template.cpp.

{ return m_templateName; }

void TemplateParser::warn	(	const char *	fileName,
		int	line,
		const char *	fmt,
			...
	)		const

Definition at line 4772 of file template.cpp.

{
  va_list args;
  va_start(args,fmt);
  va_warn(fileName,line,fmt,args);
  va_end(args);
  m_engine->printIncludeContext(fileName,line);
}

Member Data Documentation

const TemplateEngine* TemplateParser::m_engine

private

Definition at line 1671 of file template.cpp.

QCString TemplateParser::m_templateName

private

Definition at line 1672 of file template.cpp.

QList<TemplateToken>& TemplateParser::m_tokens

private

Definition at line 1673 of file template.cpp.

---

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

• doxygen-1.8.11/src/template.cpp