Функции, определяемые пользователем
Для чего нужны функции? Чтобы ответить на этот вопрос, нужно понять, что вообще представляют собой функции. В программировании, как и в математике, функция есть отображение множества ее аргументов на множество ее значений. То есть функция для каждого набора значений аргумента возвращает какие-то значения, являющиеся результатом ее работы. Зачем нужны функции, попытаемся объяснить на примере. Классический пример функции в программировании – это функция, вычисляющая значение факториала числа. То есть мы задаем ей число, а она возвращает нам его факториал. При этом не нужно для каждого числа, факториал которого мы хотим получить, повторять один и тот же код – достаточно просто вызвать функцию с аргументом, равным этому числу.
Функция вычисления факториала натурального числа
function fact($n) { if ($n==0) return 1; else return $fact = $n * fact($n-1); } echo fact(3).'<br>'; // можно было бы написать echo (3*2);<br>echo fact(50); // но если число большое удобнее пользоваться функцией // чем писать echo (50*49*48*...*3*2); |
Таким образом, когда мы осуществляем действия, в которых прослеживается зависимость от каких-то данных, и при этом, возможно, нам понадобится выполнять такие же действия, но с другими исходными данными, удобно использовать механизм функций – оформить блок действий в виде тела функции, а меняющиеся данные – в качестве ее параметров.
Посмотрим, как в общем виде выглядит задание (объявление) функции. Функция может быть определена с помощью следующего синтаксиса:
function Имя_функции (параметр1, параметр2, ... параметрN)
{
Блок_действий
return "значение возвращаемое функцией";
}
Если прямо так написать в php-программе, то работать ничего не будет. Во-первых, Имя_функции и имена параметров функции
(параметр1, параметр2 и т.д.) должны соответствовать правилам наименования в PHP (и русских символов в них лучше не использовать). Имена функций нечувствительны к регистру. Во-вторых, параметры функции – это переменные языка, поэтому перед названием каждого из них должен стоять знак $. Никаких многоточий ставить в списке параметров нельзя. В-третьих, вместо слов блок_действий в теле функции должен находиться любой правильный PHP-код (не обязательно зависящий от параметров). И наконец, после ключевого слова return должно идти корректное php-выражение (что-либо, что имеет значение).
Кроме того, у функции может и не быть параметров, как и возвращаемого значения. Пример правильного объявления функции – функция вычисления факториала, приведенная выше.
Как происходит вызов функции? Указывается имя функции и в круглых скобках список значений ее параметров, если таковые имеются:
<?php Имя_функции ("значение_для_параметра1", "значение_для_параметра2",...); // пример вызова функции – вызов функции вычисления факториала приведен выше, // там для вычисления факториала числа 3 мы писали: fact(3); // где fact – имя вызываемой функции, а 3 – значение ее параметра с именем $n ?> |
Когда можно вызывать функцию? Казалось бы, странный вопрос. Функцию можно вызвать после ее определения, т.е. в любой строке программы ниже блока function f_name(){…}. В PHP3 это было действительно было так. Но уже в PHP4 такого требования нет.
Все дело в том, как интерпретатор обрабатывает получаемый код. Единственное исключение составляют функции, определяемые условно (внутри условных операторов или других функций). Когда функция определяется таким образом, ее определение должно предшествовать ее вызову.
<?php $make = true; /* здесь нельзя вызвать Make_event(); потому что она еще не существует, но в любом месте можно вызвать Save_info() так как она не определяется внутри условного оператора*/ Save_info("Вася","Иванов", "Я выбрал курс по PHP"); if ($make) { function Make_event(){ // определение функции Make_event() echo "Хочу изучать Python"; } } Make_event(); // теперь можно вызывать Make_event() function Save_info($first, $last, $message){ // определение функции Save_info echo "$message"; echo "Имя: ". $first . " ". $last . " "; } Save_info("Федя","Федоров","А я выбрал Lisp"); // Save_info можно вызывать и здесь ?> |
Если функция однажды определена в программе, то переопределить или удалить ее позже нельзя. Несмотря на то, что имена функций нечувствительны к регистру, лучше вызывать функцию по тому же имени, каким она была задана в определении.
<?php /* нельзя сохранить данные, т.е. вызвать функцию DataSave() до того, как выполнена проверка их правильности, т.е. вызвана функция DataCheck() */ DataCheck(); DataSave(); function DataCheck(){ // проверка правильности данных function DataSave(){ // сохраняем данные } } ?> |
Рассмотрим подробнее аргументы функций, их назначение и использование.
Аргументы функций
У каждой функции может быть, как мы уже говорили, список аргументов. С помощью этих аргументов в функцию передается различная информация (например, значение числа, факториал которого надо подсчитать). Каждый аргумент представляет собой переменную или константу.
С помощью аргументов данные в функцию можно передавать тремя различными способами. Это передача аргументов по значению (используется по умолчанию), по ссылке и задание значения аргументов по умолчанию. Рассмотрим эти способы
подробнее.
Когда аргумент передается в функцию по значению, изменение значения аргумента внутри функции не влияет на его значение вне функции. Чтобы позволить функции изменять ее аргументы, их нужно передавать по ссылке. Для этого в определении функции перед именем аргумента следует написать знак амперсанд «&».
<?php // напишем функцию, которая бы добавляла к строке слово checked unction add_label(&$data_str){ $data_str .= "checked"; } $str = "<input type=radio name=article "; // пусть имеется такая строка echo $str ."> "; // выведет элемент формы – не отмеченную радио кнопку add_label($str); // вызовем функцию echo $str ."> "; // это выведет уже отмеченную радио кнопку ?> |
В функции можно определять значения аргументов, используемые по умолчанию. Само значение по умолчанию должно быть константным выражением, а не переменной и не представителем класса или вызовом другой функции.
У нас есть функция, создающая информационное сообщение, подпись к которому меняется в зависимости от значения переданного ей параметра. Если значение параметра не задано, то используется подпись «Оргкомитет».
<?php function Message($sign="Оргкомитет."){ // здесь параметр sign имеет по умолчанию значение "Оргкомитет" echo "Следующее собрание состоится завтра. "; echo $sign . " "; } Message(); // вызываем функцию без параметра. В этом случае подпись – это Оргкомитет Message("С уважением, Вася"); // В этом случае подпись будет "С уважением, Вася." ?> |
Если у функции несколько параметров, то те аргументы, для которых задаются значения по умолчанию, должны быть записаны после всех остальных аргументов в определении функции. В противном случае появится ошибка, если эти аргументы будут опущены при
вызове функции.
Например, мы хотим внести описание статьи в каталог. Пользователь должен ввести такие характеристики статьи, как ее название, автор и краткое описание. Если пользователь не вводит имя автора статьи, считаем, что это Иванов Иван.
Если мы напишем вот так:
<?php function Add_article($author="Иванов Иван", $title, $description){ echo "Заносим в каталог статью: $title,"; echo "автор $author"; echo "<br>Краткое описание: ";<br> "$description <hr>"; } Add_article("Кто такие хакеры", "Это статья про хакеров..."); ?> |
То в результате получим:
Warning: Missing argument 3 for add_article() in<br>c:\serv\www\test\func\def_bad.php <br> on line 2 |
Списки аргументов переменной длины
В PHP4 можно создавать функции с переменным числом аргументов. То есть мы создаем функцию, не зная заранее, со сколькими аргументами ее вызовут. Для написания такой функции никакого специального синтаксиса не требуется. Все делается с помощью встроенных функций func_num_args(), func_get_arg(), func_get_args().
Функция func_num_args() возвращает число аргументов, переданных в текущую функцию. Эта функция может использоваться только внутри определения пользовательской функции. Если она появится вне функции, то интерпретатор выдаст
предупреждение.
<?php function DataCheck(){ $n = func_num_args(); echo "Число аргументов функции $n"; } DataCheck(); // выведет строку "Число аргументов функции 0" DataCheck(1,2,3); // выведет строку "Число аргументов функции 3" ?> |
Функция func_get_arg (целое номер_аргумента) возвращает аргумент из списка переданных в функцию аргументов,
порядковый номер которого задан параметром номер_аргумента. Аргументы функции считаются начиная с нуля. Как и func_num_args(), эта функция может использоваться только внутри определения какой-либо функции.
Номер_аргумента не может превышать число аргументов, переданных в функцию. Иначе будет сгенерировано предупреждение, и функция func_get_arg() возвратит False.
Создадим функцию для проверки типа данных ее аргументов. Считаем, что проверка прошла успешно, если первый аргумент функции – целое число, второй – строка.
<?php function DataCheck() { $check =true; $n = func_num_args(); // число аргументов, переданных в функцию if ($n>=1) if (!is_int(func_get_arg(0))) // проверяем, является ли первый переданный аргумент целым числом $check = false; if ($n>=2) if (!is_string(func_get_arg(1))) // проверяем, является ли второй переданный аргумент строкой $check = false; return $check; } if (DataCheck(123,"text")) echo "Проверка прошла успешно<br>"; else echo "Данные не удовлетворяют условиям<br>"; if (DataCheck(324)) echo "Проверка прошла успешно<br>"; else echo "Данные не удовлетворяют условиям<br>"; ?> |
Функция func_get_args() возвращает массив, состоящий из списка аргументов, переданных функции.
Каждый элемент массива соответствует аргументу, переданному функции. Если функция используется вне определения пользовательской функции, то генерируется предупреждение.
Перепишем предыдущий пример, используя эту функцию. Будем проверять, является ли целым числом каждый четный аргумент, передаваемый функции:
<?php function DataCheck() { $check =true; $n = func_num_args(); // число аргументов, переданных в функцию $args = func_get_args(); // массив аргументов функции for ($i=0; $i<$n; $i++) { $v = $args[$i]; if ($i % 2 == 0) { if (!is_int($v)) $check = false; // проверяем, является ли четный аргумент целым } } return $check; } if (datacheck(array("text", 324))) echo "проверка прошла успешно<br>"; else echo "данные не удовлетворяют условиям<br>"; ?> |
Как видим, комбинации функций func_num_args(), func_get_arg() и func_get_args() используется для того, чтобы функции могли иметь переменный список
аргументов. Эти функции были добавлены только в PHP 4. В PHP3 для того, чтобы добиться подобного эффекта, можно использовать в качестве аргумента функции массив. Например, вот так можно написать скрипт, проверяющий, является ли каждый нечетный параметр функции целым числом:
<?php function DataCheck($params) { $check =true; $n = count($params); // число аргументов, переданных в функцию for ($i=0; $i<$n; $i++) { $v = $params[$i]; if ($i % 2 !== 0) { if (!is_int($v)) $check = false; // проверяем, является ли нечетный аргумент целым } } return $check; } if (DataCheck(array("text", 324))) echo "Проверка прошла успешно<br>"; else echo "Данные не удовлетворяют условиям<br>"; ?> |
Использование переменных внутри функции
Глобальные переменные
Чтобы использовать внутри функции переменные, заданные вне ее, эти переменные нужно объявить как глобальные. Для этого в теле функции следует перечислить их имена после ключевого слова global: global $var1, $var2;
<?php $a=1; function Test_g() { global $a; $a = $a*2; echo 'в результате работы функции $a='.$a; } echo 'вне функции $a='.$a.', '; // вне функции $a=1, Test_g(); // в результате работы функции $a=2 echo "<br>"; echo 'вне функции $a='.$a.', '; // вне функции $a=2, Test_g(); // в результате работы функции $a=4 ?> |
Когда переменная объявляется как глобальная, фактически создается ссылка на глобальную переменную. Поэтому такая запись эквивалентна следующей (массив $GLOBALS содержит все переменные, глобальные относительно текущей области
видимости):
$var1 = &$GLOBALS["var1"];<br>$var2 = &$GLOBALS["var2"];<br> |
Это значит, например, что
удаление переменной $var1
не удаляет глобальной переменной $GLOBALS["var1"].
Статические переменные
Чтобы
использовать переменные только внутри функции, при этом сохраняя их
значения и после выхода из функции, нужно объявить эти переменные как
статические. Статические
переменные
видны только внутри функции и не теряют своего значения, если
выполнение программы выходит за пределы функции. Объявление таких
переменных производится с помощью ключевого слова static:
static $var1, $var2;<br> |
Статической
переменной может быть присвоено любое значение, но не
ссылка.
<?<br>function Test_s(){<br>static $a = 1; // нельзя присваивать выражение или ссылку<br> $a = $a*2;<br> echo $a;<br>}<br>Test_s(); // выведет 2<br>echo $a; // ничего не выведет, так как $a доступна только внутри функции<br>Test_s(); // внутри функции $a=2, поэтому результатом работы функции будет число 4<br>?><br> |
Возвращаемые значения
Все
функции, приведенные выше в качестве примеров, выполняли какие-либо
действия. Кроме подобных действий, любая функция может возвращать как
результат своей работы какое-нибудь значение. Это делается с помощью
утверждения return.
Возвращаемое значение может быть любого типа, включая списки и объекты.
Когда интерпретатор встречает команду return
в теле функции, он
немедленно прекращает ее исполнение и переходит на ту строку, из
которой была вызвана функция.
Например,
составим функцию, которая возвращает возраст человека. Если человек не
умер, то возраст считается относительно текущего года.
<?php<br>/* если второй параметр вычисляется <br>как true, то он рассматривается как <br>дата смерти, */<br><br>function Age($birth, $is_dead)<br>{<br> if ($is_dead) return $is_dead-$birth;<br> else return date("Y")-$birth;<br>}<br>echo Age(1971, false); // для 2009 года выведет 38<br>echo Age(1971, 2001); // выведет 30<br>?><br> |
В этом примере можно было и не
использовать функцию return,
а просто заменить ее функцией вывода echo.
Однако если мы все же делаем так, что функция возвращает какое-то
значение (в данном случае возраст человека), то в программе мы можем
присвоить любой переменной значение этой функции:
$an_age = Age(1981, 2004);<br> |
В результате работы функции
может быть
возвращено только одно значение. Несколько значений можно получить,
если возвращать список значений (одномерный массив). Допустим, мы хотим
получить полный возраст человека с точностью до дня.
<?php<br>function Full_age($b_day, $b_month, $b_year)<br>{<br> $y = date("Y");<br> $m = intval(date("m"));<br> $d = intval(date("d"));<br> $b_month = intval($b_month);<br> $b_day = intval($b_day);<br> $b_year = intval($b_year);<br><br> $day = ($b_day > $d ? 30 - $b_day + $d : $d - $b_day);<br> $tmpMonth = ($b_day > $d ? -1 : 0);<br> $month = ($b_month > $m + $tmpMonth ? 12 - $b_month + $tmpMonth + $m : $m+$tmpMonth - $b_month);<br> $tmpYear = ($b_month > $m + $tmpMonth ? -1 : 0);<br> if ($b_year > $y + $tmpYear)<br> {<br> $year = 0; $month = 0; $day = 0;<br> }<br> else<br> {<br> $year = $y + $tmpYear - $b_year;<br> }<br> return array ($day,$month,$year);<br>}<br>$age = Full_age("29","06","1986");<br>echo "Вам $age[2] лет, $age[1] месяцев и $age[0] дней";<br>?><br> |
Когда функция возвращает
несколько значений для их обработки в программе, удобно использовать
языковую конструкцию list(),
которая позволяет одним действием присвоить значения сразу нескольким
переменным. Например, в предыдущем примере, оставив без изменения
функцию, обработать возвращаемые ей значения можно было так:
<?<br>// задание функции Full_age()<br>list($day,$month,$year) = Full_age("07","08","1974");<br>echo "Вам $year лет, $month месяцев и $day дней";<br>?><br> |
Вообще конструкцию list()
можно использовать для
присвоения переменным значений элементов любого массива.
<?<br>$arr = array("first","second");<br>list($a,$b) = $arr; // переменной $a присваивается первое значение массива, $b – второе<br>echo $a," ",$b; // выведет строку «first second»<br>?><br> |
Возвращение ссылки
В
результате своей работы функция также может возвращать ссылку на
какую-либо переменную. Это может пригодиться, если требуется
использовать функцию для того, чтобы определить, какой переменной
должна быть присвоена ссылка. Чтобы получить из функции ссылку, нужно
при объявлении перед ее именем написать знак амперсанд (&)
и каждый раз при
вызове функции перед ее именем тоже писать амперсанд (&).
Обычно функция
возвращает ссылку на какую-либо глобальную
переменную (или ее часть – ссылку на элемент
глобального массива), ссылку на статическую
переменную (или ее часть) или ссылку на один из
аргументов, если он был также передан по ссылке.
<?<br>$a = 3; $b = 2;<br>function & ref($par){<br>global $a, $b;<br> if ($par % 2 == 0) return $b;<br> else return $a;<br>}<br>$var =& ref(4);<br>echo $var, " и ", $b,"<br>"; //выведет 2 и 2<br>$b = 10;<br>echo $var, " и ", $b,"<br>"; // выведет 10 и 10<br>?><br><br> |
При использовании синтаксиса
ссылок в переменную $var
нашего примера не копируется значение переменной $b
возвращенной функцией $ref, а создается ссылка на
эту переменную. То есть теперь переменные $var
и $b идентичны и
будут изменяться одновременно.
Переменные функции
PHP поддерживает концепцию переменных
функций.
Это значит, что если имя переменной заканчивается круглыми скобками, то
PHP ищет функцию с таким же именем и пытается ее выполнить.
<?<br>/* создадим две простые функции: <br>Add_sign – добавляет подпись к строке и<br>Show_text – выводит строку текста */<br><br>function Add_sign($string, $sign="С уважением, Петр")<br>{<br> echo $string ." ".$sign;<br>}<br>function Show_text(){<br> echo "Отправить сообщение по почте<br>";<br>}<br>$func = "Show_text"; <br> // создаем переменную со значением, равным имени функции Show_text<br>$func(); <br> // это вызовет функцию Show_text<br>$func = "Add_sign"; <br> // создаем переменную со значением, равным имени функции Add_sign<br>$func("Привет всем <br>"); <br> // это вызовет функцию Add_sign с параметром "Привет всем"<br>?><br><br> |
В этом примере функция Show_text
просто выводит
строку текста. Казалось бы, зачем для этого создавать отдельную
функцию, если существует специальная функция echo().
Дело в том, что такие функции, как echo(), print(),
unset(), include()
и т.п. нельзя
использовать в качестве переменных
функций. То есть если мы напишем:
<?<br>$func = "echo ";<br>$func("TEXT");<br>?><br> |
то интерпретатор выведет ошибку:
Fatal error: Call to undefined function: <br> echo() in<br>c:\users\nina\tasks\func\var_f.php on line 2<br> |
Поэтому для того, чтобы
использовать любую из перечисленных выше функций как переменную
функцию, нужно
создать собственную функцию, что мы и сделали в предыдущем примере.
Внутренние (встроенные) функции
Говоря о функциях, определяемых
пользователем, все же нельзя не сказать пару слов о встроенных
функциях. С
некоторыми из встроенных функций,
такими как echo(), print(), date(),
include(), мы уже
познакомились. На самом деле все перечисленные функции, кроме date(),
являются языковыми
конструкциями. Они входят в ядро PHP и не требуют никаких
дополнительных настроек и модулей. Функция date()
тоже входит в состав ядра PHP и не требует настроек. Но есть и функции,
для работы с которыми нужно установить различные библиотеки и
подключить соответствующий модуль. Например, для использования функций
работы с базой данных MySql
следует
скомпилировать PHP с поддержкой этого расширения. В последнее время
наиболее распространенные расширения и соответственно их функции
изначально включают в состав PHP так, чтобы с ними можно работать без
каких бы то ни было дополнительных настроек интерпретатора.
Решение задачи
Напомним,
в чем состоит задача. Мы хотим написать интерфейс, который позволял бы
создавать html-формы. Пользователь выбирает, какие элементы и в каком
количестве нужно создать, придумывает им названия, а наша программа
сама генерирует требуемую форму.
Разобьем
задачу на несколько подзадач: выбор типов элементов ввода и их
количества, создание названий элементов ввода и обработка полученных
данных, т.е. непосредственно генерация формы. Первая задача достаточно
проста: нужно написать соответствующую форму, например подобную
приведенной ниже (task_form.html):
<form action="ask_names.php"><br>Создать элемент "строка ввода текста": <input type=checkbox name=types[] value=string><br><br>Количество элементов: <input type=text name=numbers[string] size=3><br><br><br><br><br>Создать элемент "текстовая область": <input type=checkbox name=types[] value=text><br><br>Количество элементов: <input type=text name=numbers[text] size=3><br><br><input type=submit value="Создать"><br></form><br><br> |
Когда мы пишем в имени элемента
формы, например types[],
это значит, что его имя – следующий элемент массива types.
То есть у нас первый
элемент формы («строка ввода текста»)
будет иметь имя types[0],
а второй (текстовая область) – types[1].
В браузере task_form.html
будет выглядеть примерно так:
Рис. 1. Форма для выбора
создаваемых элементов и их количества
После
отправки данных этой формы мы получим информацию о том, какие элементы
и сколько элементов каждого типа нужно создать. Следующий скрипт
запрашивает названия для этих элементов:
<?<br>$file = "task.php"; <br>/* файл, который будет обрабатывать<br>сгенерированную этим скриптом форму */<br><br>function Ask_names(){ // функция генерирует форму для ввода названий элементов ввода<br><br>global $file; //объявляем, что хотим использовать эту переменную, заданную вне функции<br>if (isset($_GET["types"])){<br> $st = '<form action="'.$file.'">';<br> foreach ($_GET["types"] as $k => $type){ // перебираем все типы элементов, которые нужно создать<br> <br> $num = $_GET["numbers"][$type]; // сколько элементов каждого типа нужно<br> for ($i=1;$i<=$num;$i++){ // создаем $num строк для ввода<br> $st.= "Введите имя $i-го элемента типа $type: ";<br> $st.= "<input type=text name=names[$type][]><br>";<br> }<br> // сохраняем тип и число необходимых элементов ввода этого типа<br> $st.= "<input type=hidden name=types[] value=$type>";<br> $st.= "<input type=hidden name=numbers[] value=$num><br>";<br>}<br> $st .= "<input type=submit name=send value=send></form>";<br>return $st; // в переменной $st содержится код формы для запроса имен<br>} else echo "Select type";<br>}<br>echo Ask_names(); // вызываем функцию и выводим результаты ее работы<br>?><br><br> |
Допустим,
нужно создать два элемента типа «текстовая строка»
и один элемент типа
«текстовая область», как и отмечено в форме выше.
Тогда скрипт ask_names.php
обработает ее таким образом, что мы получим такую форму:
Рис. 2. Форма для ввода
названий создаваемых элементов
Введем в эту форму, например,
строки «Название», «Автор» и
«Краткое содержание». Эти данные будет обрабатывать
скрипт task.php.
<?<br>$show_file = "task_show.php"; // файл, который будет обрабатывать данные созданной этим файлом формы<br><br>function Create_element($type,$name){ // функция создает элемент ввода по типу и названию<br> $str="";<br> switch($type){<br> case "string":<br> $str .= "$name: <input type=text name=string[]><br>";<br> break;<br> case "text":<br> $str .= "$name: <textarea name=text[]></textarea><br>";<br> break;<br> }<br>return $str;<br>}<br>function Create_form(){ // функция создает форму с нужными элементами<br>global $show_file;<br> $str = '<form action="'.$show_file.'">';<br> foreach ($_GET["types"] as $k => $type){ // перебираем типы элементов<br> $num = $_GET["numbers"][$k]; // число элементов этого типа<br> for ($i=1;$i<=$num;$i++){<br> $arr = $_GET["names"][$type][$i-1]; // имя создаваемого элемента<br> $str .= Create_element($type,$arr); // вызываем функцию для создания элемента<br> }<br> }<br> $str .= "<input type=submit value=send></form>";<br>echo $str;<br>}<br>$crt = "Create_form";<br>$crt(); // вызываем функцию создания формы Create_form<br>?><br><br> |
Результатом работы этого
скрипта с входными данными, приведенными выше, будет следующая форма:
Рис. 3. Пример формы,
сгенерированной нашей программой
