Сигнатура функции

Функция pow, возводящая число в какую-нибудь степень, принимает два параметра: какое число возводить и в какую степень возводить. Если вызывать pow без параметров, то PHP выдаст следующее: PHP Warning: pow() expects exactly 2 parameters, 0 given in php shell code on line 1. Интерпретатор сообщает, что функция ожидает 2 параметра, а вы вызвали её без параметров.

Тот, кто создавал функцию pow, сделал её функцией с двумя обязательными параметрами, поэтому её невозможно вызвать с другим числом параметров.

Более того, параметрами pow могут быть только числа. Попытка передать в нее, например, строку, приведет к следующей ошибке: PHP Warning: A non-numeric value encountered in php shell code on line 1. Результат вызова функции — тоже всегда число.

Другая функция может иметь другое число параметров и другие типы параметров. Например, может существовать функция, которая принимает три параметра: число, строку и еще одно число.

Откуда мы знаем, сколько каких параметров нужно функции pow и какого типа будет «возврат»? Мы заглянули в сигнатуру этой функции. Сигнатура определяет входные параметры и их типы, а так же выходной параметр и его тип. Про функцию pow можно почитать в официальной документации PHP. В разделе «описание» там есть такой текст:

number pow ( number $base , number $exp )

Возвращает base, возведенное в степень exp.

Это сигнатура функции и короткое пояснение на русском языке.

Информация расшифровывается так:

  • функция возвращает число (number)
  • функция называется pow
  • функция принимает два параметра: число (base) и число (exp)
  • функция возвращает base, возведенное в степень exp

Передавать параметры можно только в той последовательности, в которой они определены в сигнатуре.

Любая функция возвращает всегда только одно значение. Ограничение существует на уровне языка и не может быть нарушено.

Задание

Теперь ваша очередь посмотреть на сигнатуру функции в документации и разобраться, как её использовать. Можете читать документацию на русском языке, но программист обязан уметь читать документацию на английском. Используйте словари или переводчики по необходимости. Лучше сразу привыкать и подтягивать навыки чтения на английском, иначе будут сложности в будущем.

В PHP есть функция ucfirst. Изучите её сигнатуру на странице http://php.net/manual/ru/function.ucfirst.php.

Напишите программу, которая использует функцию ucfirst с переменной $text, и выводит результат на экран.


Определения
  • Сигнатура функции — формальное описание типов аргументов и типа возвращаемого значения функции.

Exercise available only for signed users