Чтение документации

Умение читать документацию — один из важнейших навыков любого разработчика.

Несмотря на наличие перевода, я рекомендую учиться пользоваться англоязычной документацией. Библиотеки, которые сотнями используются в реальных проектах, почти всегда имеют только англоязычное описание.

Основной раздел, к которому программисты возвращаются постоянно — справочник функций языка. Во-первых, этих функций много и невозможно запомнить все. Во-вторых, в PHP особенно остро стоит проблема несогласованности параметров и возвращаемых значений функций. Поэтому постоянно приходится вспоминать их порядок.

Для описания функций используется собственная нотация (свой собственный синтаксис). Она немного напоминает сам PHP, но все же отличается от него, другими словами, это не код на PHP, а только лишь описание сигнатуры функции. Рассмотрим функцию round(), которая округляет число:

round ( float $val [, int $precision = 0 [, int $mode = PHP_ROUND_HALF_UP ]] ) : float

Задача этого формата — наглядно показать типы, количество и значения по умолчанию входящих параметров, а также тип выходного параметра. Последний всегда стоит в самой правой позиции, прямо после знака двоеточия. В данном случае тип возвращаемого значения float.

Перечисление параметров идет через запятую в скобках после названия функции. Перед каждым именем параметра стоит его тип. Например, тип параметра $val — это float. Значение по умолчанию задается как присваивание, например $precision по умолчанию равно нулю.

Квадратные скобки [] показывают необязательные параметры функции, а запятые отделяют их друг от друга. Для функции выше это $precision и $mode. $mode, в свою очередь, по умолчанию равен значению константы PHP_ROUND_HALF_UP. Если какой-либо параметр равен значению константы, значит в документации этой функции есть перечисление и описание всех возможных констант, которые могут быть использованы как значение этого параметра.

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

<?php

round(5.3); // 5.0
round(8.333, 1); // 8.3
round(8.333, 2, PHP_ROUND_HALF_UP); // 8.33

Задание

Реализуйте функцию getAge(), которая округляет возраст в нижнюю сторону. То есть если человеку десять с половиной лет, то функция должна вернуть 10.

Используйте для этого стандартную функцию round() и специальное значение параметра $mode, которое приводит к округлению в нижнюю сторону.

<?php

getAge(10);  // 10.0
getAge(9.1); // 9.0
getAge(8.5); // 8.0

Советы


Нашли ошибку? Есть что добавить? Пулреквесты приветствуются https://github.com/hexlet-basics
Если вы столкнулись с трудностями и не знаете, что делать, задайте вопрос в нашем большом и дружном cообществе
Упражнение доступно только авторизованным пользователям.

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