_thread.md

1> **Источник:** https://python-all.ru/3.7/library/_thread.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`_thread`](https://python-all.ru/3.7/library/_thread.html#module-_thread) – Низкоуровневый API для работы с потоками89---1011Этот модуль предоставляет низкоуровневые примитивы для работы с несколькими потоками (также называемыми *легковесными процессами* или *задачами*) – множеством потоков управления, разделяющих общее пространство данных. Для синхронизации предоставляются простые блокировки (также называемые *мьютексами* или *двоичными семафорами*). Модуль [`threading`](https://python-all.ru/3.7/library/threading.html#module-threading) предоставляет более простой и высокоуровневый API для работы с потоками, построенный на основе этого модуля.1213Изменено в версии 3.7: Ранее этот модуль был опциональным, теперь он всегда доступен.1415Этот модуль определяет следующие константы и функции:1617#### `exception _thread.error`1819Возникает при ошибках, связанных с потоками.2021Изменено в версии 3.3: Теперь это синоним встроенного [`RuntimeError`](https://python-all.ru/3.7/library/exceptions.html#RuntimeError).2223#### `_thread.LockType`2425Это тип объектов блокировки.2627#### `_thread.start_new_thread(function, args[, kwargs])`2829Запускает новый поток и возвращает его идентификатор. Поток выполняет функцию *function* со списком аргументов *args* (который должен быть кортежем). Необязательный аргумент *kwargs* задаёт словарь именованных аргументов. Когда функция возвращает управление, поток беззвучно завершается. Когда функция завершается из-за необработанного исключения, печатается трассировка стека, и поток завершается (но остальные потоки продолжают работу).3031#### `_thread.interrupt_main()`3233Имитирует эффект поступления сигнала [`signal.SIGINT`](https://python-all.ru/3.7/library/signal.html#signal.SIGINT) в главный поток. Поток может использовать эту функцию для прерывания главного потока.3435Если [`signal.SIGINT`](https://python-all.ru/3.7/library/signal.html#signal.SIGINT) не обрабатывается Python (установлено значение [`signal.SIG_DFL`](https://python-all.ru/3.7/library/signal.html#signal.SIG_DFL) или [`signal.SIG_IGN`](https://python-all.ru/3.7/library/signal.html#signal.SIG_IGN)), эта функция ничего не делает.3637#### `_thread.exit()`3839Вызывает исключение [`SystemExit`](https://python-all.ru/3.7/library/exceptions.html#SystemExit). Если оно не перехвачено, поток завершится без уведомления.4041#### `_thread.allocate_lock()`4243Возвращает новый объект блокировки. Методы блокировок описаны ниже. Изначально блокировка не установлена.4445#### `_thread.get_ident()`4647Возвращает «идентификатор потока» текущего потока. Это ненулевое целое число. Его значение не имеет прямого смысла; оно предназначено в качестве «магического ключа» для использования, например, в качестве индекса в словаре данных, специфичных для потока. Идентификаторы потоков могут быть повторно использованы после завершения потока и создания другого.4849#### `_thread.stack_size([size])`5051Возвращает размер стека потока, используемый при создании новых потоков. Необязательный аргумент *size* задаёт размер стека для впоследствии создаваемых потоков и должен быть равен 0 (используется платформенное или настроенное значение по умолчанию) или положительному целому числу не менее 32 768 (32 КиБ). Если *size* не указан, используется 0. Если изменение размера стека не поддерживается, возбуждается [`RuntimeError`](https://python-all.ru/3.7/library/exceptions.html#RuntimeError). Если указанный размер стека некорректен, возбуждается [`ValueError`](https://python-all.ru/3.7/library/exceptions.html#ValueError), а размер стека остаётся без изменений. 32 КиБ – это минимально поддерживаемый размер стека, достаточный для самого интерпретатора. Имейте в виду, что на некоторых платформах могут быть особые ограничения на значения размера стека, например, требование минимального размера больше 32 КиБ или выделения памяти кратно размеру системной страницы памяти – за более подробной информацией следует обращаться к документации платформы (обычно используются страницы по 4 КиБ; при отсутствии более точных сведений рекомендуется задавать размер стека кратно 4096).5253[Доступность](https://python-all.ru/3.7/library/intro.html#availability): Windows, системы с POSIX-потоками.5455#### `_thread.TIMEOUT_MAX`5657Максимальное допустимое значение параметра *timeout* для `Lock.acquire()`. Указание тайм-аута, превышающего это значение, приведёт к возбуждению [`OverflowError`](https://python-all.ru/3.7/library/exceptions.html#OverflowError).5859Новое в версии 3.2.6061Объекты блокировки имеют следующие методы:6263#### `lock.acquire(waitflag=1, timeout=-1)`6465Без необязательных аргументов этот метод захватывает блокировку безусловно, при необходимости ожидая, пока она не будет освобождена другим потоком (только один поток за раз может захватить блокировку – в этом и состоит их смысл).6667Если целочисленный аргумент *waitflag* присутствует, действие зависит от его значения: если он равен нулю, блокировка захватывается, только если её можно захватить немедленно без ожидания, тогда как если он не равен нулю, блокировка захватывается безусловно, как указано выше.6869Если аргумент с плавающей точкой *timeout* присутствует и положителен, он задаёт максимальное время ожидания в секундах перед возвратом. Отрицательное значение аргумента *timeout* задаёт неограниченное ожидание. Нельзя указать *timeout*, если *waitflag* равен нулю.7071Возвращаемое значение равно `True`, если блокировка успешно захвачена, и `False` в противном случае.7273Изменено в версии 3.2: Параметр *timeout* является новым.7475Изменено в версии 3.2: Захват блокировки теперь может прерываться сигналами на POSIX.7677#### `lock.release()`7879Освобождает блокировку. Блокировка должна быть захвачена ранее, но не обязательно тем же потоком.8081#### `lock.locked()`8283Возвращает состояние блокировки: `True`, если она захвачена каким-либо потоком, `False` в противном случае.8485В дополнение к этим методам объекты блокировки можно также использовать с помощью оператора [`with`](https://python-all.ru/3.7/reference/compound_stmts.html#with), например:8687```python88import _thread8990a_lock = _thread.allocate_lock()9192with a_lock:93    print("a_lock is locked while this executes")94```9596**Предостережения:**9798>99100- Потоки странно взаимодействуют с прерываниями: исключение [`KeyboardInterrupt`](https://python-all.ru/3.7/library/exceptions.html#KeyboardInterrupt) будет получено произвольным потоком. (Когда модуль [`signal`](https://python-all.ru/3.7/library/signal.html#module-signal) доступен, прерывания всегда направляются в главный поток.)101- Вызов [`sys.exit()`](https://python-all.ru/3.7/library/sys.html#sys.exit) или возбуждение исключения [`SystemExit`](https://python-all.ru/3.7/library/exceptions.html#SystemExit) эквивалентно вызову [`_thread.exit()`](https://python-all.ru/3.7/library/_thread.html#_thread.exit).102- Невозможно прервать метод `acquire()` для блокировки – исключение [`KeyboardInterrupt`](https://python-all.ru/3.7/library/exceptions.html#KeyboardInterrupt) возникнет после того, как блокировка будет захвачена.103- При завершении главного потока решение о том, будут ли существовать другие потоки, зависит от системы. В большинстве систем они уничтожаются без выполнения предложений [`try`](https://python-all.ru/3.7/reference/compound_stmts.html#try) … [`finally`](https://python-all.ru/3.7/reference/compound_stmts.html#finally) или вызова деструкторов объектов.104- При завершении главного потока он не выполняет никакой обычной очистки (за исключением того, что предложения [`try`](https://python-all.ru/3.7/reference/compound_stmts.html#try) … [`finally`](https://python-all.ru/3.7/reference/compound_stmts.html#finally) соблюдаются), и стандартные файлы ввода-вывода не сбрасываются.105