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

Умение читать документацию — один из важнейших навыков любого разработчика. Документация PHP доступна на русском языке по адресу http://php.net/manual/ru/

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

Основной раздел, к которому программисты возвращаются постоянно — справочник функций языка. Во-первых, этих функций много и невозможно запомнить все. Во-вторых, в 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
round(8.333, 1); // 8.3
round(8.333, 2, PHP_ROUND_HALF_UP); // 8.33

Задание

Реализуйте функцию getAge, которая округляет возраст так, что половина округляется в нижнюю сторону. То есть если человеку десять с половиной лет, то функция должна вернуть 10. Если ему хотя бы немного больше десяти с половиной, то округление идет в верхнюю сторону.

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

<?php

getAge(10); // 10
getAge(9.1); // 9
getAge(8.9); // 9
getAge(8.5); // 8

Нашли ошибку? Есть что добавить? Пулреквесты приветствуютсяhttps://github.com/hexlet-basics

Упражнение доступно только авторизованным пользователям.

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