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()


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

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

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

?>

Смотрите также

function_exists() - Возвращает TRUE, если данная функция определена
method_exists() - Проверяет, существует ли метод в данном классе