/**
* Generic method which iterates through all tokens between the braces following the current position in the token
* iterator.
*
* Please note: This method will also move the cursor position in the token iterator forward.
* When a token is encountered this method will invoke the processToken method, which is defined in the
* DocBlox_Reflection_Abstract class. Literals are ignored.
*
* @see DocBlox_Reflection_Abstract
* @param DocBlox_TokenIterator $tokens
* @return int[]
*/
public function processTokens(DocBlox_TokenIterator $tokens)
{
$level = -1;
$start = 0;
$end = 0;
// parse class contents
$this->debug('>> Processing tokens');
$token = null;
while ($tokens->valid())
{
/** @var DocBlox_Token $token */
$token = $token === null ? $tokens->current() : $tokens->next();
// determine where the 'braced' section starts and end.
// the first open brace encountered is considered the opening brace for the block and processing will
// be 'breaked' when the closing brace is encountered
if ($token
&& (!$token->getType()
|| ($token->getType() == T_CURLY_OPEN)
|| ($token->getType() == T_DOLLAR_OPEN_CURLY_BRACES))
&& (($token->getContent() == '{')
|| (($token->getContent() == '}'))))
{
switch ($token->getContent())
{
case '{':
// expect the first brace to be an opening brace
if ($level == -1)
{
$level++;
$start = $tokens->key();
}
$level++;
break;
case '}':
if ($level == -1) continue;
$level--;
// reached the end; break from the while
if ($level === 0)
{
$end = $tokens->key();
break 2; // time to say goodbye
}
break;
}
continue;
}
if ($token && $token->getType())
{
// if a token is encountered and it is not a literal, invoke the processToken method
$this->processToken($token, $tokens);
}
}
// return the start and end token index
return array($start, $end);
}
public function processVariable(DocBlox_TokenIterator $tokens)
{
// is the variable occurs within arguments parenthesis then it is an argument
if (($tokens->key() > $this->arguments_token_start) && ($tokens->key() < $this->arguments_token_end))
{
$this->resetTimer('variable');
$argument = new DocBlox_Reflection_Argument();
$argument->parseTokenizer($tokens);
$this->arguments[$argument->getName()] = $argument;
$this->debugTimer('>> Processed argument '.$argument->getName(), 'variable');
}
}
public function testFindPreviousByType()
{
$pos = 40;
$this->object->seek($pos);
$token = $this->object->findPreviousByType(T_CLASS, 0);
$this->assertType('DocBlox_Token', $token, 'Expected to find a T_CLASS in the dataset');
$this->assertEquals($pos, $this->object->key(), 'Expected the key to have a different position');
$this->object->seek($pos);
$token = $this->object->findPreviousByType(T_CLASS, $pos);
$this->assertType('DocBlox_Token', $token, 'Expected to find a T_CLASS in the dataset within '.$pos.' tokens');
$this->assertEquals($pos, $this->object->key(), 'Expected the key to have a different position');
$this->object->seek($pos);
$token = $this->object->findPreviousByType(T_CLASS, $pos, T_NAMESPACE);
$this->assertType('DocBlox_Token', $token, 'Expected to find a T_CLASS in the dataset within '.$pos.' tokens before a T_NAMESPACE is encountered');
$this->assertEquals($pos, $this->object->key(), 'Expected the key to have a different position');
$this->object->seek($pos);
$token = $this->object->findPreviousByType(T_CLASS, $pos, T_FUNCTION);
$this->assertFalse($token, 'Expected to fail finding a T_CLASS in the dataset within '.$pos.' tokens before a T_FUNCTION is encountered');
$this->assertEquals($pos, $this->object->key(), 'Expected the key to be at the starting position');
}
protected function processTokens(DocBlox_TokenIterator $tokens)
{
return array($tokens->key(), $tokens->key());
}
