Properties

$fqsen

$fqsen : string

Type

string — Fully Qualified Structural Element Name; the FQCN including method, property of constant name

$name

$name : string

Type

string — The local name for this element

$package

$package : string

Type

string — The package with which this element is associated

$summary

$summary : string

Type

string — A summary describing the function of this element in short.

$description

$description : string

Type

string — A more extensive description of this element.

$line

$line : integer

Type

integer — The line number on which this element occurs.

$types

$types : array<mixed,string>

Type

array<mixed,string> — an array of normalized types that should be in this Argument

$default

$default : string|null

Type

string|null — the default value for an argument or null if none is provided

$byReference

$byReference : boolean

Type

boolean — whether the argument passes the parameter by reference instead of by value

$isVariadic

$isVariadic : boolean

Type

boolean — Determines if this Argument represents a variadic argument

Methods

__construct()

__construct() 

Initializes this descriptor.

setFullyQualifiedStructuralElementName()

setFullyQualifiedStructuralElementName(string  $name) : void

Sets the Fully Qualified Structural Element Name (FQSEN) for this element.

Parameters

string $name

getFullyQualifiedStructuralElementName()

getFullyQualifiedStructuralElementName() : string

Returns the Fully Qualified Structural Element Name (FQSEN) for this element.

Returns

string

setName()

setName(string  $name) : void

Sets the local name for this element.

Parameters

string $name

getName()

getName() : string

Returns the local name for this element.

Returns

string

getNamespace()

getNamespace() : \phpDocumentor\Descriptor\NamespaceDescriptor|string|null

Returns the namespace for this element or null if none is attached.

Returns

\phpDocumentor\Descriptor\NamespaceDescriptor|string|null

setSummary()

setSummary(string  $summary) : void

Sets the summary describing this element in short.

Parameters

string $summary

getSummary()

getSummary() : string

Returns the summary which describes this element.

This method will automatically attempt to inherit the parent's summary if this one has none.

Returns

string

setDescription()

setDescription(string  $description) : void

Sets a description for this element.

Parameters

string $description

getDescription()

getDescription() : string

Returns the description for this element.

This method will automatically attempt to inherit the parent's description if this one has none.

Returns

string

setLocation()

setLocation(\phpDocumentor\Descriptor\FileDescriptor  $file, integer  $line) : void

Sets the file and linenumber where this element is at.

Parameters

\phpDocumentor\Descriptor\FileDescriptor $file
integer $line

getPath()

getPath() : string

Returns the path to the file containing this element relative to the project's root.

Returns

string

getFile()

getFile() : \phpDocumentor\Descriptor\FileDescriptor|null

Returns the file in which this element resides or null in case the element is not bound to a file.

.

Returns

\phpDocumentor\Descriptor\FileDescriptor|null

getLine()

getLine() : integer

Returns the line number where the definition for this element can be found.

Returns

integer

setLine()

setLine(integer  $lineNumber) : void

Sets the line number for this element's location in the source file.

Parameters

integer $lineNumber

isDeprecated()

isDeprecated() : boolean

Checks whether this element is deprecated.

Returns

boolean

setErrors()

setErrors(\phpDocumentor\Descriptor\Collection  $errors) : void

Sets a list of all errors associated with this element.

Parameters

\phpDocumentor\Descriptor\Collection $errors

__call()

__call(string  $name, array<mixed,mixed>  $arguments) : \phpDocumentor\Descriptor\Collection|null

Dynamically constructs a set of getters to retrieve tag (collections) with.

Important: __call() is not a fast method of access; it is preferred to directly use the getTags() collection. This interface is provided to allow for uniform and easy access to certain tags.

Parameters

string $name
array<mixed,mixed> $arguments

Returns

\phpDocumentor\Descriptor\Collection|null

__toString()

__toString() : string

Represents this object by its unique identifier, the Fully Qualified Structural Element Name.

Returns

string

setTypes()

setTypes(\phpDocumentor\Descriptor\Collection  $types) : void

Sets a normalized list of types that the argument represents.

Arguments should have one of the types mentioned in this array. If this array is empty than that is considered to be the type mixed (meaning: can be anything).

Any Type representing a class/interface/trait should be normalized to its complete FQCN, including preceding backslash. Types that do not represent a class/interface/trait should be written in lowercaps and should not be preceded by a backslash.

Parameters

\phpDocumentor\Descriptor\Collection $types

An Collection of normalized types that should be in this Argument

setDefault()

setDefault(string  $value) : void

Sets the default value for an argument expressed as a string.

Parameters

string $value

A textual representation of the default value.

getDefault()

getDefault() : string|null

Returns the default value for an argument as string or null is no default is set.

Returns

string|null —

A textual representation of the default value, or null if no default value is present.

setByReference()

setByReference(boolean  $byReference) : void

Sets whether this argument passes its parameter by reference or by value.

Parameters

boolean $byReference

True if the parameter is passed by reference, otherwise it is by value.

isByReference()

isByReference() : boolean

Returns whether the parameter is passed by reference or by value.

Returns

boolean —

True if the parameter is passed by reference, otherwise it is by value.

setVariadic()

setVariadic(boolean  $isVariadic) : false

Sets whether this argument represents a variadic argument.

Parameters

boolean $isVariadic

Returns

false

isVariadic()

isVariadic() : boolean

Returns whether this argument represents a variadic argument.

Returns

boolean