`_thread.md`

134 строк · 14.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.13/library/_thread.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `_thread` – Низкоуровневый API для работы с потоками89---1011Этот модуль предоставляет низкоуровневые примитивы для работы с несколькими потоками (также называемыми *легковесными процессами* или *задачами*) – множеством потоков управления, разделяющих общее пространство данных. Для синхронизации предоставляются простые блокировки (также называемые *мьютексами* или *двоичными семафорами*). Модуль [`threading`](https://python-all.ru/3.13/library/threading.html#module-threading) предоставляет более простой и высокоуровневый API для работы с потоками, построенный на основе этого модуля.1213Изменено в версии 3.7: Ранее этот модуль был опциональным, теперь он всегда доступен.1415Этот модуль определяет следующие константы и функции:1617#### `exception _thread.error`1819Возникает при ошибках, связанных с потоками.2021Изменено в версии 3.3: Теперь это синоним встроенного [`RuntimeError`](https://python-all.ru/3.13/library/exceptions.html#RuntimeError).2223#### `_thread.start_new_thread(function, args[, kwargs])`2425Запускает новый поток и возвращает его идентификатор. Поток выполняет функцию *function* со списком аргументов *args* (который должен быть кортежем). Необязательный аргумент *kwargs* задает словарь именованных аргументов.2627Когда функция завершается, поток незаметно завершается.2829Когда функция завершается необработанным исключением, вызывается [`sys.unraisablehook()`](https://python-all.ru/3.13/library/sys.html#sys.unraisablehook) для его обработки. Атрибут *object* аргумента hook равен *function*. По умолчанию печатается трассировка стека, после чего поток завершается (но другие потоки продолжают работу).3031Когда функция вызывает исключение [`SystemExit`](https://python-all.ru/3.13/library/exceptions.html#SystemExit), оно игнорируется без уведомления.3233Вызывает [событие аудита](https://python-all.ru/3.13/library/sys.html#auditing) `_thread.start_new_thread` с аргументами `function`, `args`, `kwargs`.3435Изменено в версии 3.8: Теперь для обработки необработанных исключений используется [`sys.unraisablehook()`](https://python-all.ru/3.13/library/sys.html#sys.unraisablehook).3637#### `_thread.interrupt_main(signum=signal.SIGINT, /)`3839Имитирует эффект поступления сигнала в главный поток. Поток может использовать эту функцию для прерывания главного потока, хотя нет гарантии, что прерывание произойдет немедленно.4041Если задан, *signum* – номер сигнала для имитации. Если *signum* не задан, имитируется [`signal.SIGINT`](https://python-all.ru/3.13/library/signal.html#signal.SIGINT).4243Если указанный сигнал не обрабатывается Python (установлен в [`signal.SIG_DFL`](https://python-all.ru/3.13/library/signal.html#signal.SIG_DFL) или [`signal.SIG_IGN`](https://python-all.ru/3.13/library/signal.html#signal.SIG_IGN)), эта функция ничего не делает.4445Изменено в версии 3.10: Добавлен аргумент *signum* для настройки номера сигнала.4647> **Примечание**48>49> Это не генерирует соответствующий сигнал, а планирует вызов связанного обработчика (если он существует). Если нужно действительно сгенерировать сигнал, используйте [`signal.raise_signal()`](https://python-all.ru/3.13/library/signal.html#signal.raise_signal).5051#### `_thread.exit()`5253Вызывает исключение [`SystemExit`](https://python-all.ru/3.13/library/exceptions.html#SystemExit). Если оно не перехвачено, поток завершится без уведомления.5455#### `_thread.allocate_lock()`5657Возвращает новый объект блокировки. Методы блокировок описаны ниже. Изначально блокировка не установлена.5859#### `_thread.get_ident()`6061Возвращает «идентификатор потока» текущего потока. Это ненулевое целое число. Его значение не имеет прямого смысла; оно предназначено в качестве «магического ключа» для использования, например, в качестве индекса в словаре данных, специфичных для потока. Идентификаторы потоков могут быть повторно использованы после завершения потока и создания другого.6263#### `_thread.get_native_id()`6465Возвращает нативный целочисленный идентификатор потока, назначенный ядром для текущего потока. Это неотрицательное целое число. Его значение может использоваться для уникальной идентификации данного потока в системе (пока поток не завершится, после чего значение может быть повторно использовано ОС).6667[Доступность](https://python-all.ru/3.13/library/intro.html#availability): Windows, FreeBSD, Linux, macOS, OpenBSD, NetBSD, AIX, DragonFlyBSD, GNU/kFreeBSD.6869Добавлено в версии 3.8.7071Изменено в версии 3.13: Добавлена поддержка GNU/kFreeBSD.7273#### `_thread.stack_size([size])`7475Возвращает размер стека потока, используемый при создании новых потоков. Необязательный аргумент *size* задаёт размер стека для впоследствии создаваемых потоков и должен быть равен 0 (используется платформенное или настроенное значение по умолчанию) или положительному целому числу не менее 32 768 (32 КиБ). Если *size* не указан, используется 0. Если изменение размера стека не поддерживается, возбуждается [`RuntimeError`](https://python-all.ru/3.13/library/exceptions.html#RuntimeError). Если указанный размер стека некорректен, возбуждается [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError), а размер стека остаётся без изменений. 32 КиБ – это минимально поддерживаемый размер стека, достаточный для самого интерпретатора. Имейте в виду, что на некоторых платформах могут быть особые ограничения на значения размера стека, например, требование минимального размера больше 32 КиБ или выделения памяти кратно размеру системной страницы памяти – за более подробной информацией следует обращаться к документации платформы (обычно используются страницы по 4 КиБ; при отсутствии более точных сведений рекомендуется задавать размер стека кратно 4096).7677[Доступность](https://python-all.ru/3.13/library/intro.html#availability): Windows, pthreads.7879Unix-платформы с поддержкой потоков POSIX.8081#### `_thread.TIMEOUT_MAX`8283Максимально допустимое значение для параметра *timeout* функции [`Lock.acquire`](https://python-all.ru/3.13/library/threading.html#threading.Lock.acquire). Если указать таймаут больше этого значения, будет возбуждено [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError).8485Добавлено в версии 3.2.8687Keep the old URL fragments working (see gh-89554)8889#### `class _thread.LockType`9091Это тип объектов блокировки.9293Объекты блокировки имеют следующие методы:9495#### `acquire(blocking=True, timeout=-1)`9697Без необязательных аргументов этот метод захватывает блокировку безусловно, при необходимости ожидая, пока она не будет освобождена другим потоком (только один поток за раз может захватить блокировку – в этом и состоит их смысл).9899Если присутствует аргумент *blocking*, поведение зависит от его значения: если он равен false, блокировка захватывается только в том случае, если её можно захватить немедленно без ожидания; если true, блокировка захватывается безусловно, как описано выше.100101Если присутствует вещественный аргумент *timeout* и он положителен, он задаёт максимальное время ожидания в секундах до возврата. Отрицательный *timeout* задаёт неограниченное ожидание. Нельзя задавать *timeout*, если *blocking* равен false.102103Возвращаемое значение равно `True`, если блокировка успешно захвачена, и `False` в противном случае.104105Изменено в версии 3.2: Параметр *timeout* является новым.106107Изменено в версии 3.2: Захват блокировки теперь может прерываться сигналами на POSIX.108109#### `release()`110111Освобождает блокировку. Блокировка должна быть захвачена ранее, но не обязательно тем же потоком.112113#### `locked()`114115Возвращает состояние блокировки: `True`, если она захвачена каким-либо потоком, `False` в противном случае.116117В дополнение к этим методам объекты блокировки можно также использовать с помощью оператора [`with`](https://python-all.ru/3.13/reference/compound_stmts.html#with), например:118119```python120import _thread121122a_lock = _thread.allocate_lock()123124with a_lock:125    print("a_lock is locked while this executes")126```127128**Предостережения:**129130- Прерывания всегда направляются в главный поток (исключение [`KeyboardInterrupt`](https://python-all.ru/3.13/library/exceptions.html#KeyboardInterrupt) будет получено этим потоком).131- Вызов [`sys.exit()`](https://python-all.ru/3.13/library/sys.html#sys.exit) или возбуждение исключения [`SystemExit`](https://python-all.ru/3.13/library/exceptions.html#SystemExit) эквивалентно вызову [`_thread.exit()`](https://python-all.ru/3.13/library/_thread.html#thread.exit).132- Возможность прерывания метода [`acquire()`](https://python-all.ru/3.13/library/threading.html#threading.Lock.acquire) у блокировки зависит от платформы (то есть исключение [`KeyboardInterrupt`](https://python-all.ru/3.13/library/exceptions.html#KeyboardInterrupt) возникнет немедленно, а не только после того, как блокировка будет захвачена или истечёт время операции). Прерывание возможно на POSIX, но не на Windows.133- При завершении главного потока решение о том, будут ли существовать другие потоки, зависит от системы. В большинстве систем они уничтожаются без выполнения предложений [`try`](https://python-all.ru/3.13/reference/compound_stmts.html#try) … [`finally`](https://python-all.ru/3.13/reference/compound_stmts.html#finally) или вызова деструкторов объектов.134