Class: WordParser

void backupPos( string $word)

Backup to the previous token so that it can be retrieved again in a new context.

Occasionally, a word will be passed to an event handler that should be handled by another event handler. This method allows that to happen.

Overridden in child classes as:

phpDocumentorTWordParser::backupPos()

backs the parser up to the previous position

phpDocumentor_HighlightWordParser::backupPos()

back the word parser to the previous token as defined by $last_token

Parameters:

string getBlock( integer $start, integer $len)

Unused

1. function getBlock($start, $len)
2.     {
3.         return substr($this->data, $start, $len);
4.     }

Tags:

Parameters:

int getPos( )

Returns the current pointer position, or 1 character after the end of the word

Tags:

string getSource( )

Retrieve source code for the last function/method

Overridden in child classes as:

phpDocumentorTWordParser::getSource()

loads up next set of source code

string|false getWord( )

Retrieve a token from the token list

The Parser class relies upon this method to retrieve the next token. The $wordseperators array is a collection of strings that delineate tokens for the current parser state. $wordseperators is set by the parser with a call to Parser::configWordParser() every time a new parser state is reached.

For example, while parsing the source code for a class, the word

1. var

is a token, and

1. global

is not, but inside a function, the reverse is true. The parser state PARSER_STATE_CLASS has a token list that includes whitespace, code delimiters like ; and {}, and comment/DocBlock indicators

If the whitespace option has been turned off using setWhitespace(), then no whitespace is returned with tokens

{@ is of course the string containing the PHP code to be parsed, and $pos is the cursor, or current location within the parsed data. }}

Tags:

Overridden in child classes as:

ObjectWordParser::getWord()

phpDocumentorTWordParser::getWord()

Retrieve a token for the phpDocumentorTParser

phpDocumentor_HighlightWordParser::getWord()

Retrieve the next token

void setPos( integer $pos)

Set the internal cursor within the source code

Parameters:

void setSeperator( array &$seps)

Sets the list of possible separator tokens

Tags:

Parameters:

void setup( string &$input)

Initialize the WordParser

Overridden in child classes as:

ObjectWordParser::setup()

Set the word parser to go.

phpDocumentorTWordParser::setup()

Uses http://www.php.net/token_get_all to tokenize the source code.

phpDocumentor_HighlightWordParser::setup()

Initialize the parser object

Parameters:

void setWhitespace( [boolean $val = false])

set parser to return or strip whitespace

Parameters: