is_callable

(PHP 4 >= 4.0.6, PHP 5)

is_callable - Проверяет, может ли содержимое переменной быть вызвано как функция.

Описание

bool is_callable ( mixed $var [, bool $syntax_only [, string &$callable_name ]] )

Проверяет, может ли содержимое переменной быть вызвано как функция. С помощью функции можно проверить, что простая переменная содержит имя верной функции, или что массив содержит правильно кодированный объект и имя функции.

Список параметров

var

Может быть как именем функции, хранимым в строковой переменной, так и объектом и именем метода объекта, например:

array($SomeObject, 'MethodName')

syntax_only

Если равен TRUE, функция только проверяет, что var может быть функцией или методом. В этом случае будут игнорироваться переменные, не являющиеся строкой или массивом, который имеет неправильную структуру для использования в обратном вызове. Правильная структура предполагает наличие только 2 элементов, первый из которых - объект или строка, и второй - строка.

callable_name

Получает "имя для вызова". В примере ниже это "someClass::someMethod". Следует иметь ввиду, что хотя запись someClass::SomeMethod() означает вызываемый статический метод, в данном случае это не так.

Возвращаемые значения

Возвращает TRUE, если var может быть вызвана, FALSE в противном случае.

Примеры

Пример 1. Пример использования is_callable()

// Как проверить переменную, чтобы узнать, может ли она быть вызвана
// как функция.

//
// Простая переменная, содержащая имя функции
//

function someFunction() 
{
}

$functionVariable = 'someFunction';

var_dump(is_callable($functionVariable, false, $callable_name)); // bool(true)

echo $callable_name, "\n"; // someFunction

//
// Массив, содержащий метод класса
//

class someClass {

 function someMethod() 
 {
 }

}

$anObject = new someClass();

$methodVariable = array($anObject, 'someMethod');

var_dump(is_callable($methodVariable, true, $callable_name)); // bool(true)

echo $callable_name, "\n"; // someClass::someMethod

Смотрите также:
Описание на ru2.php.net
Описание на php.ru