is_callable

(PHP 4 >= 4.0.6, PHP 5)

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

Описание

bool is_callable ( callback $name [, bool $syntax_only = false [, string &$callable_name ]] )

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

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

name

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

array($SomeObject, 'MethodName')

syntax_only

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

callable_name

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

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

Возвращает TRUE, если name может быть вызвана, или 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() - Проверяет, существует ли метод в данном классе