PHP: Параметры функций

Функции могут не только возвращать значения, но и принимать их в виде параметров. С параметрами функций мы уже сталкивались:

<?php

// Принимает на вход один параметр любого типа
print_r('я параметр');
// Принимает на вход два числовых параметра:
// Первый — округляемое число
// Второй — число знаков после запятой, которые нужно оставить
round(10.1245, 3); // 10.125
// Принимает на вход три строковых параметра:
// Первый — что ищем
// Второй — на что меняем
// Третий — строка, в которой производим замену
str_replace('go', 'mo', 'google'); // 'moogle'

В этом уроке мы научимся создавать функции, которые принимают на вход параметры. Представим, что перед нами стоит задача – реализовать функцию getLastChar(). Она возвращает последний символ в строке, переданной на вход как параметр. Вот как будет выглядеть использование этой функции:

<?php

// Передача параметров напрямую без переменных
getLastChar('Hexlet'); // 't'
// Передача параметров через переменные
$name1 = 'Hexlet';
getLastChar($name1); // 't'
$name2 = 'Goo';
getLastChar($name2); // 'o'

Из описания и примеров кода мы можем сделать следующие выводы:

  • Нам нужно определить функцию getLastChar()
  • Функция должна принимать на вход один параметр строкового типа
  • Функция должна возвращать значение строкового типа

Определение функции:

<?php

function getLastChar($str)
{
    // Вычисляем индекс последнего символа как длина строки - 1
    return $str[strlen($str) - 1];
}

Разберем его. В скобках указывается имя параметра ($str). Так как внутри функции мы не знаем, с каким конкретно значением идет работа, то параметры всегда описываются как переменные.

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

Этот параметр является обязательным. Если попробовать вызвать функцию без него, то интерпретатор выдаст ошибку:

getLastChar(); // такой код не имеет смысла
ArgumentCountError: Too few arguments to function getLastChar(), 0 passed

Так же можно указывать два, три и более параметров. Они отделяются запятыми:

<?php

// Функция по нахождению среднего числа
function average($x, $y)
{
    return ($x + $y) / 2;
}
average(1, 5); // 3
average(1, 2); // 1.5

Задание

Реализуйте функцию truncate(), которая обрезает переданную в функцию строку до указанного количества символов, добавляет в конце троеточие и возвращает получившуюся строку. Подобная логика часто используется на сайтах, чтобы отобразить длинный текст в сокращенном виде. Функция принимает два параметра:

  1. Строка, которую нужно обрезать
  2. Число символов, которые нужно оставить
<?php

// Передаём текст напрямую
// Обрезаем текст, оставляя 2 символа
truncate('hexlet', 2)  // 'he...'

// Через переменную
$text = 'it works!'
// Обрезаем текст, оставляя 4 символа
$result = truncate($text, 4);
print_r($result); // => 'it w...'

Реализовать эту функцию можно различными способами, подскажем лишь один из них. Для решения этим способом вам понадобится взять подстроку из строки, переданной первым параметром в функцию truncate(). Используйте для этого функцию substr(). Подумайте, исходя из задания, с какого индекса и какой длины вам надо извлечь подстроку?

<?php

$word = 'welcome';
// Передавать параметры в функцию можно через переменные
$length = 3;
substr($word, 0, $length); // 'wel'

С точки зрения проверочной системы не имеет значения, каким из способов будет реализована функция truncate() внутри, главное – чтобы она выполняла поставленную задачу

Как с вами связаться? 🙃

Команда проекта находится в телеграм-сообществе по ссылке https://ttttt.me/HexletLearningBot. Там можно задать любой вопрос и повлиять на проект

Упражнение не проходит проверку — что делать? 😶

Если вы зашли в тупик, то самое время поговорить с нашим асситентом Тота во вкладке "Обсуждение". Как правильно задать вопрос:

В моей среде код работает, а здесь нет 🤨

Тесты устроены таким образом, что они проверяют решение разными способами и на разных данных. Часто решение работает с одними входными данными, но не работает с другими. Чтобы разобраться с этим моментом, изучите вкладку «Тесты» и внимательно посмотрите на вывод ошибок, в котором есть подсказки.

Мой код отличается от решения учителя 🤔

Это нормально 🙆, в программировании одну задачу можно выполнить множеством способов. Если ваш код прошел проверку, то он соответствует условиям задачи. В редких случаях бывает, что решение подогнано под тесты, но это видно сразу.

Прочитал урок — ничего не понятно 🙄

Создавать обучающие материалы, понятные для всех без исключения, довольно сложно. Мы очень стараемся, но всегда есть что улучшать. Если вы встретили материал, который вам непонятен, опишите проблему в обратной связи нашего сообщества

Нашли ошибку? Есть что добавить? Пулреквесты приветствуются

Привет! Я Тота и моя задача помочь в обучении. Чтобы активировать меня, нужно зарегистрироваться или залогиниться, если у вас уже есть аккаунт

Loading...

Ваше упражнение проверяется по этим тестам

1<?php
2
3namespace HexletBasics\DefineFunctions\Parameters;
4
5use PHPUnit\Framework\TestCase;
6
7class SolutionTest extends TestCase
8{
9    public function test()
10    {
11        require 'index.php';
12
13        $this->assertEquals('Hex...', truncate('Hexlet', 3));
14        $this->assertEquals('Hello...', truncate('Hello world', 5));
15    }
16}
17

Решение учителя откроется через:

20:00
waiting_clock