functions.md

1> **Источник:** https://python-all.ru/3.10/library/functions.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Встроенные функции89Интерпретатор Python включает ряд встроенных функций и типов, которые доступны всегда. Они перечислены здесь в алфавитном порядке.1011| Встроенные функции |  |  |  |12| --- | --- | --- | --- |13| **A** [`abs()`](https://python-all.ru/3.10/library/functions.html#abs) [`aiter()`](https://python-all.ru/3.10/library/functions.html#aiter) [`all()`](https://python-all.ru/3.10/library/functions.html#all) [`any()`](https://python-all.ru/3.10/library/functions.html#any) [`anext()`](https://python-all.ru/3.10/library/functions.html#anext) [`ascii()`](https://python-all.ru/3.10/library/functions.html#ascii) **B** [`bin()`](https://python-all.ru/3.10/library/functions.html#bin) [`bool()`](https://python-all.ru/3.10/library/functions.html#bool) [`breakpoint()`](https://python-all.ru/3.10/library/functions.html#breakpoint) [`bytearray()`](https://python-all.ru/3.10/library/functions.html#func-bytearray) [`bytes()`](https://python-all.ru/3.10/library/functions.html#func-bytes) **C** [`callable()`](https://python-all.ru/3.10/library/functions.html#callable) [`chr()`](https://python-all.ru/3.10/library/functions.html#chr) [`classmethod()`](https://python-all.ru/3.10/library/functions.html#classmethod) [`compile()`](https://python-all.ru/3.10/library/functions.html#compile) [`complex()`](https://python-all.ru/3.10/library/functions.html#complex) **D** [`delattr()`](https://python-all.ru/3.10/library/functions.html#delattr) [`dict()`](https://python-all.ru/3.10/library/functions.html#func-dict) [`dir()`](https://python-all.ru/3.10/library/functions.html#dir) [`divmod()`](https://python-all.ru/3.10/library/functions.html#divmod) | **E** [`enumerate()`](https://python-all.ru/3.10/library/functions.html#enumerate) [`eval()`](https://python-all.ru/3.10/library/functions.html#eval) [`exec()`](https://python-all.ru/3.10/library/functions.html#exec) **F** [`filter()`](https://python-all.ru/3.10/library/functions.html#filter) [`float()`](https://python-all.ru/3.10/library/functions.html#float) [`format()`](https://python-all.ru/3.10/library/functions.html#format) [`frozenset()`](https://python-all.ru/3.10/library/functions.html#func-frozenset) **G** [`getattr()`](https://python-all.ru/3.10/library/functions.html#getattr) [`globals()`](https://python-all.ru/3.10/library/functions.html#globals) **H** [`hasattr()`](https://python-all.ru/3.10/library/functions.html#hasattr) [`hash()`](https://python-all.ru/3.10/library/functions.html#hash) [`help()`](https://python-all.ru/3.10/library/functions.html#help) [`hex()`](https://python-all.ru/3.10/library/functions.html#hex) **I** [`id()`](https://python-all.ru/3.10/library/functions.html#id) [`input()`](https://python-all.ru/3.10/library/functions.html#input) [`int()`](https://python-all.ru/3.10/library/functions.html#int) [`isinstance()`](https://python-all.ru/3.10/library/functions.html#isinstance) [`issubclass()`](https://python-all.ru/3.10/library/functions.html#issubclass) [`iter()`](https://python-all.ru/3.10/library/functions.html#iter) | **L** [`len()`](https://python-all.ru/3.10/library/functions.html#len) [`list()`](https://python-all.ru/3.10/library/functions.html#func-list) [`locals()`](https://python-all.ru/3.10/library/functions.html#locals) **M** [`map()`](https://python-all.ru/3.10/library/functions.html#map) [`max()`](https://python-all.ru/3.10/library/functions.html#max) [`memoryview()`](https://python-all.ru/3.10/library/functions.html#func-memoryview) [`min()`](https://python-all.ru/3.10/library/functions.html#min) **N** [`next()`](https://python-all.ru/3.10/library/functions.html#next) **O** [`object()`](https://python-all.ru/3.10/library/functions.html#object) [`oct()`](https://python-all.ru/3.10/library/functions.html#oct) [`open()`](https://python-all.ru/3.10/library/functions.html#open) [`ord()`](https://python-all.ru/3.10/library/functions.html#ord) **P** [`pow()`](https://python-all.ru/3.10/library/functions.html#pow) [`print()`](https://python-all.ru/3.10/library/functions.html#print) [`property()`](https://python-all.ru/3.10/library/functions.html#property) | **R** [`range()`](https://python-all.ru/3.10/library/functions.html#func-range) [`repr()`](https://python-all.ru/3.10/library/functions.html#repr) [`reversed()`](https://python-all.ru/3.10/library/functions.html#reversed) [`round()`](https://python-all.ru/3.10/library/functions.html#round) **S** [`set()`](https://python-all.ru/3.10/library/functions.html#func-set) [`setattr()`](https://python-all.ru/3.10/library/functions.html#setattr) [`slice()`](https://python-all.ru/3.10/library/functions.html#slice) [`sorted()`](https://python-all.ru/3.10/library/functions.html#sorted) [`staticmethod()`](https://python-all.ru/3.10/library/functions.html#staticmethod) [`str()`](https://python-all.ru/3.10/library/functions.html#func-str) [`sum()`](https://python-all.ru/3.10/library/functions.html#sum) [`super()`](https://python-all.ru/3.10/library/functions.html#super) **T** [`tuple()`](https://python-all.ru/3.10/library/functions.html#func-tuple) [`type()`](https://python-all.ru/3.10/library/functions.html#type) **V** [`vars()`](https://python-all.ru/3.10/library/functions.html#vars) **Z** [`zip()`](https://python-all.ru/3.10/library/functions.html#zip) **\_** [`__import__()`](https://python-all.ru/3.10/library/functions.html#import__) |1415#### `abs(x)`1617Возвращает абсолютное значение числа. Аргументом может быть целое число, число с плавающей запятой или объект, реализующий `__abs__()`. Если аргумент – комплексное число, возвращается его модуль.1819#### `aiter(async_iterable)`2021Возвращает [асинхронный итератор](https://python-all.ru/3.10/glossary.html#term-asynchronous-iterator) для [асинхронного итерируемого объекта](https://python-all.ru/3.10/glossary.html#term-asynchronous-iterable). Эквивалентно вызову `x.__aiter__()`.2223Примечание: в отличие от [`iter()`](https://python-all.ru/3.10/library/functions.html#iter), [`aiter()`](https://python-all.ru/3.10/library/functions.html#aiter) не имеет варианта с двумя аргументами.2425Новое в версии 3.10.2627#### `all(iterable)`2829Возвращает `True`, если все элементы *iterable* истинны (или если iterable пуст). Эквивалентно:3031```python32def all(iterable):33    for element in iterable:34        if not element:35            return False36    return True37```3839#### `awaitable anext(async_iterator[, default])`4041При ожидании возвращает следующий элемент из переданного [асинхронного итератора](https://python-all.ru/3.10/glossary.html#term-asynchronous-iterator) или *default*, если он указан и итератор исчерпан.4243Это асинхронный вариант встроенной функции [`next()`](https://python-all.ru/3.10/library/functions.html#next), который ведёт себя аналогично.4445Вызывает метод [`__anext__()`](https://python-all.ru/3.10/reference/datamodel.html#object.__anext__) объекта *async\_iterator*, возвращая [ожидаемый объект](https://python-all.ru/3.10/glossary.html#term-awaitable). Ожидание этого объекта возвращает следующее значение итератора. Если задан *default*, он возвращается в случае исчерпания итератора, иначе возбуждается [`StopAsyncIteration`](https://python-all.ru/3.10/library/exceptions.html#StopAsyncIteration).4647Новое в версии 3.10.4849#### `any(iterable)`5051Возвращает `True`, если хотя бы один элемент *iterable* истинен. Если iterable пуст, возвращает `False`. Эквивалентно:5253```python54def any(iterable):55    for element in iterable:56        if element:57            return True58    return False59```6061#### `ascii(object)`6263Как и [`repr()`](https://python-all.ru/3.10/library/functions.html#repr), возвращает строку, содержащую печатное представление объекта, но экранирует не-ASCII символы в строке, возвращаемой [`repr()`](https://python-all.ru/3.10/library/functions.html#repr), используя экранирование `\x`, `\u` или `\U`. Эта строка аналогична возвращаемой функцией [`repr()`](https://python-all.ru/3.10/library/functions.html#repr) в Python 2.6465#### `bin(x)`6667Преобразует целое число в двоичную строку с префиксом «0b». Результат является корректным выражением Python. Если *x* не является объектом Python [`int`](https://python-all.ru/3.10/library/functions.html#int), он должен определять метод `__index__()`, возвращающий целое число. Несколько примеров:6869```python70>>> bin(3)71'0b11'72>>> bin(-10)73'-0b1010'74```7576Если требуется префикс «0b» или нет, можно использовать один из следующих способов.7778```python79>>> format(14, '#b'), format(14, 'b')80('0b1110', '1110')81>>> f'{14:#b}', f'{14:b}'82('0b1110', '1110')83```8485См. также [`format()`](https://python-all.ru/3.10/library/functions.html#format) для получения дополнительной информации.8687#### `class bool([x])`8889Возвращает логическое значение, то есть `True` или `False`. *x* преобразуется по стандартной [процедуре проверки истинности](https://python-all.ru/3.10/library/stdtypes.html#truth). Если *x* ложно или не указано, возвращается `False`; в противном случае возвращается `True`. Класс [`bool`](https://python-all.ru/3.10/library/functions.html#bool) является подклассом [`int`](https://python-all.ru/3.10/library/functions.html#int) (см. [Числовые типы – int, float, complex](https://python-all.ru/3.10/library/stdtypes.html#typesnumeric)). От него нельзя наследовать. Его единственные экземпляры – `False` и `True` (см. [Логические значения](https://python-all.ru/3.10/library/stdtypes.html#bltin-boolean-values)).9091Изменено в версии 3.7: *x* теперь является параметром только для позиционной передачи.9293#### `breakpoint(*args, **kws)`9495Эта функция запускает отладчик в месте вызова. А именно, она вызывает [`sys.breakpointhook()`](https://python-all.ru/3.10/library/sys.html#sys.breakpointhook), передавая `args` и `kws` напрямую. По умолчанию `sys.breakpointhook()` вызывает [`pdb.set_trace()`](https://python-all.ru/3.10/library/pdb.html#pdb.set_trace) без аргументов. В этом случае это просто вспомогательная функция, чтобы не импортировать явно [`pdb`](https://python-all.ru/3.10/library/pdb.html#module-pdb) или не набирать много кода для входа в отладчик. Однако [`sys.breakpointhook()`](https://python-all.ru/3.10/library/sys.html#sys.breakpointhook) можно задать как другую функцию, и [`breakpoint()`](https://python-all.ru/3.10/library/functions.html#breakpoint) будет автоматически вызывать её, позволяя войти в отладчик по выбору. Если [`sys.breakpointhook()`](https://python-all.ru/3.10/library/sys.html#sys.breakpointhook) недоступен, эта функция возбудит [`RuntimeError`](https://python-all.ru/3.10/library/exceptions.html#RuntimeError).9697Вызывает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `builtins.breakpoint` с аргументом `breakpointhook`.9899Добавлено в версии 3.7.100101#### `class bytearray([source[, encoding[, errors]]])`102103Возвращает новый массив байтов. Класс [`bytearray`](https://python-all.ru/3.10/library/stdtypes.html#bytearray) представляет собой изменяемую последовательность целых чисел в диапазоне 0 \<= x \< 256. Он поддерживает большинство обычных методов изменяемых последовательностей, описанных в разделе [Изменяемые типы последовательностей](https://python-all.ru/3.10/library/stdtypes.html#typesseq-mutable), а также большинство методов, которые есть у типа [`bytes`](https://python-all.ru/3.10/library/stdtypes.html#bytes) (см. [Операции с байтами и bytearray](https://python-all.ru/3.10/library/stdtypes.html#bytes-methods)).104105Необязательный параметр *source* можно использовать для инициализации массива несколькими разными способами:106107- Если это *строка*, необходимо также указать параметры *кодировка* (и, опционально, *ошибки*); затем [`bytearray()`](https://python-all.ru/3.10/library/stdtypes.html#bytearray) преобразует строку в байты с помощью [`str.encode()`](https://python-all.ru/3.10/library/stdtypes.html#str.encode).108- Если это *целое число*, массив будет иметь указанный размер и будет инициализирован нулевыми байтами.109- Если это объект, соответствующий [буферному интерфейсу](https://python-all.ru/3.10/c-api/buffer.html#bufferobjects), для инициализации массива байтов будет использоваться буфер только для чтения этого объекта.110- Если это *итерируемый объект*, он должен быть итерируемым объектом, содержащим целые числа в диапазоне `0 <= x < 256`, которые используются в качестве начального содержимого массива.111112Без аргументов создаётся массив размера 0.113114См. также [Типы бинарных последовательностей – bytes, bytearray, memoryview](https://python-all.ru/3.10/library/stdtypes.html#binaryseq) и [Объекты bytearray](https://python-all.ru/3.10/library/stdtypes.html#typebytearray).115116#### `class bytes([source[, encoding[, errors]]])`117118Возвращает новый объект «bytes», который является неизменяемой последовательностью целых чисел в диапазоне `0 <= x < 256`. [`bytes`](https://python-all.ru/3.10/library/stdtypes.html#bytes) – это неизменяемая версия [`bytearray`](https://python-all.ru/3.10/library/stdtypes.html#bytearray): он имеет те же методы, не изменяющие объект, и те же возможности индексации и взятия срезов.119120Соответственно, аргументы конструктора интерпретируются так же, как для [`bytearray()`](https://python-all.ru/3.10/library/stdtypes.html#bytearray).121122Объекты bytes также можно создавать с помощью литералов, см. [Литералы строк и bytes](https://python-all.ru/3.10/reference/lexical_analysis.html#strings).123124См. также [Типы бинарных последовательностей – bytes, bytearray, memoryview](https://python-all.ru/3.10/library/stdtypes.html#binaryseq), [Объекты bytes](https://python-all.ru/3.10/library/stdtypes.html#typebytes) и [Операции с байтами и bytearray](https://python-all.ru/3.10/library/stdtypes.html#bytes-methods).125126#### `callable(object)`127128Возвращает [`True`](https://python-all.ru/3.10/library/constants.html#True), если аргумент *object* является вызываемым, и [`False`](https://python-all.ru/3.10/library/constants.html#False) в противном случае. Если эта функция возвращает `True`, вызов всё ещё может завершиться ошибкой, но если возвращается `False`, вызвать *object* никогда не удастся. Обратите внимание, что классы вызываемы (вызов класса возвращает новый экземпляр); экземпляры вызываемы, если их класс имеет метод `__call__()`.129130Новое в версии 3.2: Эта функция была сначала удалена в Python 3.0, а затем снова добавлена в Python 3.2.131132#### `chr(i)`133134Возвращает строку, представляющую символ, кодовая точка Unicode которого равна целому числу *i*. Например, `chr(97)` возвращает строку `'a'`, а `chr(8364)` возвращает `'€'`. Это обратная операция к [`ord()`](https://python-all.ru/3.10/library/functions.html#ord).135136Допустимый диапазон аргумента – от 0 до 1 114 111 (0x10FFFF в шестнадцатеричной системе). [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError) будет возбуждено, если *i* выходит за этот диапазон.137138#### `@classmethod`139140Преобразует метод в метод класса.141142Метод класса получает класс в качестве неявного первого аргумента, точно так же, как метод экземпляра получает экземпляр. Чтобы объявить метод класса, используйте следующий идиоматический приём:143144```python145class C:146    @classmethod147    def f(cls, arg1, arg2): ...148```149150Форма `@classmethod` является функцией [декоратора](https://python-all.ru/3.10/glossary.html#term-decorator) – подробнее см. в [Function definitions](https://python-all.ru/3.10/reference/compound_stmts.html#function).151152Метод класса можно вызывать как через класс (например, `C.f()`), так и через экземпляр (например, `C().f()`). Экземпляр при этом игнорируется, учитывается только его класс. Если метод класса вызывается для производного класса, в качестве подразумеваемого первого аргумента передаётся объект производного класса.153154Методы классов отличаются от статических методов C++ или Java. Если нужны именно статические методы, см. [`staticmethod()`](https://python-all.ru/3.10/library/functions.html#staticmethod) в этом разделе. Дополнительную информацию о методах классов можно найти в разделе [Стандартная иерархия типов](https://python-all.ru/3.10/reference/datamodel.html#types).155156Изменено в версии 3.9: Теперь методы классов могут оборачивать другие [дескрипторы](https://python-all.ru/3.10/glossary.html#term-descriptor), например [`property()`](https://python-all.ru/3.10/library/functions.html#property).157158Изменено в версии 3.10: Методы класса теперь наследуют атрибуты метода (`__module__`, `__name__`, `__qualname__`, `__doc__` и `__annotations__`) и имеют новый атрибут `__wrapped__`.159160#### `compile(source, filename, mode, flags=0, dont_inherit=False, optimize=- 1)`161162Компилирует *source* в объект кода или AST. Объекты кода могут выполняться с помощью [`exec()`](https://python-all.ru/3.10/library/functions.html#exec) или [`eval()`](https://python-all.ru/3.10/library/functions.html#eval). *source* может быть обычной строкой, строкой байтов или объектом AST. Обратитесь к документации модуля [`ast`](https://python-all.ru/3.10/library/ast.html#module-ast) за информацией о работе с объектами AST.163164Аргумент *filename* должен указывать файл, из которого был прочитан код; если код был прочитан не из файла, следует передать какое-либо узнаваемое значение (обычно используется `'<string>'`).165166Аргумент *mode* определяет, какой код следует компилировать; он может быть равен `'exec'`, если *source* состоит из последовательности инструкций, `'eval'`, если из одного выражения, или `'single'`, если из одной интерактивной инструкции (в последнем случае будут выведены выражения, которые вычисляются в значение, отличное от `None`).167168Необязательные аргументы *flags* и *dont\_inherit* управляют тем, какие [параметры компилятора](https://python-all.ru/3.10/library/ast.html#ast-compiler-flags) следует активировать, а какие [будущие возможности](https://python-all.ru/3.10/reference/simple_stmts.html#future) разрешить. Если ни один из них не указан (или оба равны нулю), код компилируется с теми же флагами, что и код, вызывающий [`compile()`](https://python-all.ru/3.10/library/functions.html#compile). Если аргумент *flags* передан, а *dont\_inherit* – нет (или равен нулю), то параметры компилятора и будущие инструкции, заданные аргументом *flags*, используются в дополнение к тем, которые использовались бы в любом случае. Если *dont\_inherit* – ненулевое целое, то аргументом *flags* являются сами флаги – флаги (будущие возможности и параметры компилятора) в окружающем коде игнорируются.169170Параметры компилятора и будущие инструкции задаются битами, которые можно объединять побитовым ИЛИ, чтобы указать несколько параметров. Битовое поле, необходимое для указания конкретной будущей возможности, можно найти как атрибут `compiler_flag` у экземпляра `_Feature` в модуле [`__future__`](https://python-all.ru/3.10/library/__future__.html#module-__future__). [Флаги компилятора](https://python-all.ru/3.10/library/ast.html#ast-compiler-flags) можно найти в модуле [`ast`](https://python-all.ru/3.10/library/ast.html#module-ast), с префиксом `PyCF_`.171172Аргумент *optimize* задаёт уровень оптимизации компилятора; значение по умолчанию `-1` выбирает уровень оптимизации интерпретатора, заданный опциями [`-O`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-O). Явные уровни: `0` (без оптимизации; `__debug__` истинно), `1` (утверждения удалены, `__debug__` ложно) или `2` (строки документации также удалены).173174Эта функция возбуждает [`SyntaxError`](https://python-all.ru/3.10/library/exceptions.html#SyntaxError), если скомпилированный исходный код некорректен, и [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError), если исходный код содержит нулевые байты.175176Если требуется разобрать код Python в его AST-представление, см. [`ast.parse()`](https://python-all.ru/3.10/library/ast.html#ast.parse).177178Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `compile` с аргументами `source` и `filename`. Это событие также может быть возбуждено при неявной компиляции.179180> **Примечание**181>182> При компиляции строки с многострочным кодом в режиме `'single'` или `'eval'` входные данные должны завершаться как минимум одним символом новой строки. Это необходимо для облегчения определения незавершённых и завершённых инструкций в модуле [`code`](https://python-all.ru/3.10/library/code.html#module-code).183184> **Предупреждение**185>186> Можно привести к аварийному завершению интерпретатора Python с помощью достаточно длинной/сложной строки при компиляции в объект AST из-за ограничений глубины стека в компиляторе AST Python.187188Изменено в версии 3.2: Разрешено использование символов новой строки Windows и Mac. Кроме того, входные данные в режиме `'exec'` больше не обязаны заканчиваться символом новой строки. Добавлен параметр *optimize*.189190Изменено в версии 3.5: Ранее возбуждалось исключение [`TypeError`](https://python-all.ru/3.10/library/exceptions.html#TypeError), когда в *source* встречались нулевые байты.191192Новое в версии 3.8: Теперь `ast.PyCF_ALLOW_TOP_LEVEL_AWAIT` может передаваться в flags для включения поддержки `await`, `async for` и `async with` верхнего уровня.193194#### `class complex([real[, imag]])`195196Возвращает комплексное число со значением *real* + *imag*\*1j или преобразует строку или число в комплексное число. Если первый параметр – строка, она интерпретируется как комплексное число, и функция должна вызываться без второго параметра. Второй параметр не может быть строкой. Каждый аргумент может иметь любой числовой тип (включая комплексный). Если *imag* опущен, по умолчанию он равен нулю, и конструктор работает как числовое преобразование, аналогично [`int`](https://python-all.ru/3.10/library/functions.html#int) и [`float`](https://python-all.ru/3.10/library/functions.html#float). Если оба аргумента опущены, возвращается `0j`.197198Для обычного объекта Python `x` метод `complex(x)` делегирует вызов `x.__complex__()`. Если `__complex__()` не определён, то используется `__float__()`. Если `__float__()` не определён, то используется `__index__()`.199200> **Примечание**201>202> При преобразовании из строки вокруг центрального оператора `+` или `-` не должно быть пробелов. Например, `complex('1+2j')` корректно, а `complex('1 + 2j')` вызывает [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError).203204Тип complex описан в разделе [Числовые типы – int, float, complex](https://python-all.ru/3.10/library/stdtypes.html#typesnumeric).205206Изменено в версии 3.6: Разрешена группировка цифр с помощью подчёркиваний, как в литералах кода.207208Изменено в версии 3.8: Используется `__index__()`, если `__complex__()` и `__float__()` не определены.209210#### `delattr(object, name)`211212Эта функция является аналогом [`setattr()`](https://python-all.ru/3.10/library/functions.html#setattr). Аргументы – объект и строка. Строка должна быть именем одного из атрибутов объекта. Функция удаляет указанный атрибут, если объект это позволяет. Например, `delattr(x, 'foobar')` эквивалентно `del x.foobar`. *name* не обязательно должен быть идентификатором Python (см. [`setattr()`](https://python-all.ru/3.10/library/functions.html#setattr)).213214#### `class dict(**kwarg)`215216#### `class dict(mapping, **kwarg)`217218#### `class dict(iterable, **kwarg)`219220Создаёт новый словарь. Объект [`dict`](https://python-all.ru/3.10/library/stdtypes.html#dict) – это класс словаря. Документацию по этому классу см. в [`dict`](https://python-all.ru/3.10/library/stdtypes.html#dict) и [Типы отображений – dict](https://python-all.ru/3.10/library/stdtypes.html#typesmapping).221222О других контейнерах см. встроенные классы [`list`](https://python-all.ru/3.10/library/stdtypes.html#list), [`set`](https://python-all.ru/3.10/library/stdtypes.html#set) и [`tuple`](https://python-all.ru/3.10/library/stdtypes.html#tuple), а также модуль [`collections`](https://python-all.ru/3.10/library/collections.html#module-collections).223224#### `dir([object])`225226Без аргументов возвращает список имён в текущей локальной области видимости. Если передан аргумент, пытается вернуть список допустимых атрибутов этого объекта.227228Если у объекта есть метод с именем `__dir__()`, этот метод будет вызван и должен вернуть список атрибутов. Это позволяет объектам, реализующим собственную функцию `__getattr__()` или `__getattribute__()`, настраивать способ, которым [`dir()`](https://python-all.ru/3.10/library/functions.html#dir) сообщает их атрибуты.229230Если объект не предоставляет `__dir__()`, функция старается извлечь информацию из атрибута [`__dict__`](https://python-all.ru/3.10/library/stdtypes.html#object.__dict__) объекта, если он определен, и из его объекта-типа. Полученный список не обязательно полон и может быть неточным, если у объекта есть собственный `__getattr__()`.231232Механизм [`dir()`](https://python-all.ru/3.10/library/functions.html#dir) по умолчанию ведёт себя по-разному для разных типов объектов, поскольку он пытается выдать наиболее релевантную, а не полную информацию:233234- Если объект является модулем, список содержит имена атрибутов этого модуля.235- Если объект является типом или классом, список содержит имена его атрибутов, а также (рекурсивно) атрибутов его базовых классов.236- В остальных случаях список содержит имена атрибутов объекта, имена атрибутов его класса и (рекурсивно) атрибутов базовых классов его класса.237238Полученный список сортируется по алфавиту. Например:239240```python241>>> import struct242>>> dir()   # показать имена в пространстве имён модуля  243['__builtins__', '__name__', 'struct']244>>> dir(struct)   # показать имена в модуле struct 245['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__',246 '__initializing__', '__loader__', '__name__', '__package__',247 '_clearcache', 'calcsize', 'error', 'pack', 'pack_into',248 'unpack', 'unpack_from']249>>> class Shape:250...     def __dir__(self):251...         return ['area', 'perimeter', 'location']252>>> s = Shape()253>>> dir(s)254['area', 'location', 'perimeter']255```256257> **Примечание**258>259> Поскольку [`dir()`](https://python-all.ru/3.10/library/functions.html#dir) предоставляется в первую очередь для удобства использования в интерактивной оболочке, он старается выдать интересный набор имён скорее, чем строго или последовательно определённый, и его детальное поведение может меняться от версии к версии. Например, атрибуты метакласса не входят в результирующий список, когда аргументом является класс.260261#### `divmod(a, b)`262263Принимает два числа (не комплексных) в качестве аргументов и возвращает пару чисел, состоящую из их частного и остатка при целочисленном делении. Для смешанных типов операндов действуют правила бинарных арифметических операторов. Для целых чисел результат совпадает с `(a // b, a % b)`. Для чисел с плавающей запятой результат равен `(q, a % b)`, где *q* обычно равно `math.floor(a / b)`, но может быть на 1 меньше. В любом случае `q * b + a % b` очень близко к *a*, если `a % b` не равно нулю, то оно имеет тот же знак, что и *b*, и `0 <= abs(a % b) < abs(b)`.264265#### `enumerate(iterable, start=0)`266267Возвращает объект enumerate. *iterable* должен быть последовательностью, [итератором](https://python-all.ru/3.10/glossary.html#term-iterator) или другим объектом, поддерживающим итерацию. Метод [`__next__()`](https://python-all.ru/3.10/library/stdtypes.html#iterator.__next__) итератора, возвращаемого[`enumerate()`](https://python-all.ru/3.10/library/functions.html#enumerate), возвращает кортеж, содержащий счётчик (начиная с *start*, который по умолчанию равен 0) и значения, полученные при итерации по *iterable*.268269```python270>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter']271>>> list(enumerate(seasons))272[(0, 'Spring'), (1, 'Summer'), (2, 'Fall'), (3, 'Winter')]273>>> list(enumerate(seasons, start=1))274[(1, 'Spring'), (2, 'Summer'), (3, 'Fall'), (4, 'Winter')]275```276277Эквивалентно следующему:278279```python280def enumerate(sequence, start=0):281    n = start282    for elem in sequence:283        yield n, elem284        n += 1285```286287#### `eval(expression[, globals[, locals]])`288289Аргументами являются строка и необязательные globals и locals. Если они указаны, *globals* должен быть словарём. Если указаны, *locals* может быть любым отображением (mapping).290291Аргумент *expression* разбирается и вычисляется как выражение Python (технически говоря, список условий) с использованием словарей *globals* и *locals* в качестве глобального и локального пространства имён. Если словарь *globals* присутствует и не содержит значение для ключа `__builtins__`, то перед разбором *expression* под этот ключ вставляется ссылка на словарь встроенного модуля [`builtins`](https://python-all.ru/3.10/library/builtins.html#module-builtins). Таким образом можно контролировать, какие встроенные объекты доступны выполняемому коду, вставив собственный словарь `__builtins__` в *globals* перед передачей его в [`eval()`](https://python-all.ru/3.10/library/functions.html#eval). Если словарь *locals* опущен, он по умолчанию равен словарю *globals*. Если оба словаря опущены, выражение выполняется с *globals* и *locals* из окружения, в котором вызвана [`eval()`](https://python-all.ru/3.10/library/functions.html#eval). Обратите внимание: *eval()* не имеет доступа к [вложенным областям видимости](https://python-all.ru/3.10/glossary.html#term-nested-scope) (нелокальным) в окружающем окружении.292293Возвращаемое значение – результат вычисленного выражения. Синтаксические ошибки сообщаются как исключения. Пример:294295```python296>>> x = 1297>>> eval('x+1')2982299```300301Эту функцию также можно использовать для выполнения произвольных объектов кода (например, созданных с помощью [`compile()`](https://python-all.ru/3.10/library/functions.html#compile)). В этом случае передаётся объект кода вместо строки. Если объект кода был скомпилирован с `'exec'` в качестве аргумента *mode*, возвращаемое значение [`eval()`](https://python-all.ru/3.10/library/functions.html#eval) будет `None`.302303Подсказки: динамическое выполнение инструкций поддерживается функцией [`exec()`](https://python-all.ru/3.10/library/functions.html#exec). Функции [`globals()`](https://python-all.ru/3.10/library/functions.html#globals) и [`locals()`](https://python-all.ru/3.10/library/functions.html#locals) возвращают текущий глобальный и локальный словари соответственно, что может быть полезно для передачи их в [`eval()`](https://python-all.ru/3.10/library/functions.html#eval) или [`exec()`](https://python-all.ru/3.10/library/functions.html#exec).304305Если исходный код является строкой, начальные и конечные пробелы и табуляции удаляются.306307См. [`ast.literal_eval()`](https://python-all.ru/3.10/library/ast.html#ast.literal_eval): функция, которая может безопасно вычислять строки с выражениями, содержащими только литералы.308309Вызывает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `exec` с объектом кода в качестве аргумента. Также могут возникать события компиляции кода.310311#### `exec(object[, globals[, locals]])`312313Эта функция поддерживает динамическое выполнение кода Python. *object* должен быть строкой или объектом кода. Если это строка, она разбирается как набор инструкций Python, который затем выполняется (если не возникает синтаксическая ошибка). [1](https://python-all.ru/3.10/library/functions.html#id2) Если это объект кода, он просто выполняется. В любом случае выполняемый код должен быть корректным как файловый ввод (см. раздел [Файловый ввод](https://python-all.ru/3.10/reference/toplevel_components.html#file-input) в справочном руководстве). Имейте в виду, что инструкции [`nonlocal`](https://python-all.ru/3.10/reference/simple_stmts.html#nonlocal), [`yield`](https://python-all.ru/3.10/reference/simple_stmts.html#yield) и [`return`](https://python-all.ru/3.10/reference/simple_stmts.html#return) не могут использоваться вне определений функций, даже в контексте кода, переданного функции [`exec()`](https://python-all.ru/3.10/library/functions.html#exec). Возвращаемое значение – `None`.314315Во всех случаях, если необязательные части опущены, код выполняется в текущей области видимости. Если указан только *globals*, он должен быть словарём (и не подклассом словаря), который будет использоваться как для глобальных, так и для локальных переменных. Если указаны и *globals*, и *locals*, они используются соответственно для глобальных и локальных переменных. Если указан *locals*, он может быть любым отображением. Помните, что на уровне модуля globals и locals – один и тот же словарь. Если exec получает два отдельных объекта в качестве *globals* и *locals*, код будет выполняться так, как если бы он был встроен в определение класса.316317Если словарь *globals* не содержит значение для ключа `__builtins__`, под этот ключ вставляется ссылка на словарь встроенного модуля [`builtins`](https://python-all.ru/3.10/library/builtins.html#module-builtins). Таким образом можно контролировать, какие встроенные объекты доступны выполняемому коду, вставив собственный словарь `__builtins__` в *globals* перед передачей его в [`exec()`](https://python-all.ru/3.10/library/functions.html#exec).318319Вызывает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `exec` с объектом кода в качестве аргумента. Также могут возникать события компиляции кода.320321> **Примечание**322>323> Встроенные функции [`globals()`](https://python-all.ru/3.10/library/functions.html#globals) и [`locals()`](https://python-all.ru/3.10/library/functions.html#locals) возвращают текущий глобальный и локальный словарь соответственно, что может быть полезно для передачи в качестве второго и третьего аргумента в [`exec()`](https://python-all.ru/3.10/library/functions.html#exec).324325> **Примечание**326>327> Словарь *locals* по умолчанию действует так, как описано для функции [`locals()`](https://python-all.ru/3.10/library/functions.html#locals) ниже: не следует пытаться изменять словарь *locals* по умолчанию. Передайте явный словарь *locals*, если нужно увидеть влияние кода на *locals* после возврата из функции [`exec()`](https://python-all.ru/3.10/library/functions.html#exec).328329#### `filter(function, iterable)`330331Создает итератор из тех элементов *итерируемого объекта*, для которых *функция* возвращает истину. *Итерируемый объект* может быть последовательностью, контейнером, поддерживающим итерацию, или итератором. Если *функция* равна `None`, подразумевается тождественная функция, то есть удаляются все элементы *итерируемого объекта*, которые являются ложными.332333Обратите внимание: `filter(function, iterable)` эквивалентно генераторному выражению `(item for item in iterable if function(item))`, если function не равна `None`, и `(item for item in iterable if item)`, если function равна `None`.334335См. [`itertools.filterfalse()`](https://python-all.ru/3.10/library/itertools.html#itertools.filterfalse) для дополнительной функции, которая возвращает элементы *итерируемого объекта*, для которых *функция* возвращает ложь.336337#### `class float([x])`338339Возвращает число с плавающей запятой, построенное из числа или строки *x*.340341Если аргумент – строка, она должна содержать десятичное число, опционально с предшествующим знаком и опционально с пробельными символами вокруг. Допустимый знак – `'+'` или `'-'`; знак `'+'` не влияет на результирующее значение. Аргументом также может быть строка, представляющая NaN (не число), или положительную или отрицательную бесконечность. Точнее, входные данные должны соответствовать правилу `floatvalue` из следующей грамматики после удаления начальных и конечных пробельных символов:342343```344345sign        ::=  "+" | "-"346infinity    ::=  "Infinity" | "inf"347nan         ::=  "nan"348digitpart   ::=  digit (["_"] digit)*349number      ::=  [digitpart] "." digitpart | digitpart ["."]350exponent    ::=  ("e" | "E") ["+" | "-"] digitpart351floatnumber ::=  number [exponent]352floatvalue  ::=  [sign] (floatnumber | infinity | nan)353```354355Здесь `digit` – это десятичная цифра Unicode (символ из общей категории Unicode `Nd`). Регистр не имеет значения, поэтому, например, «inf», «Inf», «INFINITY» и «iNfINity» – все допустимые варианты написания положительной бесконечности.356357В противном случае, если аргумент – целое число или число с плавающей запятой, возвращается число с плавающей запятой с тем же значением (в пределах точности чисел с плавающей запятой Python). Если аргумент выходит за диапазон числа float в Python, будет возбуждено исключение [`OverflowError`](https://python-all.ru/3.10/library/exceptions.html#OverflowError).358359Для произвольного объекта Python `x` функция `float(x)` делегирует выполнение `x.__float__()`. Если `__float__()` не определён, используется `__index__()`.360361Если аргумент не указан, возвращается `0.0`.362363Примеры:364365```python366>>> float('+1.23')3671.23368>>> float('   -12345\n')369-12345.0370>>> float('1e-003')3710.001372>>> float('+1E6')3731000000.0374>>> float('-Infinity')375-inf376```377378Тип float описан в разделе [Числовые типы – int, float, complex](https://python-all.ru/3.10/library/stdtypes.html#typesnumeric).379380Изменено в версии 3.6: Разрешена группировка цифр с помощью подчёркиваний, как в литералах кода.381382Изменено в версии 3.7: *x* теперь является параметром только для позиционной передачи.383384Изменено в версии 3.8: Использует `__index__()`, если `__float__()` не определён.385386#### `format(value[, format_spec])`387388Преобразует *value* в «форматированное» представление, управляемое *format\_spec*. Интерпретация *format\_spec* зависит от типа аргумента *value*; однако существует стандартный синтаксис форматирования, используемый большинством встроенных типов: [Мини-язык спецификации форматирования](https://python-all.ru/3.10/library/string.html#formatspec).389390Значение *format\_spec* по умолчанию – пустая строка, что обычно даёт тот же эффект, что и вызов [`str(value)`](https://python-all.ru/3.10/library/stdtypes.html#str).391392Вызов `format(value, format_spec)` преобразуется в `type(value).__format__(value, format_spec)`, который обходит словарь экземпляра при поиске метода `__format__()` значения. Исключение [`TypeError`](https://python-all.ru/3.10/library/exceptions.html#TypeError) возникает, если поиск метода доходит до [`object`](https://python-all.ru/3.10/library/functions.html#object) и *format\_spec* не пуста, или если *format\_spec* или возвращаемое значение не являются строками.393394Изменено в версии 3.4: `object().__format__(format_spec)` вызывает [`TypeError`](https://python-all.ru/3.10/library/exceptions.html#TypeError), если *format\_spec* не является пустой строкой.395396#### `class frozenset([iterable])`397398Возвращает новый объект [`frozenset`](https://python-all.ru/3.10/library/stdtypes.html#frozenset), опционально с элементами, взятыми из *итерируемого объекта*. `frozenset` – это встроенный класс. См. [`frozenset`](https://python-all.ru/3.10/library/stdtypes.html#frozenset) и [Типы множеств – set, frozenset](https://python-all.ru/3.10/library/stdtypes.html#types-set) для документации об этом классе.399400Для других контейнеров см. встроенные классы [`set`](https://python-all.ru/3.10/library/stdtypes.html#set), [`list`](https://python-all.ru/3.10/library/stdtypes.html#list), [`tuple`](https://python-all.ru/3.10/library/stdtypes.html#tuple) и [`dict`](https://python-all.ru/3.10/library/stdtypes.html#dict), а также модуль [`collections`](https://python-all.ru/3.10/library/collections.html#module-collections).401402#### `getattr(object, name[, default])`403404Возвращает значение именованного атрибута объекта *object*. *name* должен быть строкой. Если строка является именем одного из атрибутов объекта, результатом будет значение этого атрибута. Например, `getattr(x, 'foobar')` эквивалентно `x.foobar`. Если именованный атрибут не существует, возвращается *default*, если он передан, в противном случае вызывается [`AttributeError`](https://python-all.ru/3.10/library/exceptions.html#AttributeError). *name* не обязательно должен быть идентификатором Python (см. [`setattr()`](https://python-all.ru/3.10/library/functions.html#setattr)).405406> **Примечание**407>408> Поскольку [искажение имени закрытых атрибутов](https://python-all.ru/3.10/reference/expressions.html#private-name-mangling) происходит во время компиляции, необходимо вручную исказить имя закрытого атрибута (атрибуты с двумя подчеркиваниями в начале), чтобы получить его с помощью [`getattr()`](https://python-all.ru/3.10/library/functions.html#getattr).409410#### `globals()`411412Возвращает словарь, реализующий пространство имен текущего модуля. Для кода внутри функций он устанавливается при определении функции и остается неизменным независимо от того, откуда функция вызывается.413414#### `hasattr(object, name)`415416Аргументами являются объект и строка. Результат равен `True`, если строка является именем одного из атрибутов объекта, и `False` в противном случае. (Реализовано вызовом `getattr(object, name)` и проверкой, вызывает ли он исключение [`AttributeError`](https://python-all.ru/3.10/library/exceptions.html#AttributeError) или нет.)417418#### `hash(object)`419420Возвращает хеш-значение объекта (если оно есть). Хеш-значения – целые числа. Они используются для быстрого сравнения ключей словаря при поиске. Числовые значения, равные при сравнении, имеют одинаковое хеш-значение (даже если они разных типов, как в случае 1 и 1.0).421422> **Примечание**423>424> Для объектов с пользовательскими методами `__hash__()`, обратите внимание, что [`hash()`](https://python-all.ru/3.10/library/functions.html#hash) усекает возвращаемое значение на основе разрядности хост-машины. См. `__hash__()` для подробностей.425426#### `help([object])`427428Запускает встроенную справочную систему. (Эта функция предназначена для интерактивного использования.) Если аргумент не указан, интерактивная справочная система запускается на консоли интерпретатора. Если аргумент – строка, то она ищется как имя модуля, функции, класса, метода, ключевого слова или темы документации, и на консоль выводится страница справки. Если аргумент – объект любого другого типа, генерируется страница справки по этому объекту.429430Обратите внимание, что если при вызове [`help()`](https://python-all.ru/3.10/library/functions.html#help) в списке параметров функции встречается косая черта (/), это означает, что параметры до нее являются только позиционными. Подробнее см. [запись в FAQ о только позиционных параметрах](https://python-all.ru/3.10/faq/programming.html#faq-positional-only-arguments).431432Эта функция добавляется во встроенное пространство имен модулем [`site`](https://python-all.ru/3.10/library/site.html#module-site).433434Изменено в версии 3.4: Изменения в [`pydoc`](https://python-all.ru/3.10/library/pydoc.html#module-pydoc) и [`inspect`](https://python-all.ru/3.10/library/inspect.html#module-inspect) привели к тому, что сообщаемые сигнатуры для вызываемых объектов стали более полными и согласованными.435436#### `hex(x)`437438Преобразует целое число в шестнадцатеричную строку в нижнем регистре с префиксом «0x». Если *x* не является объектом Python [`int`](https://python-all.ru/3.10/library/functions.html#int), он должен определять метод `__index__()`, который возвращает целое число. Некоторые примеры:439440```python441>>> hex(255)442'0xff'443>>> hex(-42)444'-0x2a'445```446447Если вы хотите преобразовать целое число в шестнадцатеричную строку в верхнем или нижнем регистре, с префиксом или без, можно использовать любой из следующих способов:448449```python450>>> '%#x' % 255, '%x' % 255, '%X' % 255451('0xff', 'ff', 'FF')452>>> format(255, '#x'), format(255, 'x'), format(255, 'X')453('0xff', 'ff', 'FF')454>>> f'{255:#x}', f'{255:x}', f'{255:X}'455('0xff', 'ff', 'FF')456```457458См. также [`format()`](https://python-all.ru/3.10/library/functions.html#format) для получения дополнительной информации.459460См. также [`int()`](https://python-all.ru/3.10/library/functions.html#int) для преобразования шестнадцатеричной строки в целое число с основанием 16.461462> **Примечание**463>464> Чтобы получить шестнадцатеричное строковое представление числа с плавающей точкой, используйте метод [`float.hex()`](https://python-all.ru/3.10/library/stdtypes.html#float.hex).465466#### `id(object)`467468Возвращает «идентификатор» объекта. Это целое число, которое гарантированно будет уникальным и постоянным для данного объекта на протяжении его времени жизни. Два объекта с непересекающимся временем жизни могут иметь одинаковое значение [`id()`](https://python-all.ru/3.10/library/functions.html#id).469470**Особенность реализации CPython:** Это адрес объекта в памяти.471472Вызывает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `builtins.id` с аргументом `id`.473474#### `input([prompt])`475476Если аргумент *prompt* присутствует, он выводится в стандартный вывод без символа новой строки. Затем функция читает строку из ввода, преобразует её в строку (удаляя конечный символ новой строки) и возвращает её. Когда достигнут конец файла, возбуждается [`EOFError`](https://python-all.ru/3.10/library/exceptions.html#EOFError). Пример:477478```python479>>> s = input('--> ')  480--> Monty Python's Flying Circus481>>> s  482"Monty Python's Flying Circus"483```484485Если модуль [`readline`](https://python-all.ru/3.10/library/readline.html#module-readline) был загружен, то [`input()`](https://python-all.ru/3.10/library/functions.html#input) будет использовать его для предоставления расширенных возможностей редактирования строки и истории команд.486487Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `builtins.input` с аргументом `prompt` перед чтением ввода488489Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `builtins.input/result` с результатом после успешного чтения ввода.490491#### `class int([x])`492493#### `class int(x, base=10)`494495Возвращает целочисленный объект, созданный из числа или строки *x*, или возвращает `0`, если аргументы не переданы. Если *x* определяет `__int__()`, `int(x)` возвращает `x.__int__()`. Если *x* определяет `__index__()`, возвращается `x.__index__()`. Если *x* определяет `__trunc__()`, возвращается `x.__trunc__()`. Для чисел с плавающей точкой происходит усечение в сторону нуля.496497Если *x* не является числом или указан *base*, то *x* должен быть строкой, [`bytes`](https://python-all.ru/3.10/library/stdtypes.html#bytes) или экземпляром [`bytearray`](https://python-all.ru/3.10/library/stdtypes.html#bytearray), представляющим целое число в системе счисления *base*. При необходимости строка может начинаться с `+` или `-` (без пробелов между), содержать ведущие нули, быть окружена пробелами и содержать одиночные символы подчеркивания между цифрами.498499Строка целого числа по основанию n содержит цифры, каждая из которых представляет значение от 0 до n-1. Значения от 0 до 9 могут быть представлены любой десятичной цифрой Unicode. Значения от 10 до 35 могут быть представлены `a` до `z` (или `A` до `Z`). По умолчанию *base* равно 10. Допустимые основания: 0 и 2–36. Строки с основанием 2, 8 и 16 могут быть необязательно дополнены префиксом `0b`/`0B`, `0o`/`0O` или `0x`/`0X`, как и целочисленные литералы в коде. Для основания 0 строка интерпретируется аналогично [целочисленному литералу в коде](https://python-all.ru/3.10/reference/lexical_analysis.html#integers), в том смысле, что фактическое основание (2, 8, 10 или 16) определяется префиксом. Основание 0 также запрещает ведущие нули: `int('010', 0)` недопустимо, тогда как `int('010')` и `int('010', 8)` допустимы.500501Целочисленный тип описан в разделе [Числовые типы – int, float, complex](https://python-all.ru/3.10/library/stdtypes.html#typesnumeric).502503Изменено в версии 3.4: Если *base* не является экземпляром [`int`](https://python-all.ru/3.10/library/functions.html#int) и объект *base* имеет метод [`base.__index__`](https://python-all.ru/3.10/reference/datamodel.html#object.__index__), то вызывается этот метод для получения целого числа для основания. В предыдущих версиях использовался [`base.__int__`](https://python-all.ru/3.10/reference/datamodel.html#object.__int__) вместо [`base.__index__`](https://python-all.ru/3.10/reference/datamodel.html#object.__index__).504505Изменено в версии 3.6: Разрешена группировка цифр с помощью подчёркиваний, как в литералах кода.506507Изменено в версии 3.7: *x* теперь является параметром только для позиционной передачи.508509Изменено в версии 3.8: Использует `__index__()`, если `__int__()` не определён.510511Изменено в версии 3.10.7: [`int`](https://python-all.ru/3.10/library/functions.html#int) строковые входные данные и строковые представления могут быть ограничены для предотвращения атак типа «отказ в обслуживании». Исключение [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError) возбуждается, когда превышен лимит при преобразовании строки *x* в [`int`](https://python-all.ru/3.10/library/functions.html#int) или при преобразовании [`int`](https://python-all.ru/3.10/library/functions.html#int) в строку, превышающее лимит. См. документацию [ограничение длины преобразования целого числа в строку](https://python-all.ru/3.10/library/stdtypes.html#int-max-str-digits).512513#### `isinstance(object, classinfo)`514515Возвращает `True`, если аргумент *object* является экземпляром *classinfo*, или его (прямого, косвенного или [виртуального](https://python-all.ru/3.10/glossary.html#term-abstract-base-class)) подкласса. Если *object* не является объектом указанного типа, функция всегда возвращает `False`. Если *classinfo* является кортежем объектов-типов (или рекурсивно других таких кортежей) или [Union Type](https://python-all.ru/3.10/library/stdtypes.html#types-union) из нескольких типов, возвращает `True`, если *object* является экземпляром любого из типов. Если *classinfo* не является типом или кортежем типов и таких кортежей, возбуждается исключение [`TypeError`](https://python-all.ru/3.10/library/exceptions.html#TypeError).516517Изменено в версии 3.10: *classinfo* может быть [типом объединения (Union Type)](https://python-all.ru/3.10/library/stdtypes.html#types-union).518519#### `issubclass(class, classinfo)`520521Возвращает `True`, если *class* является подклассом (прямым, косвенным или [виртуальным](https://python-all.ru/3.10/glossary.html#term-abstract-base-class)) *classinfo*. Класс считается своим собственным подклассом. *classinfo* может быть кортежем объектов классов (или рекурсивно, других таких кортежей) или [типом объединения (Union Type)](https://python-all.ru/3.10/library/stdtypes.html#types-union), в этом случае возвращает `True`, если *class* является подклассом любого элемента в *classinfo*. В любом другом случае возбуждается исключение [`TypeError`](https://python-all.ru/3.10/library/exceptions.html#TypeError).522523Изменено в версии 3.10: *classinfo* может быть [типом объединения (Union Type)](https://python-all.ru/3.10/library/stdtypes.html#types-union).524525#### `iter(object[, sentinel])`526527Возвращает объект [итератора](https://python-all.ru/3.10/glossary.html#term-iterator). Первый аргумент интерпретируется совершенно по-разному в зависимости от наличия второго аргумента. Без второго аргумента *object* должен быть объектом коллекции, поддерживающим протокол [итерируемого](https://python-all.ru/3.10/glossary.html#term-iterable) (метод `__iter__()`), или должен поддерживать протокол последовательности (метод `__getitem__()` с целочисленными аргументами, начиная с `0`). Если он не поддерживает ни один из этих протоколов, возбуждается [`TypeError`](https://python-all.ru/3.10/library/exceptions.html#TypeError). Если задан второй аргумент, *sentinel*, то *object* должен быть вызываемым объектом. В этом случае созданный итератор будет вызывать *object* без аргументов при каждом вызове его метода [`__next__()`](https://python-all.ru/3.10/library/stdtypes.html#iterator.__next__); если возвращённое значение равно *sentinel*, возбуждается [`StopIteration`](https://python-all.ru/3.10/library/exceptions.html#StopIteration), иначе значение возвращается.528529См. также [Типы итераторов](https://python-all.ru/3.10/library/stdtypes.html#typeiter).530531Одно из полезных применений второй формы [`iter()`](https://python-all.ru/3.10/library/functions.html#iter) – создание построчного (блочного) читателя. Например, чтение блоков фиксированной ширины из двоичного файла базы данных до достижения конца файла:532533```python534from functools import partial535with open('mydata.db', 'rb') as f:536    for block in iter(partial(f.read, 64), b''):537        process_block(block)538```539540#### `len(s)`541542Возвращает длину (количество элементов) объекта. Аргументом может быть последовательность (например, строка, байты, кортеж, список или диапазон) или коллекция (например, словарь, множество или замороженное множество).543544**Особенность реализации CPython:** `len` возбуждает [`OverflowError`](https://python-all.ru/3.10/library/exceptions.html#OverflowError) для длин, превышающих [`sys.maxsize`](https://python-all.ru/3.10/library/sys.html#sys.maxsize), например [`range(2 ** 100)`](https://python-all.ru/3.10/library/stdtypes.html#range).545546#### `class list([iterable])`547548Вместо того чтобы быть функцией, [`list`](https://python-all.ru/3.10/library/stdtypes.html#list) на самом деле является изменяемым типом последовательности, как описано в [Списки](https://python-all.ru/3.10/library/stdtypes.html#typesseq-list) и [Типы последовательностей – list, tuple, range](https://python-all.ru/3.10/library/stdtypes.html#typesseq).549550#### `locals()`551552Обновляет и возвращает словарь, представляющий текущую таблицу локальных символов. Свободные переменные возвращаются [`locals()`](https://python-all.ru/3.10/library/functions.html#locals) при вызове в блоках функций, но не в блоках классов. Обратите внимание, что на уровне модуля [`locals()`](https://python-all.ru/3.10/library/functions.html#locals) и [`globals()`](https://python-all.ru/3.10/library/functions.html#globals) являются одним и тем же словарём.553554> **Примечание**555>556> Содержимое этого словаря не следует изменять; изменения могут не повлиять на значения локальных и свободных переменных, используемых интерпретатором.557558#### `map(function, iterable, ...)`559560Возвращает итератор, который применяет *function* к каждому элементу *iterable* и возвращает результаты. Если переданы дополнительные аргументы *iterable*, *function* должна принимать столько же аргументов и применяется к элементам из всех итерируемых параллельно. При нескольких итерируемых итератор останавливается, когда завершается самый короткий. Для случаев, когда входные данные функции уже упакованы в кортежи аргументов, см. [`itertools.starmap()`](https://python-all.ru/3.10/library/itertools.html#itertools.starmap).561562#### `max(iterable, *[, key, default])`563564#### `max(arg1, arg2, *args[, key])`565566Возвращает наибольший элемент итерируемого объекта или наибольший из двух или более аргументов.567568Если указан один позиционный аргумент, он должен быть [итерируемым объектом](https://python-all.ru/3.10/glossary.html#term-iterable). Возвращается наибольший элемент итерируемого объекта. Если указано два или более позиционных аргумента, возвращается наибольший из них.569570Есть два необязательных аргумента, передаваемых только по ключу. Аргумент *key* задаёт функцию упорядочения с одним аргументом, подобно тому, как это делается для [`list.sort()`](https://python-all.ru/3.10/library/stdtypes.html#list.sort). Аргумент *default* задаёт объект, возвращаемый, если переданный итерируемый объект пуст. Если итерация пуста и *default* не указан, возбуждается [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError).571572Если несколько элементов являются максимальными, функция возвращает первый встреченный. Это согласуется с другими инструментами, сохраняющими стабильность сортировки, такими как `sorted(iterable, key=keyfunc, reverse=True)[0]` и `heapq.nlargest(1, iterable, key=keyfunc)`.573574Новое в версии 3.4: Аргумент *default*, указываемый только по ключевому слову.575576Изменено в версии 3.8: Аргумент *key* может быть `None`.577578#### `class memoryview(object)`579580Возвращает объект «представление памяти» (memory view), созданный из переданного аргумента. Дополнительную информацию см. в [Memory Views](https://python-all.ru/3.10/library/stdtypes.html#typememoryview).581582#### `min(iterable, *[, key, default])`583584#### `min(arg1, arg2, *args[, key])`585586Возвращает наименьший элемент итерируемого объекта или наименьший из двух или более аргументов.587588Если указан один позиционный аргумент, он должен быть [итерируемым объектом](https://python-all.ru/3.10/glossary.html#term-iterable). Возвращается наименьший элемент итерируемого объекта. Если указано два или более позиционных аргумента, возвращается наименьший из них.589590Есть два необязательных аргумента, передаваемых только по ключу. Аргумент *key* задаёт функцию упорядочения с одним аргументом, подобно тому, как это делается для [`list.sort()`](https://python-all.ru/3.10/library/stdtypes.html#list.sort). Аргумент *default* задаёт объект, возвращаемый, если переданный итерируемый объект пуст. Если итерация пуста и *default* не указан, возбуждается [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError).591592Если несколько элементов являются минимальными, функция возвращает первый из них. Это согласуется с другими инструментами, сохраняющими устойчивость сортировки, такими как `sorted(iterable, key=keyfunc)[0]` и `heapq.nsmallest(1, iterable, key=keyfunc)`.593594Новое в версии 3.4: Аргумент *default*, указываемый только по ключевому слову.595596Изменено в версии 3.8: Аргумент *key* может быть `None`.597598#### `next(iterator[, default])`599600Извлекает следующий элемент из [итератора](https://python-all.ru/3.10/glossary.html#term-iterator) вызовом его метода [`__next__()`](https://python-all.ru/3.10/library/stdtypes.html#iterator.__next__). Если задан *default*, он возвращается, когда итератор исчерпан, в противном случае возбуждается [`StopIteration`](https://python-all.ru/3.10/library/exceptions.html#StopIteration).601602#### `class object`603604Возвращает новый пустой объект. [`object`](https://python-all.ru/3.10/library/functions.html#object) является базовым для всех классов. Он содержит методы, общие для всех экземпляров классов Python. Эта функция не принимает никаких аргументов.605606> **Примечание**607>608> [`object`](https://python-all.ru/3.10/library/functions.html#object) *не* имеет [`__dict__`](https://python-all.ru/3.10/library/stdtypes.html#object.__dict__), поэтому нельзя присваивать произвольные атрибуты экземпляру класса [`object`](https://python-all.ru/3.10/library/functions.html#object).609610#### `oct(x)`611612Преобразует целое число в восьмеричную строку с префиксом «0o». Результат является допустимым выражением Python. Если *x* не является объектом Python [`int`](https://python-all.ru/3.10/library/functions.html#int), он должен определять метод `__index__()`, который возвращает целое число. Например:613614```python615>>> oct(8)616'0o10'617>>> oct(-56)618'-0o70'619```620621Если требуется преобразовать целое число в восьмеричную строку с префиксом «0o» или без него, можно воспользоваться одним из следующих способов.622623```python624>>> '%#o' % 10, '%o' % 10625('0o12', '12')626>>> format(10, '#o'), format(10, 'o')627('0o12', '12')628>>> f'{10:#o}', f'{10:o}'629('0o12', '12')630```631632См. также [`format()`](https://python-all.ru/3.10/library/functions.html#format) для получения дополнительной информации.633634>635636#### `open(file, mode='r', buffering=- 1, encoding=None, errors=None, newline=None, closefd=True, opener=None)`637638Открывает *file* и возвращает соответствующий [файловый объект](https://python-all.ru/3.10/glossary.html#term-file-object). Если файл не может быть открыт, возбуждается [`OSError`](https://python-all.ru/3.10/library/exceptions.html#OSError). См. [Чтение и запись файлов](https://python-all.ru/3.10/tutorial/inputoutput.html#tut-files) для дополнительных примеров использования этой функции.639640*file* – это [path-like object](https://python-all.ru/3.10/glossary.html#term-path-like-object), задающий путь (абсолютный или относительный относительно текущей рабочей директории) к открываемому файлу или целый файловый дескриптор оборачиваемого файла. (Если задан файловый дескриптор, он закрывается при закрытии возвращаемого объекта I/O, если только *closefd* не установлен в `False`.)641642*mode* – необязательная строка, определяющая режим открытия файла. По умолчанию `'r'`, что означает открытие для чтения в текстовом режиме. Другие распространённые значения: `'w'` для записи (усекает файл, если он уже существует), `'x'` для эксклюзивного создания и `'a'` для добавления (что на *некоторых* системах Unix означает, что *все* записи добавляются в конец файла независимо от текущей позиции поиска). В текстовом режиме, если *encoding* не указан, используемая кодировка зависит от платформы: вызывается `locale.getpreferredencoding(False)` для получения текущей кодировки локали. (Для чтения и записи сырых байтов используйте двоичный режим и оставьте *encoding* неуказанным.) Доступные режимы:643644| Символ | Значение |645| --- | --- |646| `'r'` | открытие для чтения (по умолчанию) |647| `'w'` | открытие для записи, с предварительным усечением файла |648| `'x'` | открытие для эксклюзивного создания, завершается ошибкой, если файл уже существует |649| `'a'` | открытие для записи, добавление в конец файла, если он существует |650| `'b'` | двоичный режим |651| `'t'` | текстовый режим (по умолчанию) |652| `'+'` | открытие для обновления (чтения и записи) |653654Режим по умолчанию – `'r'` (открытие для чтения текста, синоним `'rt'`). Режимы `'w+'` и `'w+b'` открывают и усекают файл. Режимы `'r+'` и `'r+b'` открывают файл без усечения.655656Как упоминалось в [Обзоре](https://python-all.ru/3.10/library/io.html#io-overview), Python различает двоичный и текстовый ввод-вывод. Файлы, открытые в двоичном режиме (включая `'b'` в аргументе *mode*), возвращают содержимое в виде объектов [`bytes`](https://python-all.ru/3.10/library/stdtypes.html#bytes) без какого-либо декодирования. В текстовом режиме (по умолчанию или когда `'t'` включён в аргумент *mode*) содержимое файла возвращается как [`str`](https://python-all.ru/3.10/library/stdtypes.html#str), при этом байты предварительно декодируются с использованием кодировки, зависящей от платформы, или указанной *encoding*, если она задана.657658Разрешён дополнительный символ режима, `'U'`, который больше не имеет никакого эффекта и считается устаревшим. Ранее он включал [универсальные символы новой строки](https://python-all.ru/3.10/glossary.html#term-universal-newlines) в текстовом режиме, что стало поведением по умолчанию в Python 3.0. Обратитесь к документации параметра [newline](https://python-all.ru/3.10/library/functions.html#open-newline-parameter) для получения дополнительных сведений.659660> **Примечание**661>662> Python не зависит от представления текстовых файлов в базовой операционной системе; вся обработка выполняется самим Python и, следовательно, не зависит от платформы.663664*buffering* – необязательное целое число для установки политики буферизации. Передайте 0 для отключения буферизации (допускается только в двоичном режиме), 1 для построчной буферизации (только в текстовом режиме) и целое число \> 1 для указания размера блока фиксированного размера в байтах. Обратите внимание, что указание размера буфера таким образом применяется к двоичному буферизованному вводу-выводу, но `TextIOWrapper` (т.е. файлы, открытые с `mode='r+'`) будут иметь другую буферизацию. Чтобы отключить буферизацию в `TextIOWrapper`, рассмотрите использование флага `write_through` для [`io.TextIOWrapper.reconfigure()`](https://python-all.ru/3.10/library/io.html#io.TextIOWrapper.reconfigure). Если аргумент *buffering* не указан, политика буферизации по умолчанию работает следующим образом:665666- Двоичные файлы буферизируются блоками фиксированного размера; размер буфера выбирается эвристически, пытаясь определить «размер блока» нижележащего устройства, и при неудаче используется [`io.DEFAULT_BUFFER_SIZE`](https://python-all.ru/3.10/library/io.html#io.DEFAULT_BUFFER_SIZE). Во многих системах размер буфера обычно составляет 4096 или 8192 байта.667- «Интерактивные» текстовые файлы (файлы, для которых [`isatty()`](https://python-all.ru/3.10/library/io.html#io.IOBase.isatty) возвращает `True`) используют построчную буферизацию. Остальные текстовые файлы используют политику, описанную выше для двоичных файлов.668669*encoding* – имя кодировки, используемой для декодирования или кодирования файла. Это следует использовать только в текстовом режиме. Кодировка по умолчанию зависит от платформы (то, что возвращает [`locale.getpreferredencoding()`](https://python-all.ru/3.10/library/locale.html#locale.getpreferredencoding)), но может использоваться любая [текстовая кодировка](https://python-all.ru/3.10/glossary.html#term-text-encoding), поддерживаемая Python. См. модуль [`codecs`](https://python-all.ru/3.10/library/codecs.html#module-codecs) для списка поддерживаемых кодировок.670671*errors* – необязательная строка, определяющая, как обрабатывать ошибки кодирования и декодирования; этот параметр нельзя использовать в двоичном режиме. Доступны различные стандартные обработчики ошибок (перечислены в разделе [Обработчики ошибок](https://python-all.ru/3.10/library/codecs.html#error-handlers)), однако также подходит любое имя обработчика, зарегистрированное с помощью [`codecs.register_error()`](https://python-all.ru/3.10/library/codecs.html#codecs.register_error). Стандартные имена включают:672673- `'strict'` – возбуждать исключение [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError) при ошибке кодирования. Значение по умолчанию `None` имеет тот же эффект.674- `'ignore'` – игнорировать ошибки. Учтите, что игнорирование ошибок кодирования может привести к потере данных.675- `'replace'` – вставляет заменяющий символ (например, `'?'`) в местах повреждённых данных.676- `'surrogateescape'` – представляет некорректные байты как суррогатные кодовые единицы в диапазоне U+DC80–U+DCFF. При записи данных эти суррогатные единицы снова преобразуются в исходные байты при использовании обработчика ошибок `surrogateescape`. Это удобно для обработки файлов с неизвестной кодировкой.677- `'xmlcharrefreplace'` поддерживается только при записи в файл. Символы, не поддерживаемые кодировкой, заменяются соответствующей XML-ссылкой на символ `&#nnn;`.678- `'backslashreplace'` заменяет повреждённые данные escape-последовательностями Python с обратной косой чертой.679- `'namereplace'` (также поддерживается только при записи) заменяет неподдерживаемые символы escape-последовательностями `\N{...}`.680681определяет, как разбирать символы новой строки из потока. Может принимать значения `None`, `''`, `'\n'`, `'\r'` и `'\r\n'`. Работает следующим образом:682683- При чтении из потока, если *newline* равен `None`, включается универсальный режим новых строк. Строки во входных данных могут заканчиваться на `'\n'`, `'\r'` или `'\r\n'`; перед возвратом вызывающему коду они преобразуются в `'\n'`. Если равен `''`, универсальный режим новых строк включён, но концы строк возвращаются как есть, без преобразования. Если задано любое другое допустимое значение, строки на входе завершаются только заданной строкой, и конец строки возвращается вызывающему коду без изменений.684- При записи в поток, если *newline* равен `None`, все символы `'\n'` преобразуются в системный разделитель строк по умолчанию [`os.linesep`](https://python-all.ru/3.10/library/os.html#os.linesep). Если *newline* равен `''` или `'\n'`, преобразование не выполняется. Если *newline* равен любому другому допустимому значению, все символы `'\n'` преобразуются в заданную строку.685686Если *closefd* равен `False` и был передан файловый дескриптор, а не имя файла, то базовый файловый дескриптор останется открытым после закрытия файла. Если передано имя файла, то *closefd* должен быть `True` (значение по умолчанию); в противном случае будет возбуждена ошибка.687688Можно задать собственный «открыватель», передав вызываемый объект как *opener*. Базовый файловый дескриптор для файлового объекта получается вызовом *opener* с аргументами (*file*, *flags*). *opener* должен вернуть открытый файловый дескриптор (передача [`os.open`](https://python-all.ru/3.10/library/os.html#os.open) в качестве *opener* даёт результат, аналогичный передаче `None`).689690Созданный файл является [ненаследуемым](https://python-all.ru/3.10/library/os.html#fd-inheritance).691692В следующем примере используется параметр [dir\_fd](https://python-all.ru/3.10/library/os.html#dir-fd) функции [`os.open()`](https://python-all.ru/3.10/library/os.html#os.open) для открытия файла относительно заданного каталога:693694```python695>>> import os696>>> dir_fd = os.open('somedir', os.O_RDONLY)697>>> def opener(path, flags):698...     return os.open(path, flags, dir_fd=dir_fd)699...700>>> with open('spamspam.txt', 'w', opener=opener) as f:701...     print('This will be written to somedir/spamspam.txt', file=f)702...703>>> os.close(dir_fd)  # не допустить утечки файлового дескриптора704```705706Тип [файлового объекта](https://python-all.ru/3.10/glossary.html#term-file-object), возвращаемого функцией [`open()`](https://python-all.ru/3.10/library/functions.html#open), зависит от режима. При использовании [`open()`](https://python-all.ru/3.10/library/functions.html#open) для открытия файла в текстовом режиме (`'w'`, `'r'`, `'wt'`, `'rt'` и т.д.) возвращается подкласс [`io.TextIOBase`](https://python-all.ru/3.10/library/io.html#io.TextIOBase) (а именно [`io.TextIOWrapper`](https://python-all.ru/3.10/library/io.html#io.TextIOWrapper)). При открытии файла в двоичном режиме с буферизацией возвращаемый класс является подклассом [`io.BufferedIOBase`](https://python-all.ru/3.10/library/io.html#io.BufferedIOBase). Конкретный класс различается: в режиме чтения в двоичном виде возвращается [`io.BufferedReader`](https://python-all.ru/3.10/library/io.html#io.BufferedReader); в режимах записи и добавления в двоичном виде – [`io.BufferedWriter`](https://python-all.ru/3.10/library/io.html#io.BufferedWriter), а в режиме чтения/записи – [`io.BufferedRandom`](https://python-all.ru/3.10/library/io.html#io.BufferedRandom). Если буферизация отключена, возвращается необработанный поток – подкласс [`io.RawIOBase`](https://python-all.ru/3.10/library/io.html#io.RawIOBase), [`io.FileIO`](https://python-all.ru/3.10/library/io.html#io.FileIO).707708См. также модули для работы с файлами: [`fileinput`](https://python-all.ru/3.10/library/fileinput.html#module-fileinput), [`io`](https://python-all.ru/3.10/library/io.html#module-io) (где объявлено [`open()`](https://python-all.ru/3.10/library/functions.html#open)), [`os`](https://python-all.ru/3.10/library/os.html#module-os), [`os.path`](https://python-all.ru/3.10/library/os.path.html#module-os.path), [`tempfile`](https://python-all.ru/3.10/library/tempfile.html#module-tempfile) и [`shutil`](https://python-all.ru/3.10/library/shutil.html#module-shutil).709710Вызывает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `open` с аргументами `file`, `mode`, `flags`.711712Аргументы `mode` и `flags` могли быть изменены или определены на основе исходного вызова.713714> Изменено в версии 3.3:715>716> - Добавлен параметр *opener*.717> - Добавлен режим `'x'`.718> - [`IOError`](https://python-all.ru/3.10/library/exceptions.html#IOError) ранее возбуждался, теперь это псевдоним [`OSError`](https://python-all.ru/3.10/library/exceptions.html#OSError).719> - Теперь возбуждается [`FileExistsError`](https://python-all.ru/3.10/library/exceptions.html#FileExistsError), если файл, открываемый в эксклюзивном режиме создания (`'x'`), уже существует.720721> Изменено в версии 3.4:722>723> - Файл теперь является ненаследуемым.724725Устарело с версии 3.4, удалено в версии 3.10: Режим `'U'`.726727> Изменено в версии 3.5:728>729> - Если системный вызов был прерван и обработчик сигнала не возбудил исключение, функция теперь повторяет системный вызов вместо возбуждения исключения [`InterruptedError`](https://python-all.ru/3.10/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.10/library/functions.html) для обоснования).730> - Добавлен обработчик ошибок `'namereplace'`.731732> Изменено в версии 3.6:733>734> - Добавлена поддержка объектов, реализующих [`os.PathLike`](https://python-all.ru/3.10/library/os.html#os.PathLike).735> - В Windows открытие консольного буфера может вернуть подкласс [`io.RawIOBase`](https://python-all.ru/3.10/library/io.html#io.RawIOBase), отличный от [`io.FileIO`](https://python-all.ru/3.10/library/io.html#io.FileIO).736737#### `ord(c)`738739Принимает строку, представляющую один символ Unicode, и возвращает целое число – кодовую точку Unicode этого символа. Например, `ord('a')` возвращает целое число `97`, а `ord('€')` (знак евро) возвращает `8364`. Это функция, обратная [`chr()`](https://python-all.ru/3.10/library/functions.html#chr).740741#### `pow(base, exp[, mod])`742743Возвращает *base* в степени *exp*; если указан *mod*, возвращает *base* в степени *exp* по модулю *mod* (вычисляется эффективнее, чем `pow(base, exp) % mod`). Двухаргументная форма `pow(base, exp)` эквивалентна использованию оператора возведения в степень: `base**exp`.744745Аргументы должны иметь числовые типы. При смешанных типах операндов применяются правила приведения для бинарных арифметических операторов. Для [`int`](https://python-all.ru/3.10/library/functions.html#int) операндов результат имеет тот же тип, что и операнды (после приведения), если только второй аргумент не отрицательный; в этом случае все аргументы преобразуются в float и возвращается результат типа float. Например, `pow(10, 2)` возвращает `100`, но `pow(10, -2)` возвращает `0.01`. Для отрицательного основания типа [`int`](https://python-all.ru/3.10/library/functions.html#int) или [`float`](https://python-all.ru/3.10/library/functions.html#float) и нецелого показателя степени возвращается комплексный результат. Например, `pow(-9, 0.5)` возвращает значение, близкое к `3j`.746747Для операндов [`int`](https://python-all.ru/3.10/library/functions.html#int) *base* и *exp*, если указан *mod*, *mod* также должен быть целого типа, и *mod* должен быть ненулевым. Если *mod* указан и *exp* отрицателен, *base* должен быть взаимно прост с *mod*. В этом случае возвращается `pow(inv_base, -exp, mod)`, где *inv\_base* – обратный элемент к *base* по модулю *mod*.748749Вот пример вычисления обратного элемента для `38` по модулю `97`:750751```python752>>> pow(38, -1, mod=97)75323754>>> 23 * 38 % 97 == 1755True756```757758Изменено в версии 3.8: Для операндов [`int`](https://python-all.ru/3.10/library/functions.html#int) трёхаргументная форма `pow` теперь допускает отрицательный второй аргумент, что позволяет вычислять обратные элементы по модулю.759760Изменено в версии 3.8: Разрешены именованные аргументы. Ранее поддерживались только позиционные аргументы.761762#### `print(*objects, sep=' ', end='\n', file=None, flush=False)`763764Выводит *objects* в текстовый поток *file*, разделённые *sep* и завершаемые *end*. *sep*, *end*, *file* и *flush*, если указаны, должны передаваться как именованные аргументы.765766Все неименованные аргументы преобразуются в строки, как [`str()`](https://python-all.ru/3.10/library/stdtypes.html#str), и записываются в поток, разделённые *sep* и завершаемые *end*. Оба *sep* и *end* должны быть строками; они также могут быть `None`, что означает использование значений по умолчанию. Если *objects* не указаны, [`print()`](https://python-all.ru/3.10/library/functions.html#print) просто запишет *end*.767768Аргумент *file* должен быть объектом с методом `write(string)`; если он не указан или равен `None`, будет использоваться [`sys.stdout`](https://python-all.ru/3.10/library/sys.html#sys.stdout). Так как выводимые аргументы преобразуются в текстовые строки, [`print()`](https://python-all.ru/3.10/library/functions.html#print) нельзя использовать с файловыми объектами в бинарном режиме. Для них используйте `file.write(...)`.769770Буферизация вывода обычно определяется *file*. Однако если *flush* равен true, поток принудительно сбрасывается.771772Изменено в версии 3.3: Добавлен именованный аргумент *flush*.773774#### `class property(fget=None, fset=None, fdel=None, doc=None)`775776Возвращает атрибут property.777778*fget* – функция для получения значения атрибута. *fset* – функция для установки значения атрибута. *fdel* – функция для удаления значения атрибута. А *doc* создаёт строку документации для атрибута.779780Типичное использование – определить управляемый атрибут `x`:781782```python783class C:784    def __init__(self):785        self._x = None786787    def getx(self):788        return self._x789790    def setx(self, value):791        self._x = value792793    def delx(self):794        del self._x795796    x = property(getx, setx, delx, "I'm the 'x' property.")797```798799Если *c* – экземпляр *C*, то `c.x` вызовет геттер, `c.x = value` вызовет сеттер, а `del c.x` – делитер.800801Если указан, *doc* будет строкой документации атрибута property. В противном случае property скопирует строку документации *fget* (если она существует). Это позволяет легко создавать свойства только для чтения, используя [`property()`](https://python-all.ru/3.10/library/functions.html#property) в качестве [декоратора](https://python-all.ru/3.10/glossary.html#term-decorator):802803```python804class Parrot:805    def __init__(self):806        self._voltage = 100000807808    @property809    def voltage(self):810        """Получить текущее напряжение."""811        return self._voltage812```813814Декоратор `@property` превращает метод `voltage()` в «геттер» для атрибута только для чтения с тем же именем и устанавливает строку документации для *voltage* в «Get the current voltage.»815816Объект property имеет методы `getter`, `setter` и `deleter`, которые можно использовать как декораторы; они создают копию свойства с соответствующей функцией доступа, установленной в декорированную функцию. Лучше всего это объяснить на примере:817818```python819class C:820    def __init__(self):821        self._x = None822823    @property824    def x(self):825        """Я – свойство 'x'."""826        return self._x827828    @x.setter829    def x(self, value):830        self._x = value831832    @x.deleter833    def x(self):834        del self._x835```836837Этот код полностью эквивалентен первому примеру. Убедитесь, что дополнительные функции имеют то же имя, что и исходное свойство (`x` в данном случае.)838839Возвращаемый объект property также имеет атрибуты `fget`, `fset` и `fdel`, соответствующие аргументам конструктора.840841Изменено в версии 3.5: Строки документации объектов property теперь доступны для записи.842843#### `class range(stop)`844845#### `class range(start, stop[, step])`846847[`range`](https://python-all.ru/3.10/library/stdtypes.html#range) – не функция, а неизменяемый тип последовательности, как описано в [Ranges](https://python-all.ru/3.10/library/stdtypes.html#typesseq-range) и [Sequence Types – list, tuple, range](https://python-all.ru/3.10/library/stdtypes.html#typesseq).848849#### `repr(object)`850851Возвращает строку, содержащую печатное представление объекта. Для многих типов эта функция пытается вернуть строку, которая при передаче в [`eval()`](https://python-all.ru/3.10/library/functions.html#eval) дала бы объект с тем же значением; в противном случае представление представляет собой строку в угловых скобках, содержащую имя типа объекта вместе с дополнительной информацией, часто включающей имя и адрес объекта. Класс может управлять тем, что эта функция возвращает для своих экземпляров, определив метод `__repr__()`. Если [`sys.displayhook()`](https://python-all.ru/3.10/library/sys.html#sys.displayhook) недоступен, эта функция вызовет [`RuntimeError`](https://python-all.ru/3.10/library/exceptions.html#RuntimeError).852853#### `reversed(seq)`854855Возвращает обратный [итератор](https://python-all.ru/3.10/glossary.html#term-iterator). *seq* должен быть объектом с методом `__reversed__()` или поддерживающим протокол последовательности (методы `__len__()` и `__getitem__()` с целочисленными аргументами, начиная с `0`).856857#### `round(number[, ndigits])`858859Возвращает *number*, округлённое до *ndigits* знаков после запятой. Если *ndigits* опущено или равно `None`, возвращается ближайшее целое к входному значению.860861Для встроенных типов, поддерживающих [`round()`](https://python-all.ru/3.10/library/functions.html#round), значения округляются до ближайшего кратного 10 в степени минус *ndigits*; если два кратных одинаково близки, округление производится в сторону чётного выбора (так, например, оба `round(0.5)` и `round(-0.5)` дают `0`, а `round(1.5)` даёт `2`). Любое целое значение допустимо для *ndigits* (положительное, нулевое или отрицательное). Возвращаемое значение – целое число, если *ndigits* опущено или равно `None`. В противном случае возвращаемое значение имеет тот же тип, что и *number*.862863Для произвольного объекта Python `number` функция `round` делегирует выполнение `number.__round__`.864865> **Примечание**866>867> Поведение [`round()`](https://python-all.ru/3.10/library/functions.html#round) для чисел с плавающей точкой может быть неожиданным: например, `round(2.675, 2)` даёт `2.67` вместо ожидаемого `2.68`. Это не ошибка: это результат того, что большинство десятичных дробей невозможно точно представить в виде числа с плавающей точкой. Подробнее см. [Арифметика с плавающей точкой: проблемы и ограничения](https://python-all.ru/3.10/tutorial/floatingpoint.html#tut-fp-issues).868869#### `class set([iterable])`870871Возвращает новый объект [`set`](https://python-all.ru/3.10/library/stdtypes.html#set), опционально с элементами, взятыми из *итерируемого объекта*. `set` – это встроенный класс. См. [`set`](https://python-all.ru/3.10/library/stdtypes.html#set) и [Типы множеств – set, frozenset](https://python-all.ru/3.10/library/stdtypes.html#types-set) для документации об этом классе.872873Для других контейнеров см. встроенные классы [`frozenset`](https://python-all.ru/3.10/library/stdtypes.html#frozenset), [`list`](https://python-all.ru/3.10/library/stdtypes.html#list), [`tuple`](https://python-all.ru/3.10/library/stdtypes.html#tuple) и [`dict`](https://python-all.ru/3.10/library/stdtypes.html#dict), а также модуль [`collections`](https://python-all.ru/3.10/library/collections.html#module-collections).874875#### `setattr(object, name, value)`876877Это аналог [`getattr()`](https://python-all.ru/3.10/library/functions.html#getattr). Аргументами являются объект, строка и произвольное значение. Строка может именовать существующий атрибут или новый атрибут. Функция присваивает значение атрибуту, если объект это позволяет. Например, `setattr(x, 'foobar', 123)` эквивалентно `x.foobar = 123`.878879*name* не обязательно должен быть идентификатором Python, как определено в [Identifiers and keywords](https://python-all.ru/3.10/reference/lexical_analysis.html#identifiers), если только объект сам не требует этого, например, в пользовательском [`__getattribute__()`](https://python-all.ru/3.10/reference/datamodel.html#object.__getattribute__) или через [`__slots__`](https://python-all.ru/3.10/reference/datamodel.html#object.__slots__). Атрибут, имя которого не является идентификатором, не будет доступен через точечную нотацию, но будет доступен через [`getattr()`](https://python-all.ru/3.10/library/functions.html#getattr) и т.д.880881> **Примечание**882>883> Поскольку [private name mangling](https://python-all.ru/3.10/reference/expressions.html#private-name-mangling) происходит на этапе компиляции, необходимо вручную исказить имя закрытого атрибута (атрибуты с двумя ведущими подчёркиваниями), чтобы задать его с помощью [`setattr()`](https://python-all.ru/3.10/library/functions.html#setattr).884885#### `class slice(stop)`886887#### `class slice(start, stop[, step])`888889Возвращает объект [среза](https://python-all.ru/3.10/glossary.html#term-slice), представляющий набор индексов, заданных `range(start, stop, step)`. Параметры *start* и *step* по умолчанию равны `None`. Объекты среза имеют атрибуты только для чтения `start`, `stop` и `step`, которые просто возвращают значения аргументов (или их значения по умолчанию). Другой явной функциональности у них нет; однако они используются NumPy и другими сторонними пакетами. Объекты среза также создаются при использовании расширенного синтаксиса индексации. Например: `a[start:stop:step]` или `a[start:stop, i]`. См. [`itertools.islice()`](https://python-all.ru/3.10/library/itertools.html#itertools.islice) для альтернативной версии, возвращающей итератор.890891#### `sorted(iterable, /, *, key=None, reverse=False)`892893Возвращает новый отсортированный список из элементов *итерируемого объекта*.894895Имеет два необязательных аргумента, которые должны быть указаны как именованные.896897*key* задаёт функцию одного аргумента, которая извлекает ключ сравнения из каждого элемента *итерируемого объекта* (например, `key=str.lower`). Значение по умолчанию – `None` (сравнивает элементы напрямую).898899*reverse* – логическое значение. Если указано `True`, то элементы списка сортируются так, как если бы каждое сравнение было обратным.900901Используйте [`functools.cmp_to_key()`](https://python-all.ru/3.10/library/functools.html#functools.cmp_to_key) для преобразования устаревшей функции *cmp* в функцию *key*.902903Встроенная функция [`sorted()`](https://python-all.ru/3.10/library/functions.html#sorted) гарантированно устойчива. Сортировка называется устойчивой, если она не меняет относительный порядок элементов, которые сравниваются как равные. Это удобно при многоуровневой сортировке (например, сначала по отделу, затем по зарплатной категории).904905Алгоритм сортировки использует только сравнения `<` между элементами. Хотя для сортировки достаточно определить метод [`__lt__()`](https://python-all.ru/3.10/reference/datamodel.html#object.__lt__), [**PEP 8**](https://python-all.ru/3.10/library/functions.html) рекомендует реализовать все шесть [расширенных сравнений](https://python-all.ru/3.10/reference/expressions.html#comparisons). Это поможет избежать ошибок при использовании тех же данных с другими средствами упорядочивания, такими как [`max()`](https://python-all.ru/3.10/library/functions.html#max), которые полагаются на другой базовый метод. Реализация всех шести сравнений также помогает избежать путаницы при сравнениях смешанных типов, которые могут вызывать отражённый метод [`__gt__()`](https://python-all.ru/3.10/reference/datamodel.html#object.__gt__).906907Примеры сортировки и краткое руководство см. в [Sorting HOW TO](https://python-all.ru/3.10/howto/sorting.html#sortinghowto).908909#### `@staticmethod`910911Преобразует метод в статический метод.912913Статический метод не получает неявный первый аргумент. Чтобы объявить статический метод, используйте такую идиому:914915```python916class C:917    @staticmethod918    def f(arg1, arg2, ...): ...919```920921Форма `@staticmethod` является функцией [декоратора](https://python-all.ru/3.10/glossary.html#term-decorator) – подробнее см. в [Function definitions](https://python-all.ru/3.10/reference/compound_stmts.html#function).922923Статический метод можно вызывать как от класса (например, `C.f()`), так и от экземпляра (например, `C().f()`). Более того, их можно вызывать как обычные функции (например, `f()`).924925Статические методы в Python похожи на статические методы в Java или C++. Также см. [`classmethod()`](https://python-all.ru/3.10/library/functions.html#classmethod) для альтернативного варианта, полезного для создания альтернативных конструкторов класса.926927Как и все декораторы, `staticmethod` можно вызвать как обычную функцию и что-то сделать с её результатом. Это необходимо в тех случаях, когда нужна ссылка на функцию из тела класса и требуется избежать автоматического преобразования в метод экземпляра. Для таких случаев используйте следующую идиому:928929```python930def regular_function():931    ...932933class C:934    method = staticmethod(regular_function)935```936937Дополнительную информацию о статических методах см. в [The standard type hierarchy](https://python-all.ru/3.10/reference/datamodel.html#types).938939Изменено в версии 3.10: Статические методы теперь наследуют атрибуты метода (`__module__`, `__name__`, `__qualname__`, `__doc__` и `__annotations__`), имеют новый атрибут `__wrapped__` и теперь могут вызываться как обычные функции.940941#### `class str(object='')`942943#### `class str(object=b'', encoding='utf-8', errors='strict')`944945Возвращает [`str`](https://python-all.ru/3.10/library/stdtypes.html#str)-версию *объекта*. Подробнее см. [`str()`](https://python-all.ru/3.10/library/stdtypes.html#str).946947`str` – это встроенный строковый [класс](https://python-all.ru/3.10/glossary.html#term-class). Общую информацию о строках см. в [Text Sequence Type – str](https://python-all.ru/3.10/library/stdtypes.html#textseq).948949#### `sum(iterable, /, start=0)`950951Суммирует *start* и элементы *итерируемого объекта* слева направо и возвращает общую сумму. Элементы *итерируемого объекта* обычно являются числами, а начальное значение не может быть строкой.952953Для некоторых случаев существуют хорошие альтернативы [`sum()`](https://python-all.ru/3.10/library/functions.html#sum). Предпочтительный и быстрый способ конкатенации последовательности строк – вызов `''.join(sequence)`. Для сложения чисел с плавающей точкой с повышенной точностью см. [`math.fsum()`](https://python-all.ru/3.10/library/math.html#math.fsum). Для конкатенации последовательности итерируемых объектов рассмотрите [`itertools.chain()`](https://python-all.ru/3.10/library/itertools.html#itertools.chain).954955Изменено в версии 3.8: Параметр *start* теперь можно указывать как именованный аргумент.956957#### `class super([type[, object-or-type]])`958959Возвращает объект-посредник, который делегирует вызовы методов родительскому или родственному классу *type*. Это полезно для доступа к унаследованным методам, которые были переопределены в классе.960961Параметр *object-or-type* определяет [порядок разрешения методов](https://python-all.ru/3.10/glossary.html#term-method-resolution-order), по которому будет производиться поиск. Поиск начинается с класса, следующего сразу за *type*.962963Например, если [`__mro__`](https://python-all.ru/3.10/library/stdtypes.html#class.__mro__) для *object-or-type* равно `D -> B -> C -> A -> object`, а значение *type* – `B`, то [`super()`](https://python-all.ru/3.10/library/functions.html#super) выполняет поиск по `C -> A -> object`.964965Атрибут [`__mro__`](https://python-all.ru/3.10/library/stdtypes.html#class.__mro__) объекта *object-or-type* содержит перечень порядка разрешения методов, используемого как [`getattr()`](https://python-all.ru/3.10/library/functions.html#getattr), так и [`super()`](https://python-all.ru/3.10/library/functions.html#super). Этот атрибут динамический и может изменяться при обновлении иерархии наследования.966967Если второй аргумент опущен, возвращается несвязанный объект super. Если второй аргумент является объектом, `isinstance(obj, type)` должно быть истинно. Если второй аргумент является типом, `issubclass(type2, type)` должно быть истинно (это полезно для методов класса).968969Существует два типичных варианта использования *super*. В иерархии классов с одиночным наследованием *super* можно использовать для ссылки на родительские классы без явного указания их имен, что делает код более поддерживаемым. Это использование тесно параллельно использованию *super* в других языках программирования.970971Второй вариант использования – поддержка кооперативного множественного наследования в динамической среде выполнения. Этот случай уникален для Python и не встречается в статически компилируемых языках или языках, поддерживающих только одиночное наследование. Это позволяет реализовать «ромбовидные диаграммы», где несколько базовых классов реализуют один и тот же метод. Хорошее проектирование требует, чтобы такие реализации имели одинаковую сигнатуру вызова во всех случаях (поскольку порядок вызовов определяется во время выполнения, поскольку этот порядок адаптируется к изменениям в иерархии классов и может включать родственные классы, неизвестные до выполнения).972973Для обоих вариантов использования типичный вызов родительского класса выглядит так:974975```python976class C(B):977    def method(self, arg):978        super().method(arg)    # Делает то же самое, что и:979                               # super(C, self).method(arg)980```981982В дополнение к поиску методов, [`super()`](https://python-all.ru/3.10/library/functions.html#super) также работает для поиска атрибутов. Один из возможных вариантов использования – вызов [дескрипторов](https://python-all.ru/3.10/glossary.html#term-descriptor) в родительском или родственном классе.983984Обратите внимание, что [`super()`](https://python-all.ru/3.10/library/functions.html#super) реализован как часть процесса связывания для явных точечных обращений к атрибутам, таких как `super().__getitem__(name)`. Это делается путём реализации собственного метода `__getattribute__()` для поиска классов в предсказуемом порядке, поддерживающем кооперативное множественное наследование. Соответственно, [`super()`](https://python-all.ru/3.10/library/functions.html#super) не определён для неявных обращений с использованием инструкций или операторов, таких как `super()[name]`.985986Также обратите внимание, что, за исключением формы без аргументов, [`super()`](https://python-all.ru/3.10/library/functions.html#super) не ограничен использованием внутри методов. Форма с двумя аргументами точно задает аргументы и создает соответствующие ссылки. Форма без аргументов работает только внутри определения класса, так как компилятор заполняет необходимые детали для правильного извлечения определяемого класса, а также для доступа к текущему экземпляру в обычных методах.987988Практические рекомендации по проектированию кооперативных классов с использованием [`super()`](https://python-all.ru/3.10/library/functions.html#super) см. в [руководстве по использованию super()](https://python-all.ru/3.10/library/functions.html).989990#### `class tuple([iterable])`991992[`tuple`](https://python-all.ru/3.10/library/stdtypes.html#tuple) на самом деле не функция, а неизменяемый тип последовательности, как описано в [Кортежи](https://python-all.ru/3.10/library/stdtypes.html#typesseq-tuple) и [Типы последовательностей – list, tuple, range](https://python-all.ru/3.10/library/stdtypes.html#typesseq).993994#### `class type(object)`995996#### `class type(name, bases, dict, **kwds)`997998С одним аргументом возвращает тип объекта *object*. Возвращаемое значение – объект типа, как правило, тот же объект, что и возвращаемый [`object.__class__`](https://python-all.ru/3.10/library/stdtypes.html#instance.__class__).9991000Встроенная функция [`isinstance()`](https://python-all.ru/3.10/library/functions.html#isinstance) рекомендуется для проверки типа объекта, поскольку она учитывает подклассы.10011002С тремя аргументами возвращает новый объект типа. По сути, это динамическая форма оператора [`class`](https://python-all.ru/3.10/reference/compound_stmts.html#class). Строка *name* – это имя класса, она становится атрибутом [`__name__`](https://python-all.ru/3.10/library/stdtypes.html#definition.__name__). Кортеж *bases* содержит базовые классы и становится атрибутом [`__bases__`](https://python-all.ru/3.10/library/stdtypes.html#class.__bases__); если он пуст, добавляется [`object`](https://python-all.ru/3.10/library/functions.html#object) – конечный базовый класс всех классов. Словарь *dict* содержит определения атрибутов и методов тела класса; он может быть скопирован или обёрнут перед тем, как стать атрибутом [`__dict__`](https://python-all.ru/3.10/library/stdtypes.html#object.__dict__). Следующие два оператора создают идентичные объекты [`type`](https://python-all.ru/3.10/library/functions.html#type):10031004```python1005>>> class X:1006...     a = 11007...1008>>> X = type('X', (), dict(a=1))1009```10101011См. также [Type Objects](https://python-all.ru/3.10/library/stdtypes.html#bltin-type-objects).10121013Именованные аргументы, переданные форме с тремя аргументами, передаются соответствующему механизму метакласса (обычно [`__init_subclass__()`](https://python-all.ru/3.10/reference/datamodel.html#object.__init_subclass__)) так же, как и ключевые слова в определении класса (кроме *metaclass*).10141015См. также [Настройка создания классов](https://python-all.ru/3.10/reference/datamodel.html#class-customization).10161017Изменено в версии 3.6: Подклассы [`type`](https://python-all.ru/3.10/library/functions.html#type), не переопределяющие `type.__new__`, больше не могут использовать форму с одним аргументом для получения типа объекта.10181019#### `vars([object])`10201021Возвращает атрибут [`__dict__`](https://python-all.ru/3.10/library/stdtypes.html#object.__dict__) для модуля, класса, экземпляра или любого другого объекта с атрибутом [`__dict__`](https://python-all.ru/3.10/library/stdtypes.html#object.__dict__).10221023Такие объекты, как модули и экземпляры, имеют обновляемый атрибут [`__dict__`](https://python-all.ru/3.10/library/stdtypes.html#object.__dict__); однако другие объекты могут иметь ограничения на запись своих атрибутов [`__dict__`](https://python-all.ru/3.10/library/stdtypes.html#object.__dict__) (например, классы используют [`types.MappingProxyType`](https://python-all.ru/3.10/library/types.html#types.MappingProxyType) для предотвращения прямых изменений словаря).10241025Без аргумента [`vars()`](https://python-all.ru/3.10/library/functions.html#vars) ведёт себя как [`locals()`](https://python-all.ru/3.10/library/functions.html#locals). Примечание: словарь locals полезен только для чтения, так как обновления словаря locals игнорируются.10261027Исключение [`TypeError`](https://python-all.ru/3.10/library/exceptions.html#TypeError) возбуждается, если указан объект, но у него нет атрибута [`__dict__`](https://python-all.ru/3.10/library/stdtypes.html#object.__dict__) (например, если его класс определяет атрибут [`__slots__`](https://python-all.ru/3.10/reference/datamodel.html#object.__slots__)).10281029#### `zip(*iterables, strict=False)`10301031Производит итерацию по нескольким итерируемым объектам параллельно, формируя кортежи с элементом из каждого.10321033Пример:10341035```python1036>>> for item in zip([1, 2, 3], ['sugar', 'spice', 'everything nice']):1037...     print(item)1038...1039(1, 'sugar')1040(2, 'spice')1041(3, 'everything nice')1042```10431044Более формально: [`zip()`](https://python-all.ru/3.10/library/functions.html#zip) возвращает итератор кортежей, где *i*-й кортеж содержит *i*-й элемент из каждого из переданных итерируемых объектов.10451046Ещё один способ представить [`zip()`](https://python-all.ru/3.10/library/functions.html#zip) – это превращение строк в столбцы и столбцов в строки. Это похоже на [транспонирование матрицы](https://python-all.ru/3.10/library/functions.html).10471048[`zip()`](https://python-all.ru/3.10/library/functions.html#zip) ленив: элементы не будут обработаны, пока по итерируемому объекту не будет выполнена итерация, например, с помощью цикла `for` или помещения в [`list`](https://python-all.ru/3.10/library/stdtypes.html#list).10491050Следует учитывать, что итерируемые объекты, передаваемые в [`zip()`](https://python-all.ru/3.10/library/functions.html#zip), могут иметь разную длину; иногда это сделано намеренно, а иногда – из-за ошибки в коде, подготовившем эти итерируемые объекты. Python предлагает три разных подхода к решению этой проблемы:10511052- По умолчанию [`zip()`](https://python-all.ru/3.10/library/functions.html#zip) останавливается, когда самый короткий итерируемый объект исчерпан. Оставшиеся элементы в более длинных итерируемых объектах игнорируются, обрезая результат до длины самого короткого:10531054  ```python1055  >>> list(zip(range(3), ['fee', 'fi', 'fo', 'fum']))1056  [(0, 'fee'), (1, 'fi'), (2, 'fo')]1057  ```1058- [`zip()`](https://python-all.ru/3.10/library/functions.html#zip) часто используется в случаях, когда предполагается, что итерируемые объекты имеют одинаковую длину. В таких случаях рекомендуется использовать параметр `strict=True`. Его вывод совпадает с обычным [`zip()`](https://python-all.ru/3.10/library/functions.html#zip):10591060  ```python1061  >>> list(zip(('a', 'b', 'c'), (1, 2, 3), strict=True))1062  [('a', 1), ('b', 2), ('c', 3)]1063  ```10641065  В отличие от поведения по умолчанию, он вызывает исключение [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError), если один итерируемый объект исчерпан раньше других:10661067  ```python1068  >>> for item in zip(range(3), ['fee', 'fi', 'fo', 'fum'], strict=True):  1069  ...     print(item)1070  ...1071  (0, 'fee')1072  (1, 'fi')1073  (2, 'fo')1074  Traceback (most recent call last):1075    ...1076  ValueError: zip() argument 2 is longer than argument 11077  ```10781079  Без аргумента `strict=True` любая ошибка, приводящая к итерируемым объектам разной длины, будет скрыта, возможно, проявившись как труднообнаруживаемая ошибка в другой части программы.1080- Более короткие итерируемые объекты могут быть дополнены постоянным значением, чтобы все итерируемые объекты имели одинаковую длину. Это делается с помощью [`itertools.zip_longest()`](https://python-all.ru/3.10/library/itertools.html#itertools.zip_longest).10811082Крайние случаи: с одним аргументом-итерируемым объектом [`zip()`](https://python-all.ru/3.10/library/functions.html#zip) возвращает итератор из 1-кортежей. Без аргументов возвращает пустой итератор.10831084Советы и хитрости:10851086- Гарантируется порядок вычисления итерируемых объектов слева направо. Это позволяет использовать идиому для группировки последовательности данных в группы длины n с помощью `zip(*[iter(s)]*n, strict=True)`. При этом *тот же самый* итератор повторяется `n` раз, так что каждый выходной кортеж содержит результат `n` вызовов итератора. Это приводит к разбиению входных данных на блоки длины n.1087- [`zip()`](https://python-all.ru/3.10/library/functions.html#zip) в сочетании с оператором `*` можно использовать для распаковки списка:10881089  ```python1090  >>> x = [1, 2, 3]1091  >>> y = [4, 5, 6]1092  >>> list(zip(x, y))1093  [(1, 4), (2, 5), (3, 6)]1094  >>> x2, y2 = zip(*zip(x, y))1095  >>> x == list(x2) and y == list(y2)1096  True1097  ```10981099Изменено в версии 3.10: Добавлен аргумент `strict`.11001101#### `__import__(name, globals=None, locals=None, fromlist=(), level=0)`11021103> **Примечание**1104>1105> Это продвинутая функция, которая не требуется в повседневном программировании на Python, в отличие от [`importlib.import_module()`](https://python-all.ru/3.10/library/importlib.html#importlib.import_module).11061107Эта функция вызывается оператором [`import`](https://python-all.ru/3.10/reference/simple_stmts.html#import). Её можно заменить (импортировав модуль [`builtins`](https://python-all.ru/3.10/library/builtins.html#module-builtins) и присвоив `builtins.__import__`), чтобы изменить семантику оператора `import`, но делать это **настоятельно** не рекомендуется, так как обычно проще использовать перехватчики импорта (см. [**PEP 302**](https://python-all.ru/3.10/library/functions.html)) для достижения тех же целей, и это не вызывает проблем с кодом, предполагающим использование реализации импорта по умолчанию. Прямое использование [`__import__()`](https://python-all.ru/3.10/library/functions.html#import__) также не рекомендуется, вместо него следует использовать [`importlib.import_module()`](https://python-all.ru/3.10/library/importlib.html#importlib.import_module).11081109Функция импортирует модуль *name*, потенциально используя переданные *globals* и *locals* для определения того, как интерпретировать имя в контексте пакета. *fromlist* задаёт имена объектов или подмодулей, которые должны быть импортированы из модуля, заданного *name*. Стандартная реализация вообще не использует свой аргумент *locals*, а *globals* использует только для определения контекста пакета оператора [`import`](https://python-all.ru/3.10/reference/simple_stmts.html#import).11101111*level* указывает, использовать ли абсолютный или относительный импорт. `0` (по умолчанию) означает только абсолютный импорт. Положительные значения *level* указывают количество родительских каталогов для поиска относительно каталога модуля, вызывающего [`__import__()`](https://python-all.ru/3.10/library/functions.html#import__) (подробнее см. [**PEP 328**](https://python-all.ru/3.10/library/functions.html)).11121113Когда переменная *name* имеет вид `package.module`, обычно возвращается пакет верхнего уровня (имя до первой точки), а *не* модуль, названный *name*. Однако, если передан непустой аргумент *fromlist*, возвращается модуль, названный *name*.11141115Например, оператор `import spam` приводит к байт-коду, напоминающему следующий код:11161117```python1118spam = __import__('spam', globals(), locals(), [], 0)1119```11201121Оператор `import spam.ham` приводит к следующему вызову:11221123```python1124spam = __import__('spam.ham', globals(), locals(), [], 0)1125```11261127Обратите внимание, как [`__import__()`](https://python-all.ru/3.10/library/functions.html#import__) возвращает модуль верхнего уровня, потому что это объект, который привязывается к имени оператором [`import`](https://python-all.ru/3.10/reference/simple_stmts.html#import).11281129С другой стороны, оператор `from spam.ham import eggs, sausage as saus` приводит к11301131```python1132_temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], 0)1133eggs = _temp.eggs1134saus = _temp.sausage1135```11361137Здесь модуль `spam.ham` возвращается из [`__import__()`](https://python-all.ru/3.10/library/functions.html#import__). Из этого объекта извлекаются имена для импорта и присваиваются соответствующим именам.11381139Если требуется просто импортировать модуль (возможно, внутри пакета) по имени, используйте [`importlib.import_module()`](https://python-all.ru/3.10/library/importlib.html#importlib.import_module).11401141Изменено в версии 3.3: Отрицательные значения *level* больше не поддерживаются (это также меняет значение по умолчанию на 0).11421143Изменено в версии 3.9: При использовании параметров командной строки [`-E`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-E) или [`-I`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-I) переменная окружения [`PYTHONCASEOK`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONCASEOK) теперь игнорируется.11441145Сноски11461147**[1](https://python-all.ru/3.10/library/functions.html#id1)**11481149Обратите внимание, что анализатор принимает только соглашение о концах строк в стиле Unix. Если вы читаете код из файла, убедитесь, что используете режим преобразования символов новой строки для преобразования концов строк в стиле Windows или Mac.1150