Что получим
Размер в байтах — словами, как показывает проводник:
# sizes.py
def human_size(n):
"""Размер в байтах — словами: 4.4 ГБ, 512.0 КБ."""
if n >= 1024 ** 3:
return f"{n / 1024 ** 3:.1f} ГБ"
if n >= 1024 ** 2:
return f"{n / 1024 ** 2:.1f} МБ"
if n >= 1024:
return f"{n / 1024:.1f} КБ"
return f"{n} Б"
print(human_size(4_700_000_000))
print(human_size(524_288))
print(human_size(812))
print(human_size(1_000_000_000_000))
python sizes.py
# 4.4 ГБ
# 512.0 КБ
# 812 Б
# 931.3 ГБ
Четыре вызова — одна логика. Считаем в 1024, как Windows, поэтому диск на 1 ТБ — снова 931.3 ГБ, как
в «Числа». return сразу отдаёт ответ и выходит из функции: до следующих if дело не доходит,
поэтому elif здесь не нужен.
Как устроено: def, вызов, return
def human_size(n): # def, имя, параметры в скобках, двоеточие
"""Описание.""" # строка-описание: её показывают help() и подсказка редактора
... # тело — с отступом
return результат # что отдать тому, кто вызвал
def только заводит функцию — код внутри не выполняется, пока её не вызовут: human_size(812). При вызове
значение 812 приходит в параметр n, тело выполняется, return отдаёт результат на место вызова.
Поэтому вызов можно писать везде, где годится значение: в print, в f-строке, в другом расчёте.
help(human_size) в интерактивном режиме печатает описание из тройных кавычек — так же устроена справка
по всем функциям Python.
Аргументы: по порядку, по имени, по умолчанию
def download_time(size_gb, speed_mbit=100):
"""Минуты на загрузку; тариф по умолчанию — 100 Мбит/с."""
return size_gb * 1000 * 8 / speed_mbit / 60
print(f"{download_time(4.7):.1f}") # 6.3 — тариф по умолчанию
print(f"{download_time(4.7, 500):.1f}") # 1.3
print(f"{download_time(speed_mbit=50, size_gb=4.7):.1f}") # 12.5 — по имени, порядок не важен
Это расчёт из «Переменные и типы», теперь — функцией. Параметр с = необязательный: не передали — берётся
значение по умолчанию. Такие параметры идут после обязательных, иначе SyntaxError: parameter without a default follows parameter with a default. По имени вызов длиннее, но читается без заглядывания в def.
Своё и чужое: имена внутри функции
Имена, которые функция заводит у себя, — параметры и всё, что присвоено внутри, — живут только до конца
вызова и снаружи не видны. Читать имена снаружи функция может, а менять — нет: присваивание внутри создаёт
своё имя, отсюда UnboundLocalError в «Если не работает». Поэтому данные передаём аргументами, а результат
возвращаем через return — тогда функцию видно целиком из её строки def.
Подсказки типов — по желанию: def area(w: int, h: int) -> int:. Python их не проверяет — area("3", 4)
вернёт "3333", строку повторит четыре раза. Ловят такое редактор и программа mypy.
Доработать самим
uptime_text: секунды — в «14 д 6 ч 56 мин»Расчёт из главы «Числа» — внутрь функции, ответ — f-строкой через return.
def uptime_text(seconds):
days = seconds // 86400
hours = seconds % 86400 // 3600
minutes = seconds % 3600 // 60
return f"{days} д {hours} ч {minutes} мин"
print(uptime_text(1_234_567))
# 14 д 6 ч 56 минis_strong: годится ли пароль — True или FalseУсловие из главы «Условия» можно вернуть как есть: сравнение уже даёт True или False, if не нужен.
def is_strong(password):
return len(password) >= 12 and not password.isdigit()
print(is_strong("123456789012")) # False — одни цифры
print(is_strong("correct-horse")) # Truehuman_size в десятичных единицах — по желанию, параметромПараметр binary=True по умолчанию; основание — 1024 или 1000 — выбираем в одну строку и дальше считаем от него.
def human_size(n, binary=True):
base = 1024 if binary else 1000
if n >= base ** 3:
return f"{n / base ** 3:.1f} ГБ"
if n >= base ** 2:
return f"{n / base ** 2:.1f} МБ"
if n >= base:
return f"{n / base:.1f} КБ"
return f"{n} Б"
print(human_size(1_000_000_000_000)) # 931.3 ГБ
print(human_size(1_000_000_000_000, binary=False)) # 1000.0 ГБЕсли не работает
NameError: name 'human_size' is not defined
- Причина
- Функцию вызвали выше по файлу, чем её
def: Python выполняет файл сверху вниз и доdefо ней не знает. - Делаем
- Все
def— в начале файла, вызовы — ниже.
TypeError: human_size() missing 1 required positional argument: 'n'
- Причина
- Вызвали без аргумента, а у параметра нет значения по умолчанию.
- Делаем
- Передаём значение —
human_size(812)— или задаём умолчание вdef:def download_time(size_gb, speed_mbit=100):.
TypeError: human_size() takes 1 positional argument but 2 were given
- Причина
- Передали больше значений, чем параметров в
def. - Делаем
- Сверяем вызов с
def; лишнее убираем или добавляем параметр.
TypeError: unsupported operand type(s) for +: 'NoneType' and 'int'
- Причина
- Функция считает, но не возвращает: нет
return, или вместо негоprint. Безreturnфункция отдаётNone. - Делаем
- Последней строкой функции —
return результат.
UnboundLocalError: cannot access local variable 'count' where it is not associated with a value
- Причина
- Внутри функции меняем имя, заведённое снаружи:
count += 1. Присваивание делает имя внутренним, а внутреннего значения ещё нет. - Делаем
- Передаём значение аргументом и возвращаем новое:
count = add(count). Естьglobal count, но так функции начинают зависеть друг от друга незаметно.