Class: parserFunction

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

Class Overview

parserBase
   |
   --parserElement
      |
      --parserFunction

Author(s):

Greg Beaver <cellog at php.net>

Version:

$Id: ParserElements.inc,v 1.19 2007/04/24 21:30:50 ashnazg Exp $

Variables

Methods

Child classes:

parserMethod

Inherited Variables

Class: parserElement

parserElement::$conflicts
parserElement::$docblock
parserElement::$endlinenumber
parserElement::$file
parserElement::$linenumber
parserElement::$name
parserElement::$path

Class: parserBase

parserBase::$value

Inherited Methods

Class: parserElement

parserElement::getEndLineNumber()
parserElement::getFile()
parserElement::getLineNumber()
parserElement::getName()
parserElement::getPackage()
parserElement::getPath()
parserElement::setDocBlock()
parserElement::setEndLineNumber(): Sets the ending line number of elements
parserElement::setFile()
parserElement::setLineNumber(): Set starting line number
parserElement::setName()
parserElement::setPath()

Class: parserBase

parserBase::getType()
parserBase::getValue()
parserBase::setValue()

Class Details

[line 322]

Author: Greg Beaver <cellog@php.net>
Version: $Id: ParserElements.inc,v 1.19 2007/04/24 21:30:50 ashnazg Exp $
Since: 1.0rc1

[ Top ]

Class Variables

$globals = false

[line 352]

global declarations parsed from function definition

Var: Format: array(globalname1, globalname2,....)

Type:

array

[ Top ]

$params = false

[line 336]

parameters parsed from function definition.

param name may be null, in which case, updateParams() must be called from the Converter

Var: Format: array(param name => default value parsed from function definition)
See: updateParams()

Type:

array

[ Top ]

$returnsreference = false

[line 346]

Function returns a reference to an element, instead of a value

set to true if function is declared as:

 function &func(...

Type:

boolean

[ Top ]

$source = ''

[line 359]

Type:

mixed

[ Top ]

$statics = false

[line 357]

static variable declarations parsed from function definition

Var: Format: array(array('name' => staticvar1,'val' => '' or default val of staticvar1),...)

Type:

array

[ Top ]

$type = 'function'

[line 328]

Type is used by many functions to skip the hassle of if phpDocumentor_get_class($blah) == 'parserBlah'

Var: always 'function'

Type:	string
Overrides:	Array

[ Top ]

Method Detail

addGlobals [line 434]

void addGlobals(
array
$globals)

Add all "global $var, $var2" declarations to this function

Parameters:

array $globals — Format: array(globalname1, globalname2,....)

[ Top ]

addParam [line 367]

void addParam(
string
$name, string
$value, [boolean
$has_default = true], [null|string
$typehint = null])

Overridden in child classes as:

parserMethod::addParam()

Parameters:

string	`$name`	—
string	`$value`	—	default value parsed from function definition
boolean	`$has_default`	—	indicates whether this parameter has a default value
null\|string	`$typehint`	—	class type hint

[ Top ]

addSource [line 380]

void addSource(
string|array
$source)

Set the source code. Always array in PHP 4.3.0+

Parameters:

string|array $source —

[ Top ]

addStatics [line 444]

void addStatics(
array
$static, array
$vals)

Add all "static $var, $var2 = 6" declarations to this function

Parameters:

array	`$static`	—	Format: array(varname1, varname2,...)
array	`$vals`	—	Format: array(default val of var 1, default val of var 2,...) if var 1 has no default, array(default val of var 2,...)

[ Top ]

getConflicts [line 423]

mixed getConflicts(
Converter
&$c)

Returns all functions in other packages that have the same name as this function

Return: false or an array Format: (package => parserFunction of conflicting functions)
Usedby: Converter::getFormattedConflicts()

Parameters:

Converter &$c —

[ Top ]

getFunctionCall [line 581]

string getFunctionCall(
)

Get a human-friendly description of the function call

takes declaration like:

and returns: string &func( $param1, [$param2 = 6], [$param3 = array('20',9 => "heroo")] )

Return: stylized function declaration

Overridden in child classes as:

parserMethod::getFunctionCall(): adds "constructor " to start of function call if $isConstructor is true

[ Top ]

getIntricateFunctionCall [line 622]

array getIntricateFunctionCall(

$converter, 
$paramtags)

Like getFunctionCall(), but has no English or pre-determined formatting.

Much more flexible.

Return: Format:

 array('name' => function name,
       'returnsref' => boolean if declared as "function &name()"
       'params' => array('type' => data type of parameter,
                         'description' => from @param tag,
                         'name' => variable name,
                         'default' => default value if any))

See: parserFunction::getFunctionCall()

Overridden in child classes as:

parserMethod::getIntricateFunctionCall()

Parameters:

	`$converter`	—
	`$paramtags`	—

[ Top ]

getLink [line 409]

mixed getLink(
Converter
$c, [string
$text = false], [
$returnobj = false])

quick way to link to this element

Return: converter-specific link to this function

Overridden in child classes as:

parserMethod::getLink(): quick way to link to this element

Parameters:

Converter	`$c`	—
string	`$text`	—	text to display for the link or false for default text
	`$returnobj`	—

[ Top ]

getParam [line 465]

string getParam(
string
$name)

Return: default value of param $name

Parameters:

string $name —

[ Top ]

getReturnsReference [line 562]

boolean getReturnsReference(
)

Return: returns value of $returnsreference

[ Top ]

getSource [line 398]

string|array getSource(
)

Return: source code ready for highlighting

[ Top ]

hasSource [line 389]

boolean hasSource(
)

Determine whether the source code has been requested via {@source}

[ Top ]

listGlobals [line 516]

array listGlobals(
)

Return: format: array(array(index, globalname),...)

[ Top ]

listParams [line 481]

array listParams(
)

Return: format: array(array(paramname, default value),...)

[ Top ]

listStatics [line 535]

array listStatics(
)

Return: format: array(array(static var name, static var default value),...)

[ Top ]

setReturnsReference [line 554]

void setReturnsReference(
)

sets $returnsreference to true

[ Top ]