Docs For Class Classes

addClass [line 300]

void addClass(
parserClass
&$element)

While parsing, add a class to the list of parsed classes

sets up the $classesbyfile, $classesbynamefile, $extendsbyfile, $classchildrenbyfile, $roots arrays, and sets $curclass

Uses: Classes::addPackageToFile() - marks the current class's package as being present in a file

Parameters:

parserClass &$element — element is a parserClass

[ Top ]

addConst [line 353]

void addConst(
parserConst
&$element)

While parsing, add a variable to the list of parsed variables

sets up the $constsbyfile array using $curfile and $curclass

Parameters:

parserConst &$element — element is a parserConst

[ Top ]

addMethod [line 329]

void addMethod(
parserMethod
&$element)

While parsing, add a method to the list of parsed methods

sets up the $methodsbyfile array using $curfile and $curclass

Parameters:

parserMethod &$element — element is a parserMethod

[ Top ]

addPackageToFile [line 377]

void addPackageToFile(
string
$package)

Mark a package as being used in a class

function addPackageToFile($package)

    {
        if (!isset($this->revcpbf[$this->curfile][$package]))
        $this->classpackagebyfile[$this->curfile][] = $package;
        $this->revcpbf[$this->curfile][$package] = 1;
    }

Usedby: Classes::addClass() - marks the current class's package as being present in a file

Parameters:

string $package — package name

[ Top ]

addVar [line 341]

void addVar(
parserVar
&$element)

While parsing, add a variable to the list of parsed variables

sets up the $varsbyfile array using $curfile and $curclass

Parameters:

parserVar &$element — element is a parserVar

[ Top ]

getClass [line 778]

parserClass &getClass(
string
$class, string
$file)

Get the parserClass representation of a class from its name and file

Parameters:

string	`$class`	—	classname
string	`$file`	—	file classname is located in

[ Top ]

getClassByPackage [line 980]

mixed &getClassByPackage(
string
$class, string
$package)

Search for a class in a package

Return: returns false if no class in $package, otherwise returns a parserClass

Parameters:

string	`$class`	—	classname
string	`$package`	—	package classname is in

[ Top ]

getClassesInPath [line 791]

mixed getClassesInPath(
string
$path)

Used by parserData::getClasses() to retrieve classes defined in file $path

retrieves the array entry from $classesbyfile for $path

Return: returns false if no classes defined in the file, otherwise returns an array of parserClasses

Parameters:

string $path — full path to filename

[ Top ]

getConflicts [line 505]

mixed getConflicts(

$class)

If a package contains two classes with the same name, this function finds that conflict

Returns the $classconflicts entry for class $class, minus its own path

Return: returns false if no conflicts, or an array of paths containing conflicts

Parameters:

$class —

[ Top ]

getDefiniteChildren [line 1130]

mixed getDefiniteChildren(
string
$parclass, string
$file)

Get all classes confirmed in parsing to be descended class $parclass in file $file

Return: either false if no children, or array of format array(childname => childfile,childname2 => childfile2,...)
See: parserClass::getChildClassList()
Uses: $definitechild

Parameters:

string	`$parclass`	—	name of parent class
string	`$file`	—	file parent class is found in

[ Top ]

getParentClass [line 1011]

mixed getParentClass(

$class, 
$file)

Find the parent class of a class in file $file

uses 3 tests to find the parent classname:

only one class with the parent classname
more than one class, but only one in the same file as the child
only one parent class in the same package as the child

Return: false if no parent class, a string if no parent class found by that name, and an array(file parentclass is in,parentclassname)
Usedby: Classes::setClassParent() - to find the parent class

Parameters:

	`$class`	—
	`$file`	—

[ Top ]

getRoots [line 1073]

array getRoots(
[boolean
$all = false])

Get a list of all root classes indexed by package. Used to generate

class trees by Converter

Return: array(package => array(rootclassname, rootclassname,...),...)

Parameters:

boolean $all — [since phpDocumentor 1.3.0RC6] determines whether to return class trees that extend non-parsed classes

[ Top ]

Inherit [line 418]

void Inherit(
phpDocumentor_IntermediateParser
&$render)

Main processing engine for setting up class inheritance.

This function uses $roots to traverse the inheritance tree via processChild() and returns the data structures phpDocumentor_IntermediateParser needs to convert parsed data to output using phpDocumentor_IntermediateParser::Convert()

Uses: Classes::processChild() - set up inheritance

Parameters:

phpDocumentor_IntermediateParser &$render —

[ Top ]

nextFile [line 365]

void nextFile(
string
$file)

Prepare to parse a new file

sets $curfile to $file and $curclass to false (no class being parsed)

Parameters:

string $file — file currently being parsed

[ Top ]

processChild [line 544]

void processChild(
phpDocumentor_IntermediateParser
&$render, string
$class, string
$file, [boolean
$furb = false])

This function recursively climbs up the class tree, setting inherited information like package and adds the elements to phpDocumentor_IntermediateParser.

Using structures defined in Classes, the function first sets package information, and then seeks out child classes. It uses 3 tests to determine whether a class is a child class.

child class is in the same file as the parent class and extends parent class
child class is in a different file and specifies the parent's @package in its docblock
child class is in a different file and is in a different @package, with one possible parent class

Global: string $phpDocumentor_DefaultPackageName: default package, usually "default"
Usedby: Classes::Inherit() - set up inheritance

Parameters:

phpDocumentor_IntermediateParser	`&$render`	—
string	`$class`	—	class to process
string	`$file`	—	name of file $class is located in
boolean	`$furb`	—	flag used privately to control informational output while parsing (used when processing leftover classes in Inherit()

[ Top ]

setClassParent [line 395]

void setClassParent(
string
$class, string
$file)

Find the parent class of $class, and set up structures to note this fact

Modifies the parserClass element in $classesbyfile to use the parent's package, and inherit methods/vars

Uses: Classes::getParentClass() - to find the parent class
Uses: $definitechild - if a match is made between a parent class and parameter $class in file $file, then definitechild is set here

Parameters:

string	`$class`	—	child class to find parent class
string	`$file`	—	file child class is located in

[ Top ]

Class: Classes

Class Overview

Author(s):

Version:

Methods

Inherited Variables

Inherited Methods

Class Details

Method Detail

addClass [line 300]

Parameters:

addConst [line 353]

Parameters:

addMethod [line 329]

Parameters:

addPackageToFile [line 377]

Parameters:

addVar [line 341]

Parameters:

getClass [line 778]

Parameters:

getClassByPackage [line 980]

Parameters:

getClassesInPath [line 791]

Parameters:

getConflicts [line 505]

Parameters:

getDefiniteChildren [line 1130]

Parameters:

getParentClass [line 1011]

Parameters:

getRoots [line 1073]

Parameters:

Inherit [line 418]

Parameters:

nextFile [line 365]

Parameters:

processChild [line 544]

Parameters:

setClassParent [line 395]

Parameters: