basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Функции в Python: def, аргументы и return

    Функция — кусок кода с именем: написали один раз, вызываем сколько угодно с разными значениями. def её заводит, аргументы передают данные внутрь, return отдаёт результат наружу. Пишем human_size — байты словами, как в проводнике: 4.4 ГБ, 512.0 КБ — и разбираем, почему функция без return молча отдаёт None.

    Новое здесьФункция: def и return

    Что получим

    Размер в байтах — словами, как показывает проводник:

    # 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 double(x):
        print(x * 2)
    
    result = double(5)
    print(result)
    Что напечатает?
    Ответ:
    10
    None

    double печатает 10, но ничего не возвращает: нет return. Функция без return отдаёт None, его и кладём в result. print показывает на экране, return отдаёт значение коду.

    Как устроено: 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"))   # True
    human_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, но так функции начинают зависеть друг от друга незаметно.

    В главе ещё