PEAR Manual
Prev |  | Next

# Event_Dispatcher::removeObserver()

Event_Dispatcher::removeObserver() -- Remove an observer.

## Synopsis

    require_once 'Event/Dispatcher.php';

``bool Event_Dispatcher::removeObserver` (mixed $callback [, string $nName = EVENT_DISPATCHER_GLOBAL [, string $class = '']])`

## Description

Remove an observer from dispatcher.

To remove an observer, specify the same parameters as used in the call to addObserver().

## Parameter

- mixed `$callback`

  Callback to notity, may either be a string containing the name of a global function or an array containing class or object and the name of the method to call.

- string `$nName = EVENT_DISPATCHER_GLOBAL`

  Acts as a filter: notify the observer only if the notification name matches the name passed in this parameter. Use `EVENT_DISPATCHER_GLOBAL` if the observer should be notified regardles of the notification name.

- string `$class = ''`

  Acts as a filter: notify the observer only if the sender of the notification matches the class passed in this parameter.

## Return value

bool `TRUE` if the observer could be removed, `FALSE` otherwise

## Note

This function can not be called statically.

Prev | Home | Next
Event_Dispatcher::addObserver() | Up | Event_Dispatcher::setNotificationClass()