Что делает функция abs в Python?

Функция abs в Python возвращает абсолютное значение числа. Таким образом результат всегда положительный. На вход функция принимает:

• целые числа;
• числа с плавающей точкой;
• комплексные числа.

Пример работы функции:

abs(-20) # => 20
abs(-20.5) # => 20.5
abs(3 + 4j) # => 5.0

Если в случае с целыми числами и числами с плавающей точкой при возврате функция сохраняет тип переданного числа, то в случае с комплексными числами тип меняется на число с плавающей точкой.

результат всегда положительный

неотрицательный

abs(x) возвращает модуль числа — его значение без знака минус. Результат всегда неотрицательный.

print(abs(-7))   # => 7
print(abs(3.5))  # => 3.5
print(abs(0))    # => 0

Импортировать ничего не нужно: abs() встроена в Python.

С какими числами работает

Тип результата совпадает с типом аргумента. Исключение — комплексные числа: для них abs() возвращает float.

Где abs нужен на практике

Расстояние между двумя числами:

a, b = 12, 30
print(abs(a - b))  # => 18

Сравнение дробных чисел с допуском:

x = 0.1 + 0.2
print(x == 0.3)              # => False
print(abs(x - 0.3) < 1e-9)   # => True

Для той же задачи есть готовая функция math.isclose(x, 0.3).

Сортировка и поиск по модулю:

nums = [-5, 3, -1]
print(sorted(nums, key=abs))  # => [-1, 3, -5]
print(min(nums, key=abs))     # => -1 — число, ближайшее к нулю

abs и math.fabs

math.fabs() всегда возвращает float и не принимает комплексные числа:

import math
print(abs(-7))        # => 7
print(math.fabs(-7))  # => 7.0

Если тип результата не важен, используйте abs().

Частые ошибки

abs("-5")
# TypeError: bad operand type for abs(): 'str'

input() возвращает строку. Сначала приведите её к числу: abs(int(input())).

abs() не меняет переменную. Результат нужно сохранить: x = abs(x).

Как это работает внутри

abs(x) вызывает у объекта метод __abs__. Его можно определить в своём классе:

class Vector:
    def __init__(self, x, y):
        self.x, self.y = x, y

    def __abs__(self):
        return (self.x ** 2 + self.y ** 2) ** 0.5

print(abs(Vector(3, 4)))  # => 5.0

Встроенные функции Python разбирают в бесплатном курсе «Основы Python», магические методы — на курсе «ООП на Python».