Class: parserData

Source Location: /PhpDocumentor-1.4.0RC1/phpDocumentor/ParserData.inc

Class Overview

Contains an in-memory representation of all documentable elements (parserPage, parserFunction, parserDefine, parserInclude, parserClass, parserMethod, parserVar) and their DocBlocks (parserDocBlock).

Author(s):

Greg Beaver <cellog at php.net>

Version:

$Id: ParserData.inc,v 1.8 2007/04/24 21:27:43 ashnazg Exp $

Inherited Variables

Inherited Methods

Class Details

[line 295]
Contains an in-memory representation of all documentable elements (parserPage, parserFunction, parserDefine, parserInclude, parserClass, parserMethod, parserVar) and their DocBlocks (parserDocBlock).

This class works in coordination with phpDocumentor_IntermediateParser to take output from Parser::handleEvent() and create indexes, links, and other assorted things (all documented in phpDocumentor_IntermediateParser and Converter)

Author: Greg Beaver <cellog@php.net>
Version: $Id: ParserData.inc,v 1.8 2007/04/24 21:27:43 ashnazg Exp $
Since: 1.0rc1

[ Top ]

Class Variables

$classelements = array()

[line 327]

array of parsed class elements

Type:

array

[ Top ]

$clean = true

[line 351]

used by phpDocumentor_IntermediateParser::handleDocBlock() to

determine whether a docblock is a page-level docblock or not. $clean is true as long as only 0 or 1 docblock has been parsed, and no element other than parserPage has been parsed

Type:

boolean

[ Top ]

$docblock = false

[line 356]

DocBlock (parserDocBlock) for this page, or false if not set

Type:

mixed

[ Top ]

$elements = array()

[line 307]

array of parsed elements

Type:

array

[ Top ]

$links = array()

[line 343]

array of links descended from abstractLink

See: pageLink, defineLink, classLink, functionLink, methodLink, varLink

Type:

array

[ Top ]

$parent = false

[line 302]

parserPage element that is this parserData's parent, or false if not set.

Type:

false|parserPage

[ Top ]

$privateclasselements = array()

[line 337]

array of parsed class elements with @access private

Type:

array

[ Top ]

$privateelements = array()

[line 322]

array of parsed elements with @access private

Type:

array

[ Top ]

$tutorial = false

[line 332]

Type:

parserTutorial|false

[ Top ]

$type = 'page'

[line 370]

Type is used by many functions to skip the hassle of if

phpDocumentor_get_class($blah) == 'parserBlah'

always 'page', used in element indexing and conversion functions found in Converter

Type:

string

[ Top ]

Method Detail

addElement [line 376]

void addElement(
parserElement
&$element)

Parameters:

parserElement &$element — add a parsed element to the $elements array, also sets $clean to false

[ Top ]

addLink [line 463]

void addLink(
parserElement
&$element, [string
$classorpackage = ''], [string
$subpackage = ''])

Parameters:

parserElement	`&$element`	—	element to add a new link (descended from abstractLink)to the $links array
string	`$classorpackage`	—	classname for elements that are class-based (this may be deprecated in the future, as the classname should be contained within the element. if $element is a page, this parameter is a package name
string	`$subpackage`	—	subpackage name for page elements

[ Top ]

addTutorial [line 421]

void addTutorial(
parserTutorial
$t, Converter
&$c)

Parameters:

parserTutorial	`$t`	—
Converter	`&$c`	—

[ Top ]

explicitDocBlock [line 449]

void explicitDocBlock(
)

Tells this page that its DocBlock was not implicit

[ Top ]

getClasses [line 517]

array getClasses(
Converter
&$c)

returns a list of all classes declared in a file

Return: Format: array(packagename => parserClass,packagename => parserClass,...)

Parameters:

Converter &$c —

[ Top ]

getLink [line 506]

void &getLink(

&$c, [
$text = false])

Parameters:

	`&$c`	—
	`$text`	—

[ Top ]

getName [line 533]

string getName(
)

Get the output-safe filename (. changed to _)

[ Top ]

getTutorial [line 432]

tutorialLink getTutorial(
)

If this file has a tutorial associated with it, returns a link to the tutorial.

[ Top ]

hasClasses [line 412]

boolean hasClasses(
)

Does this package have classes?

[ Top ]

hasExplicitDocBlock [line 441]

boolean hasExplicitDocBlock(
)

If the page-level DocBlock was present in the source, returns true

[ Top ]

hasInterfaces [line 402]

boolean hasInterfaces(
)

Does this package have interfaces?

[ Top ]

isClean [line 550]

bool isClean(
)

Return: returns the value of $clean

[ Top ]

setDocBlock [line 559]

void setDocBlock(
parserDocBlock
&$docblock)

See: parserDocBlock

Parameters:

parserDocBlock &$docblock —

[ Top ]

setParent [line 542]

void setParent(
parserPage
&$parent)

Parameters:

parserPage &$parent — parent element of this parsed data

[ Top ]