Docs For Class PEAR_Delegator

array getDelegateForMethodFirst(

$owner, 
$method, string
$method,...)

Gets the first native delegate that responds to a certain method.

The method returns the first delegate native to the calling delegator, which can respond to each method in question. Moreover, this method returns delegates that actually implement methods over those that inherit them from delegates.

Return:

The result is an
 associative array of the form:
 Array
 (
     [method1] = $delegate
     [methodi] = $delegatei
     ...
 )
 Note: If a single classname is passed, the actual object is returned.

See: PEAR_Delegator_Extensions::getDelegateForMethodRecursive(), PEAR_Delegator_Extensions::getDelegateForMethodRecursiveExact()
Access: public
Uses: PEAR_Delegator::method_exists()

Parameters:

string	`$method,...`	—	This specifies the method for whose responder is searched.
	`$owner`	—
	`$method`	—

[ Top ]

array getDelegateForMethodRecursive(

$owner, 
$method1, string
$method1,...)

Gets the delegate objects that respond to a certain method.

This method returns delegates native to the calling delegator as well as delegates of delegate owning delegates (it's recursive). This method is provided, because it may be useful, but its use is discouraged, as objects should logically only have access to their native delegates.

Return:

The result is an
 associative array of the form:
 Array
 (
     [method1] = Array
                    (
                        delegate11
                        delegate12
                        ...
                    )
     [methodi] = Array
                    (
                        delegate1i
                        delegate1i
                        ...
                    )
     ...
 )
 Note: If a single method is passed, a traditional array with numbered
 elements is returned.

See: PEAR_Delegator_Extensions::getDelegateForMethodRecursiveExact()
Access: public
Uses: PEAR_Delegator::method_exists()

Parameters:

string	`$method1,...`	—	This specifies the method for whose responder is searched.
	`$owner`	—
	`$method1`	—

[ Top ]

array getDelegateForMethodRecursiveExact(

$owner, 
$method1, string
$method1,...)

Gets the delegate object (native or otherwise) that implements the method in question.

This method returns the delegate in the delegate hierarchy which actually implements the method. This method is provided, because it may be useful, but its use is discouraged, as objects should logically only have access to their native delegates.

Return:

 An array of the form:
 Array
 (
     [method1] = Array
                    (
                        delegate11
                        delegate12
                        ...
                    )
     [methodi] = Array
                    (
                        delegate1i
                        delegate1i
                        ...
                    )
     ...
 )
 Note: If a single method is passed, a traditional array with numbered
 elements is returned.

See: PEAR_Delegator_Extensions::getDelegateForMethodRecursive()
Access: public

Parameters:

string	`$method1,...`	—	This specifies the method for whose implementor is searched.
	`$owner`	—
	`$method1`	—

[ Top ]

array getDelegateRecursive(

$owner, class
$classname1)

Gets the delegates that is of the specified class.

This method returns instances of the specified classname as well as child instances of the specified classname, including subdelegates, which are anywhere in the delegate hierarchy. This method is provided, because it may be useful, but its use is discouraged, as objects should logically only have access to their native delegates.

Return:

 The result is an
 associative array of the form:
 Array
 (
     [classname1] = Array
                    (
                        delegate11
                        delegate12
                        ...
                    )
     [classnamei] = Array
                    (
                        delegate1i
                        delegate1i
                        ...
                    )
     ...
 )
 Note: If a single classname is passed, a traditional array with numbered
 elements is returned.

See: PEAR_Delegator::getAllDelegates(), PEAR_Delegator::getDelegate(), PEAR_Delegator_Extensions::getDelegateRecursive(), PEAR_Delegator_Extensions::getDelegateRecursiveExact()
Access: public

Parameters:

class	`$classname1`	—	This specifies a delegate classname. Any number of arguments after this is acceptable.
	`$owner`	—

[ Top ]

array getDelegateRecursiveExact(

$owner, class
$classname1)

Gets the delegate that is of the specified class.

This method returns classes of the specified type. This does not return subdelegates. This method is provided, because it may be useful, but its use is discouraged, as objects should logically only have access to their native delegates.

Return:

 The result is an
 associative array of the form:
 Array
 (
     [classname1] = Array
                    (
                        delegate11
                        delegate12
                        ...
                    )
     [classnamei] = Array
                    (
                        delegate1i
                        delegate1i
                        ...
                    )
     ...
 )
 Note: If a single classname is passed, a traditional array with numbered
 elements is returned.

See: PEAR_Delegator::getAllDelegates(), PEAR_Delegator::getDelegate(), PEAR_Delegator_Extensions::getDelegateRecursive(), PEAR_Delegator_Extensions::getDelegateRecursiveExact()
Access: public

Parameters:

class	`$classname1`	—	This specifies a delegate classname. Any number of arguments after this is acceptable.
	`$owner`	—

[ Top ]

void removeDelegateRecursiveExact(

$owner, 
$specifier, mixed
$specifier,...)

Removes the specified delegate recursively

Only exact delegates are removed, as it is otherwise superfluous.

See: PEAR_Delegator::removeAllDelegates(), PEAR_Delegator::removeDelegate()
Access: public
Uses: filterMethodMapWithDelegate()

Parameters:

mixed	`$specifier,...`	—	Specifies the delegate, whose information is is to be removed. If it is a string, then it adheres to the tests of getDelegateExact(). If it is an object, then it searches the for that delegate to remove.
	`$owner`	—
	`$specifier`	—

[ Top ]

bool uncacheMethod(

$owner, string
$method)

Removes an entry from the _method_map array.

This method is for removing entries in the _method_map array. it simply tests for the entry for existence and removes it.

This is an internal method.

Return: If entry exists true; false otherwise.
See: PEAR_Delegator::cacheMethod()
Access: protected

Parameters:

string	`$method`	—	This method must be in lowercase.
	`$owner`	—

[ Top ]

Class: PEAR_Delegator_Extensions

Class Overview

Author(s):

Methods

Inherited Variables

Inherited Methods

Class Details

Method Detail

getDelegateForMethodFirst [line 325]

Parameters:

getDelegateForMethodRecursive [line 211]

Parameters:

getDelegateForMethodRecursiveExact [line 275]

Parameters:

getDelegateRecursive [line 80]

Parameters:

getDelegateRecursiveExact [line 149]

Parameters:

removeDelegateRecursiveExact [line 383]

Parameters:

uncacheMethod [line 421]

Parameters: