sorting.md
1> **Источник:** https://python-all.ru/3.12/howto/sorting.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Методы сортировки89**Автор:**1011Andrew Dalke and Raymond Hettinger1213Встроенный метод [`list.sort()`](https://python-all.ru/3.12/library/stdtypes.html#list.sort) изменяет список на месте. Также есть встроенная функция [`sorted()`](https://python-all.ru/3.12/library/functions.html#sorted), которая создаёт новый отсортированный список из итерируемого объекта.1415В этом документе рассматриваются различные методы сортировки данных с помощью Python.1617## Основы сортировки1819Простая сортировка по возрастанию выполняется очень легко: достаточно вызвать функцию [`sorted()`](https://python-all.ru/3.12/library/functions.html#sorted). Она возвращает новый отсортированный список:2021```pycon22>>> sorted([5, 2, 3, 1, 4])23[1, 2, 3, 4, 5]24```2526Также можно использовать метод [`list.sort()`](https://python-all.ru/3.12/library/stdtypes.html#list.sort). Он изменяет список на месте (и возвращает `None`, чтобы избежать путаницы). Обычно он менее удобен, чем [`sorted()`](https://python-all.ru/3.12/library/functions.html#sorted), но если исходный список не нужен, он немного эффективнее.2728```pycon29>>> a = [5, 2, 3, 1, 4]30>>> a.sort()31>>> a32[1, 2, 3, 4, 5]33```3435Ещё одно различие: метод [`list.sort()`](https://python-all.ru/3.12/library/stdtypes.html#list.sort) определён только для списков. В то время как функция [`sorted()`](https://python-all.ru/3.12/library/functions.html#sorted) принимает любой итерируемый объект.3637```pycon38>>> sorted({1: 'D', 2: 'B', 3: 'B', 4: 'E', 5: 'A'})39[1, 2, 3, 4, 5]40```4142## Ключевые функции4344И [`list.sort()`](https://python-all.ru/3.12/library/stdtypes.html#list.sort), и [`sorted()`](https://python-all.ru/3.12/library/functions.html#sorted) имеют параметр *key*, который задаёт функцию (или другой вызываемый объект), вызываемую для каждого элемента списка перед сравнением.4546Например, вот сравнение строк без учёта регистра:4748```pycon49>>> sorted("This is a test string from Andrew".split(), key=str.casefold)50['a', 'Andrew', 'from', 'is', 'string', 'test', 'This']51```5253Значением параметра *key* должна быть функция (или другой вызываемый объект), принимающая один аргумент и возвращающая ключ для сортировки. Этот метод быстр, поскольку ключевая функция вызывается ровно один раз для каждой входной записи.5455Часто используется сортировка сложных объектов по некоторым их индексам. Например:5657```pycon58>>> student_tuples = [59... ('john', 'A', 15),60... ('jane', 'B', 12),61... ('dave', 'B', 10),62... ]63>>> sorted(student_tuples, key=lambda student: student[2]) # сортировка по возрасту64[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]65```6667Тот же подход работает для объектов с именованными атрибутами. Например:6869```pycon70>>> class Student:71... def __init__(self, name, grade, age):72... self.name = name73... self.grade = grade74... self.age = age75... def __repr__(self):76... return repr((self.name, self.grade, self.age))7778>>> student_objects = [79... Student('john', 'A', 15),80... Student('jane', 'B', 12),81... Student('dave', 'B', 10),82... ]83>>> sorted(student_objects, key=lambda student: student.age) # сортировка по возрасту84[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]85```8687Объекты с именованными атрибутами можно создать с помощью обычного класса, как показано выше, или они могут быть экземплярами [`dataclass`](https://python-all.ru/3.12/library/dataclasses.html#dataclasses.dataclass) или [именованного кортежа](https://python-all.ru/3.12/glossary.html#term-named-tuple).8889## Функции модуля operator и частичное вычисление функций9091Шаблоны [ключевых функций](https://python-all.ru/3.12/glossary.html#term-key-function), показанные выше, очень распространены, поэтому Python предоставляет удобные функции для упрощения и ускорения функций доступа. В модуле [`operator`](https://python-all.ru/3.12/library/operator.html#module-operator) есть [`itemgetter()`](https://python-all.ru/3.12/library/operator.html#operator.itemgetter), [`attrgetter()`](https://python-all.ru/3.12/library/operator.html#operator.attrgetter) и функция [`methodcaller()`](https://python-all.ru/3.12/library/operator.html#operator.methodcaller).9293Использование этих функций делает приведённые выше примеры проще и быстрее:9495```pycon96>>> from operator import itemgetter, attrgetter9798>>> sorted(student_tuples, key=itemgetter(2))99[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]100101>>> sorted(student_objects, key=attrgetter('age'))102[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]103```104105Функции модуля operator позволяют выполнять многоуровневую сортировку. Например, сортировка сначала по *оценке*, а затем по *возрасту*:106107```pycon108>>> sorted(student_tuples, key=itemgetter(1,2))109[('john', 'A', 15), ('dave', 'B', 10), ('jane', 'B', 12)]110111>>> sorted(student_objects, key=attrgetter('grade', 'age'))112[('john', 'A', 15), ('dave', 'B', 10), ('jane', 'B', 12)]113```114115Модуль [`functools`](https://python-all.ru/3.12/library/functools.html#module-functools) предоставляет ещё один полезный инструмент для создания ключевых функций. Функция [`partial()`](https://python-all.ru/3.12/library/functools.html#functools.partial) может уменьшить [арность](https://python-all.ru/3.12/howto/sorting.html) функции с несколькими аргументами, делая её пригодной для использования в качестве ключевой функции.116117```pycon118>>> from functools import partial119>>> from unicodedata import normalize120121>>> names = 'Zoë Åbjørn Núñez Élana Zeke Abe Nubia Eloise'.split()122123>>> sorted(names, key=partial(normalize, 'NFD'))124['Abe', 'Åbjørn', 'Eloise', 'Élana', 'Nubia', 'Núñez', 'Zeke', 'Zoë']125126>>> sorted(names, key=partial(normalize, 'NFC'))127['Abe', 'Eloise', 'Nubia', 'Núñez', 'Zeke', 'Zoë', 'Åbjørn', 'Élana']128```129130## По возрастанию и по убыванию131132Обе функции [`list.sort()`](https://python-all.ru/3.12/library/stdtypes.html#list.sort) и [`sorted()`](https://python-all.ru/3.12/library/functions.html#sorted) принимают параметр *reverse* с булевым значением. Он используется для указания сортировки по убыванию. Например, чтобы получить данные о студентах в обратном порядке по *возрасту*:133134```pycon135>>> sorted(student_tuples, key=itemgetter(2), reverse=True)136[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]137138>>> sorted(student_objects, key=attrgetter('age'), reverse=True)139[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]140```141142## Стабильность сортировки и сложные сортировки143144Сортировки гарантированно являются [стабильными](https://python-all.ru/3.12/howto/sorting.html). Это означает, что когда несколько записей имеют один и тот же ключ, их исходный порядок сохраняется.145146```pycon147>>> data = [('red', 1), ('blue', 1), ('red', 2), ('blue', 2)]148>>> sorted(data, key=itemgetter(0))149[('blue', 1), ('blue', 2), ('red', 1), ('red', 2)]150```151152Обратите внимание, как две записи для *синего* сохраняют исходный порядок, так что `('blue', 1)` гарантированно предшествует `('blue', 2)`.153154Это замечательное свойство позволяет строить сложные сортировки в несколько этапов. Например, чтобы отсортировать данные о студентах сначала по убыванию *оценки*, а затем по возрастанию *возраста*, выполните сортировку по *возрасту* сначала, а затем снова отсортируйте по *оценке*:155156```pycon157>>> s = sorted(student_objects, key=attrgetter('age')) # сортировка по вторичному ключу158>>> sorted(s, key=attrgetter('grade'), reverse=True) # теперь сортировка по первичному ключу, по убыванию159[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]160```161162Это можно обобщить в функцию-обёртку, которая принимает список и кортежи из поля и порядка сортировки, чтобы выполнять сортировку в несколько проходов.163164```pycon165>>> def multisort(xs, specs):166... for key, reverse in reversed(specs):167... xs.sort(key=attrgetter(key), reverse=reverse)168... return xs169170>>> multisort(list(student_objects), (('grade', True), ('age', False)))171[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]172```173174Алгоритм [Timsort](https://python-all.ru/3.12/howto/sorting.html), используемый в Python, эффективно выполняет множественные сортировки, поскольку может использовать преимущества любого порядка, уже присутствующего в наборе данных.175176## Декорирование-сортировка-восстановление177178Эта идиома называется Decorate-Sort-Undecorate по трём её шагам:179180- Сначала исходный список украшается новыми значениями, которые управляют порядком сортировки.181- Затем украшенный список сортируется.182- Наконец, украшения удаляются, создавая список, содержащий только исходные значения в новом порядке.183184Например, чтобы отсортировать данные о студентах по *оценке* с помощью подхода DSU:185186```pycon187>>> decorated = [(student.grade, i, student) for i, student in enumerate(student_objects)]188>>> decorated.sort()189>>> [student for grade, i, student in decorated] # обратное преобразование190[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]191```192193Эта идиома работает, потому что кортежи сравниваются лексикографически: сравниваются первые элементы; если они одинаковы, то сравниваются вторые, и так далее.194195Не всегда строго необходимо включать индекс *i* в украшенный список, но его включение даёт два преимущества:196197- Сортировка стабильна – если два элемента имеют один и тот же ключ, их порядок сохранится в отсортированном списке.198- Исходные элементы не обязаны быть сравнимыми, поскольку порядок украшенных кортежей будет определяться максимум первыми двумя элементами. Так, например, исходный список может содержать комплексные числа, которые невозможно отсортировать напрямую.199200Другое название этой идиомы – [преобразование Шварца](https://python-all.ru/3.12/howto/sorting.html), по имени Рэндала Л. Шварца, который популяризировал её среди программистов на Perl.201202Теперь, когда сортировка в Python предоставляет ключевые функции, эта техника используется нечасто.203204## Функции сравнения205206В отличие от ключевых функций, которые возвращают абсолютное значение для сортировки, функция сравнения вычисляет относительный порядок для двух входных значений.207208Например, [чашечные весы](https://python-all.ru/3.12/howto/sorting.html) сравнивают два образца, давая относительное упорядочение: легче, равно или тяжелее. Аналогично, функция сравнения, такая как `cmp(a, b)`, вернёт отрицательное значение для «меньше», ноль, если входные значения равны, или положительное значение для «больше».209210Часто можно встретить функции сравнения при переводе алгоритмов с других языков. Кроме того, некоторые библиотеки предоставляют функции сравнения как часть своего API. Например, [`locale.strcoll()`](https://python-all.ru/3.12/library/locale.html#locale.strcoll) – это функция сравнения.211212Для таких случаев Python предоставляет [`functools.cmp_to_key`](https://python-all.ru/3.12/library/functools.html#functools.cmp_to_key) для обёртывания функции сравнения, чтобы сделать её пригодной для использования в качестве ключевой функции:213214```python215sorted(words, key=cmp_to_key(strcoll)) # порядок сортировки с учётом локали216```217218## Разное219220- Для сортировки с учётом локали используйте [`locale.strxfrm()`](https://python-all.ru/3.12/library/locale.html#locale.strxfrm) в качестве ключевой функции или [`locale.strcoll()`](https://python-all.ru/3.12/library/locale.html#locale.strcoll) в качестве функции сравнения. Это необходимо, потому что «алфавитный» порядок сортировки может различаться в разных культурах, даже если базовый алфавит один и тот же.221- Параметр *reverse* сохраняет стабильность сортировки (так что записи с равными ключами сохраняют исходный порядок). Интересно, что этот эффект можно имитировать без параметра, дважды применив встроенную функцию [`reversed()`](https://python-all.ru/3.12/library/functions.html#reversed):222223 ```pycon224 >>> data = [('red', 1), ('blue', 1), ('red', 2), ('blue', 2)]225 >>> standard_way = sorted(data, key=itemgetter(0), reverse=True)226 >>> double_reversed = list(reversed(sorted(reversed(data), key=itemgetter(0))))227 >>> assert standard_way == double_reversed228 >>> standard_way229 [('red', 1), ('red', 2), ('blue', 1), ('blue', 2)]230 ```231- Процедуры сортировки используют `<` при сравнении двух объектов. Поэтому легко добавить стандартный порядок сортировки в класс, определив метод [`__lt__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__lt__):232233 ```pycon234 >>> Student.__lt__ = lambda self, other: self.age < other.age235 >>> sorted(student_objects)236 [('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]237 ```238239 Однако учтите, что `<` может переключиться на [`__gt__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__gt__), если [`__lt__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__lt__) не реализована (см. [`object.__lt__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__lt__) о механике подробнее). Чтобы избежать неожиданностей, [**PEP 8**](https://python-all.ru/3.12/howto/sorting.html) рекомендует реализовать все шесть методов сравнения. Декоратор [`total_ordering()`](https://python-all.ru/3.12/library/functools.html#functools.total_ordering) упрощает эту задачу.240- Ключевые функции не обязаны напрямую зависеть от сортируемых объектов. Ключевая функция может также обращаться к внешним ресурсам. Например, если оценки студентов хранятся в словаре, их можно использовать для сортировки отдельного списка имён студентов:241242 ```pycon243 >>> students = ['dave', 'john', 'jane']244 >>> newgrades = {'john': 'F', 'jane':'A', 'dave': 'C'}245 >>> sorted(students, key=newgrades.__getitem__)246 ['jane', 'dave', 'john']247 ```248249## Частичная сортировка250251Некоторым приложениям требуется упорядочить только часть данных. Стандартная библиотека предоставляет несколько инструментов, которые выполняют меньшую работу, чем полная сортировка:252253- [`min()`](https://python-all.ru/3.12/library/functions.html#min) и [`max()`](https://python-all.ru/3.12/library/functions.html#max) возвращают наименьшее и наибольшее значения соответственно. Эти функции выполняют один проход по входным данным и почти не требуют дополнительной памяти.254- [`heapq.nsmallest()`](https://python-all.ru/3.12/library/heapq.html#heapq.nsmallest) и [`heapq.nlargest()`](https://python-all.ru/3.12/library/heapq.html#heapq.nlargest) возвращают *n* наименьших и наибольших значений соответственно. Эти функции выполняют один проход по данным, храня в памяти только *n* элементов одновременно. Для значений *n*, малых по сравнению с количеством входных данных, эти функции выполняют гораздо меньше сравнений, чем полная сортировка.255- [`heapq.heappush()`](https://python-all.ru/3.12/library/heapq.html#heapq.heappush) и [`heapq.heappop()`](https://python-all.ru/3.12/library/heapq.html#heapq.heappop) создают и поддерживают частично упорядоченное расположение данных, при котором наименьший элемент находится на позиции `0`. Эти функции подходят для реализации очередей с приоритетом, часто используемых в планировании задач.256