Hướng dẫn which module provides thread functionality in python? - mô-đun nào cung cấp chức năng luồng trong python?

Mã nguồn: lib/threading.py Lib/threading.py

Show

Mô-đun này xây dựng các giao diện luồng cấp cao hơn ở đầu mô-đun

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
2 cấp thấp hơn.

Đã thay đổi trong phiên bản 3.7: Mô -đun này được sử dụng là tùy chọn, giờ đây nó luôn có sẵn.This module used to be optional, it is now always available.

Xem thêm

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
3 cung cấp giao diện cấp cao hơn để đẩy các tác vụ vào một luồng nền mà không chặn thực thi luồng gọi, trong khi vẫn có thể truy xuất kết quả của họ khi cần thiết.

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
4 cung cấp giao diện an toàn luồng để trao đổi dữ liệu giữa các luồng đang chạy.

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
5 cung cấp một cách tiếp cận thay thế để đạt được sự đồng thời cấp độ nhiệm vụ mà không yêu cầu sử dụng nhiều luồng hệ điều hành.

Ghi chú

Trong sê -ri Python 2.x, mô -đun này chứa các tên

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
6 cho một số phương thức và chức năng. Chúng không được chấp nhận như Python 3.10, nhưng chúng vẫn được hỗ trợ để tương thích với Python 2.5 trở xuống.

Chi tiết triển khai CPython: Trong CPython, do khóa phiên dịch toàn cầu, chỉ một luồng có thể thực thi mã python cùng một lúc (mặc dù các thư viện định hướng hiệu suất nhất định có thể khắc phục giới hạn này). Nếu bạn muốn ứng dụng của mình sử dụng tốt hơn các tài nguyên tính toán của các máy đa lõi, bạn nên sử dụng

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
7 hoặc
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
8. Tuy nhiên, luồng vẫn là một mô hình thích hợp nếu bạn muốn chạy đồng thời nhiều tác vụ ràng buộc I/O.
In CPython, due to the Global Interpreter Lock, only one thread can execute Python code at once (even though certain performance-oriented libraries might overcome this limitation). If you want your application to make better use of the computational resources of multi-core machines, you are advised to use
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
7 or
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
8. However, threading is still an appropriate model if you want to run multiple I/O-bound tasks simultaneously.

Tính khả dụng: Không phải emscripten, không phải wasi.: not Emscripten, not WASI.

Mô -đun này không hoạt động hoặc không có sẵn trên các nền tảng Webassugging

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
9 và
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
0. Xem các nền tảng Webassugging để biết thêm thông tin.WebAssembly platforms for more information.

Mô -đun này xác định các chức năng sau:

Chủ đề.Active_Count () ¶active_count()

Trả về số lượng đối tượng

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
1 hiện còn sống. Số lượng được trả về bằng độ dài của danh sách được trả về bởi
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
2.

Hàm

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
3 là bí danh không dùng nữa cho chức năng này.

Chủ đề.Current_Thread ()current_thread()

Trả về đối tượng

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
1 hiện tại, tương ứng với luồng điều khiển của người gọi. Nếu luồng điều khiển của người gọi không được tạo thông qua mô -đun
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
5, một đối tượng chủ đề giả có chức năng hạn chế được trả về.

Hàm

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
6 là bí danh không dùng nữa cho hàm này.

Chủ đề.excepthook (args, /) ¶excepthook(args, /)

Xử lý ngoại lệ chưa được nâng lên bởi

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
7.

Đối số ARGS có các thuộc tính sau:

  • exc_type: loại ngoại lệ.

  • EXC_VALUE: Giá trị ngoại lệ, có thể là

    # Consume one item
    with cv:
        while not an_item_is_available():
            cv.wait()
        get_an_available_item()
    
    # Produce one item
    with cv:
        make_an_item_available()
        cv.notify()
    
    8.

  • EXC_TRACEBACK: Traceback ngoại lệ, có thể là

    # Consume one item
    with cv:
        while not an_item_is_available():
            cv.wait()
        get_an_available_item()
    
    # Produce one item
    with cv:
        make_an_item_available()
        cv.notify()
    
    8.

  • Chủ đề: Chủ đề nâng cao ngoại lệ, có thể là

    # Consume one item
    with cv:
        while not an_item_is_available():
            cv.wait()
        get_an_available_item()
    
    # Produce one item
    with cv:
        make_an_item_available()
        cv.notify()
    
    8.

Nếu exc_type là

# Consume an item
with cv:
    cv.wait_for(an_item_is_available)
    get_an_available_item()
1, ngoại lệ bị bỏ qua âm thầm. Nếu không, ngoại lệ được in ra trên
# Consume an item
with cv:
    cv.wait_for(an_item_is_available)
    get_an_available_item()
2.

Nếu chức năng này tăng một ngoại lệ,

# Consume an item
with cv:
    cv.wait_for(an_item_is_available)
    get_an_available_item()
3 được gọi để xử lý nó.

# Consume an item
with cv:
    cv.wait_for(an_item_is_available)
    get_an_available_item()
4 có thể được ghi đè để kiểm soát các trường hợp ngoại lệ chưa được thực hiện bởi
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
7 được xử lý.

Lưu trữ exc_value bằng cách sử dụng móc tùy chỉnh có thể tạo chu kỳ tham chiếu. Nó nên được xóa rõ ràng để phá vỡ chu kỳ tham chiếu khi ngoại lệ không còn cần thiết.

Lưu trữ luồng bằng cách sử dụng một móc tùy chỉnh có thể hồi sinh nó nếu nó được đặt thành một đối tượng đang được hoàn thiện. Tránh lưu trữ chủ đề sau khi móc tùy chỉnh hoàn thành để tránh phục hồi các đối tượng.

Mới trong phiên bản 3.8.

Chủ đề .__ Excepthook__¶__excepthook__

Giữ giá trị ban đầu của

# Consume an item
with cv:
    cv.wait_for(an_item_is_available)
    get_an_available_item()
4. Nó được lưu để giá trị ban đầu có thể được khôi phục trong trường hợp chúng tình cờ được thay thế bằng các đối tượng bị hỏng hoặc thay thế.

Mới trong phiên bản 3.10.

Chủ đề.get_ident () ¶get_ident()

Trả về ‘định danh luồng, của luồng hiện tại. Đây là một số nguyên khác nhau. Giá trị của nó không có ý nghĩa trực tiếp; Nó được dự định là một cookie ma thuật được sử dụng, ví dụ: Để lập chỉ mục một từ điển của dữ liệu cụ thể theo luồng. Định danh luồng có thể được tái chế khi một luồng thoát ra và một luồng khác được tạo.

Mới trong phiên bản 3.3.

Chủ đề.get_native_id () ¶get_native_id()

Trả về ID luồng tích phân gốc của luồng hiện tại được gán bởi kernel. Đây là một số nguyên không âm. Giá trị của nó có thể được sử dụng để xác định duy nhất toàn bộ hệ thống chủ đề này (cho đến khi luồng kết thúc, sau đó giá trị có thể được tái chế bởi HĐH).

Tính khả dụng: Windows, FreeBSD, Linux, MacOS, OpenBSD, NetBSD, AIX.: Windows, FreeBSD, Linux, macOS, OpenBSD, NetBSD, AIX.

Mới trong phiên bản 3.8.

Chủ đề .__ Excepthook__¶enumerate()

Giữ giá trị ban đầu của

# Consume an item
with cv:
    cv.wait_for(an_item_is_available)
    get_an_available_item()
4. Nó được lưu để giá trị ban đầu có thể được khôi phục trong trường hợp chúng tình cờ được thay thế bằng các đối tượng bị hỏng hoặc thay thế.

Mới trong phiên bản 3.10.main_thread()

Chủ đề.get_ident () ¶

Trả về ‘định danh luồng, của luồng hiện tại. Đây là một số nguyên khác nhau. Giá trị của nó không có ý nghĩa trực tiếp; Nó được dự định là một cookie ma thuật được sử dụng, ví dụ: Để lập chỉ mục một từ điển của dữ liệu cụ thể theo luồng. Định danh luồng có thể được tái chế khi một luồng thoát ra và một luồng khác được tạo.

Mới trong phiên bản 3.3.settrace(func)

Đặt hàm theo dõi cho tất cả các luồng bắt đầu từ mô -đun

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
5. FUNC sẽ được truyền đến
while not predicate():
    cv.wait()
1 cho mỗi luồng, trước khi phương thức
while not predicate():
    cv.wait()
2 của nó được gọi.

Threading.gettRace () ¶gettrace()

Nhận chức năng theo dõi như được đặt bởi

while not predicate():
    cv.wait()
3.

Mới trong phiên bản 3.10.

Chủ đề.SetProfile (Func) ¶setprofile(func)

Đặt chức năng cấu hình cho tất cả các luồng bắt đầu từ mô -đun

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
5. FUNC sẽ được truyền đến
while not predicate():
    cv.wait()
5 cho mỗi luồng, trước khi phương thức
while not predicate():
    cv.wait()
2 của nó được gọi.

Chủ đề.getprofile () ¶getprofile()

Nhận chức năng hồ sơ như được đặt bởi

while not predicate():
    cv.wait()
7.

Mới trong phiên bản 3.10.

Chủ đề.SetProfile (Func) ¶stack_size([size])

Đặt chức năng cấu hình cho tất cả các luồng bắt đầu từ mô -đun

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
5. FUNC sẽ được truyền đến
while not predicate():
    cv.wait()
5 cho mỗi luồng, trước khi phương thức
while not predicate():
    cv.wait()
2 của nó được gọi.

Chủ đề.getprofile () ¶: Windows, pthreads.

Nhận chức năng hồ sơ như được đặt bởi

while not predicate():
    cv.wait()
7.

Chủ đề.stack_size ([kích thước]) ¶

Trả về kích thước ngăn xếp luồng được sử dụng khi tạo các luồng mới. Đối số kích thước tùy chọn chỉ định kích thước ngăn xếp được sử dụng cho các luồng được tạo sau đó và phải là 0 (sử dụng nền tảng hoặc mặc định được cấu hình) hoặc giá trị số nguyên dương ít nhất là 32.768 (32 kib). Nếu kích thước không được chỉ định, 0 được sử dụng. Nếu thay đổi kích thước ngăn xếp luồng không được hỗ trợ, một
while not predicate():
    cv.wait()
8 sẽ được nâng lên. Nếu kích thước ngăn xếp được chỉ định không hợp lệ, A
while not predicate():
    cv.wait()
9 sẽ được nâng lên và kích thước ngăn xếp không biến đổi. 32 KIB hiện là giá trị kích thước ngăn xếp được hỗ trợ tối thiểu để đảm bảo đủ không gian ngăn xếp cho chính người phiên dịch. Lưu ý rằng một số nền tảng có thể có các hạn chế cụ thể đối với các giá trị cho kích thước ngăn xếp, chẳng hạn như yêu cầu kích thước ngăn xếp tối thiểu> 32 kib hoặc yêu cầu phân bổ theo bội số của kích thước trang bộ nhớ hệ thống - nên được đề cập để biết thêm thông tin (4 trang kib là phổ biến; sử dụng bội số của 4096 cho kích thước ngăn xếp là cách tiếp cận được đề xuất trong trường hợp không có thông tin cụ thể hơn).
TIMEOUT_MAX

Tính khả dụng: Windows, pthreads.

Nền tảng UNIX với hỗ trợ chủ đề POSIX.

Mô -đun này cũng xác định hằng số sau:

Chủ đề.timeout_max¶

Giá trị tối đa được phép cho tham số thời gian chờ của các hàm chặn (

maxconnections = 5
# ...
pool_sema = BoundedSemaphore(value=maxconnections)
0,
maxconnections = 5
# ...
pool_sema = BoundedSemaphore(value=maxconnections)
1,
maxconnections = 5
# ...
pool_sema = BoundedSemaphore(value=maxconnections)
2, v.v.). Chỉ định thời gian chờ lớn hơn giá trị này sẽ tăng
maxconnections = 5
# ...
pool_sema = BoundedSemaphore(value=maxconnections)
3.

Mới trong phiên bản 3.2.

Mô -đun này xác định một số lớp, được chi tiết trong các phần dưới đây.

mydata = threading.local()
mydata.x = 1

Thiết kế của mô -đun này dựa trên mô hình luồng Java. Tuy nhiên, trong đó Java tạo khóa và biến điều kiện hành vi cơ bản của mọi đối tượng, chúng là các đối tượng riêng biệt trong Python. Lớp Python từ

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
1 hỗ trợ một tập hợp con về hành vi của lớp chủ đề Java,; Hiện tại, không có ưu tiên, không có nhóm chủ đề và chủ đề không thể bị phá hủy, dừng lại, treo, tiếp tục hoặc bị gián đoạn. Các phương thức tĩnh của lớp luồng Java, khi được thực hiện, được ánh xạ tới các hàm cấp mô-đun.

Tất cả các phương pháp được mô tả dưới đây được thực thi về mặt nguyên tử. threading.local

Dữ liệu địa lý địa lý

Dữ liệu địa lý địa chỉ là dữ liệu có giá trị cụ thể của luồng. Để quản lý dữ liệu địa lý, chỉ cần tạo một thể hiện là

maxconnections = 5
# ...
pool_sema = BoundedSemaphore(value=maxconnections)
5 (hoặc một lớp con) và lưu trữ các thuộc tính trên đó:

Các giá trị của phiên bản sẽ khác nhau đối với các luồng riêng biệt.

Classthreading.local¶

Một lớp đại diện cho dữ liệu địa lý.

Để biết thêm chi tiết và các ví dụ mở rộng, hãy xem chuỗi tài liệu của mô -đun

maxconnections = 5
# ...
pool_sema = BoundedSemaphore(value=maxconnections)
6.

Đối tượng chủ đề

Lớp

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
1 đại diện cho một hoạt động được chạy trong một luồng điều khiển riêng biệt. Có hai cách để chỉ định hoạt động: bằng cách chuyển một đối tượng có thể gọi cho hàm tạo hoặc bằng cách ghi đè phương thức
while not predicate():
    cv.wait()
2 trong một lớp con. Không có phương thức nào khác (ngoại trừ hàm tạo) nên được ghi đè trong một lớp con. Nói cách khác, chỉ ghi đè các phương thức
maxconnections = 5
# ...
pool_sema = BoundedSemaphore(value=maxconnections)
9 và
while not predicate():
    cv.wait()
2 của lớp này.

Khi một đối tượng luồng được tạo, hoạt động của nó phải được bắt đầu bằng cách gọi phương thức luồng ____ ____ ____. Điều này gọi phương thức

while not predicate():
    cv.wait()
2 trong một luồng điều khiển riêng biệt.

Khi hoạt động của chủ đề được bắt đầu, chủ đề được coi là ‘còn sống. Nó ngừng sống khi phương pháp

while not predicate():
    cv.wait()
2 của nó chấm dứt - thông thường hoặc bằng cách nâng cao một ngoại lệ chưa được xử lý. Phương pháp
with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
4 kiểm tra xem luồng có còn sống hay không.

Ghi chú

Chủ đề daemon đột ngột dừng lại khi tắt máy. Tài nguyên của họ (như các tệp mở, giao dịch cơ sở dữ liệu, v.v.) không được phát hành đúng. Nếu bạn muốn các chủ đề của mình dừng lại một cách duyên dáng, hãy làm cho chúng không phải là Daemonic và sử dụng một cơ chế báo hiệu phù hợp như

def hello():
    print("hello, world")

t = Timer(30.0, hello)
t.start()  # after 30 seconds, "hello, world" will be printed
3.

Có một đối tượng chủ đề chính của người Viking; Điều này tương ứng với luồng điều khiển ban đầu trong chương trình Python. Nó không phải là một chủ đề daemon.

Có khả năng các đối tượng chủ đề giả của người Viking được tạo ra. Đây là các đối tượng chủ đề tương ứng với các chủ đề của người ngoài hành tinh, đó là các luồng điều khiển bắt đầu bên ngoài mô -đun luồng, chẳng hạn như trực tiếp từ mã C. Các đối tượng chủ đề giả có chức năng hạn chế; Họ luôn được coi là sống và daemonic, và không thể tham gia. Họ không bao giờ bị xóa, vì không thể phát hiện việc chấm dứt các chủ đề ngoài hành tinh.joined. They are never deleted, since it is impossible to detect the termination of alien threads.

Classthreading.Thread (Group = none, target = none, name = none, args = (), kwargs = {}, *, daemon = none) ¶ threading.Thread(group=None, target=None, name=None, args=(), kwargs={}, *, daemon=None)

Trình xây dựng này phải luôn luôn được gọi với các đối số từ khóa. Đối số là:

Nhóm phải là

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8; dành riêng cho phần mở rộng trong tương lai khi một lớp
def hello():
    print("hello, world")

t = Timer(30.0, hello)
t.start()  # after 30 seconds, "hello, world" will be printed
5 được thực hiện.

Mục tiêu là đối tượng có thể gọi được được gọi bằng phương thức

while not predicate():
    cv.wait()
2. Mặc định là
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, có nghĩa là không có gì được gọi.

Tên là tên chủ đề. Theo mặc định, một tên duy nhất được xây dựng theo mẫu của chủ đề n, trong đó n là một số thập phân nhỏ, hoặc chủ đề của N (mục tiêu), trong đó, mục tiêu là ____ ____78 nếu đối số đích được chỉ định.

Args là một danh sách hoặc tuple của các đối số cho việc gọi mục tiêu. Mặc định là

def hello():
    print("hello, world")

t = Timer(30.0, hello)
t.start()  # after 30 seconds, "hello, world" will be printed
9.

KWARGS là một từ điển của các đối số từ khóa cho việc gọi mục tiêu. Mặc định là

b = Barrier(2, timeout=5)

def server():
    start_server()
    b.wait()
    while True:
        connection = accept_connection()
        process_server_connection(connection)

def client():
    b.wait()
    while True:
        connection = make_connection()
        process_client_connection(connection)
0.

Nếu không phải là

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, Daemon đặt rõ ràng liệu chủ đề có phải là daemonic hay không. Nếu
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8 (mặc định), thuộc tính daemon được kế thừa từ luồng hiện tại.

Nếu lớp con ghi đè hàm tạo, nó phải đảm bảo gọi hàm tạo lớp cơ sở (

b = Barrier(2, timeout=5)

def server():
    start_server()
    b.wait()
    while True:
        connection = accept_connection()
        process_server_connection(connection)

def client():
    b.wait()
    while True:
        connection = make_connection()
        process_client_connection(connection)
3) trước khi làm bất cứ điều gì khác với luồng.

Đã thay đổi trong phiên bản 3.10: Sử dụng tên đích nếu đối số tên bị bỏ qua.Use the target name if name argument is omitted.

Đã thay đổi trong phiên bản 3.3: Đã thêm đối số daemon.Added the daemon argument.

bắt đầu()¶()

Bắt đầu hoạt động chủ đề.

Nó phải được gọi nhiều nhất một lần cho mỗi đối tượng chủ đề. Nó sắp xếp cho phương thức đối tượng

while not predicate():
    cv.wait()
2 được gọi trong một luồng điều khiển riêng biệt.

Phương pháp này sẽ tăng

while not predicate():
    cv.wait()
8 nếu được gọi nhiều hơn một lần trên cùng một đối tượng luồng.

chạy()¶()

Phương pháp đại diện cho hoạt động của chủ đề.

Bạn có thể ghi đè phương thức này trong một lớp con. Phương thức

while not predicate():
    cv.wait()
2 tiêu chuẩn gọi đối tượng có thể gọi được chuyển đến hàm tạo đối tượng là đối số đích, nếu có, với các đối số từ khóa và vị trí được lấy từ các đối số ARGS và KWARGS, tương ứng.

Sử dụng danh sách hoặc tuple làm đối số ARGS được truyền cho

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
1 có thể đạt được hiệu ứng tương tự.

Example:

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1

Tham gia (thời gian chờ = Không) ¶(timeout=None)

Đợi cho đến khi chủ đề chấm dứt. Điều này chặn luồng gọi cho đến khi luồng có phương thức

with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
5 được gọi là chấm dứt - thông thường hoặc thông qua ngoại lệ chưa được xử lý - hoặc cho đến khi thời gian chờ tùy chọn xảy ra.

Khi đối số thời gian chờ có mặt chứ không phải

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, nó sẽ là một số điểm nổi chỉ định thời gian chờ cho hoạt động tính bằng giây (hoặc phân số của chúng). Vì
with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
5 luôn trả về
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, bạn phải gọi
with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
4 sau
with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
5 để quyết định xem có thời gian chờ xảy ra hay không - nếu luồng vẫn còn sống, cuộc gọi
with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
5 đã hết thời gian.

Khi đối số thời gian chờ không có hoặc

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, thao tác sẽ chặn cho đến khi luồng kết thúc.

Một chủ đề có thể được nối nhiều lần.

with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
5 tăng
while not predicate():
    cv.wait()
8 nếu một nỗ lực được thực hiện để tham gia vào luồng hiện tại vì điều đó sẽ gây bế tắc. Nó cũng là một lỗi đối với
with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
5 một chủ đề trước khi nó được bắt đầu và cố gắng thực hiện việc nâng cao ngoại lệ tương tự.

Tên¶

Một chuỗi được sử dụng cho mục đích nhận dạng. Nó không có ngữ nghĩa. Nhiều luồng có thể được đặt cùng một tên. Tên ban đầu được đặt bởi hàm tạo.

getName () ¶ setName () ¶()setName()

API getter/setter không dùng nữa cho

with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
7; sử dụng nó trực tiếp làm tài sản thay thế.

Không dùng nữa kể từ phiên bản 3.10.

nhận dạng nhận dạng

Định danh ’luồng của chủ đề này hoặc

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8 nếu luồng chưa được bắt đầu. Đây là một số nguyên khác nhau. Xem hàm
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
01. Định danh luồng có thể được tái chế khi một luồng thoát ra và một luồng khác được tạo. Mã định danh có sẵn ngay cả sau khi chủ đề đã thoát.

native_id¶

ID luồng (

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
02) của chủ đề này, như được chỉ định bởi HĐH (kernel). Đây là một số nguyên không âm hoặc
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8 nếu chủ đề chưa được bắt đầu. Xem hàm
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
04. Giá trị này có thể được sử dụng để xác định duy nhất toàn bộ hệ thống luồng cụ thể này (cho đến khi luồng kết thúc, sau đó giá trị có thể được tái chế bởi HĐH).

Ghi chú

Tương tự như ID xử lý, ID luồng chỉ hợp lệ (được bảo đảm toàn bộ hệ thống) kể từ khi luồng được tạo cho đến khi luồng bị chấm dứt.

Tính khả dụng: Windows, FreeBSD, Linux, MacOS, OpenBSD, NetBSD, AIX, DragonFlyBSD.: Windows, FreeBSD, Linux, macOS, OpenBSD, NetBSD, AIX, DragonFlyBSD.

Mới trong phiên bản 3.8.

is_alive () ¶()

Trả lại liệu chủ đề còn sống.

Phương pháp này trả về

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 ngay trước khi phương thức
while not predicate():
    cv.wait()
2 bắt đầu cho đến khi phương thức
while not predicate():
    cv.wait()
2 chấm dứt. Hàm mô -đun
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
2 trả về danh sách tất cả các luồng còn sống.

đại sắc lý

Một giá trị boolean cho biết liệu luồng này có phải là luồng daemon hay không (

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05) hay không (
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10). Điều này phải được đặt trước khi
with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
1 được gọi, nếu không
while not predicate():
    cv.wait()
8 được nâng lên. Giá trị ban đầu của nó được kế thừa từ chủ đề tạo; Chủ đề chính không phải là một luồng daemon và do đó tất cả các luồng được tạo trong luồng chính mặc định là
def hello():
    print("hello, world")

t = Timer(30.0, hello)
t.start()  # after 30 seconds, "hello, world" will be printed
2 =
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10.

Toàn bộ chương trình Python thoát ra khi không còn chủ đề không phải là Daemon.

isdaemon () ¶ setdaemon () ¶()setDaemon()

API getter/setter không dùng nữa cho

def hello():
    print("hello, world")

t = Timer(30.0, hello)
t.start()  # after 30 seconds, "hello, world" will be printed
2; sử dụng nó trực tiếp làm tài sản thay thế.

Không dùng nữa kể từ phiên bản 3.10.

Khóa đối tượng

Một khóa nguyên thủy là một nguyên thủy đồng bộ hóa không thuộc sở hữu của một luồng cụ thể khi bị khóa. Trong Python, hiện tại nó là nguyên thủy đồng bộ hóa cấp thấp nhất có sẵn, được triển khai trực tiếp bởi mô -đun mở rộng

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
2.

Một khóa nguyên thủy nằm ở một trong hai tiểu bang, khóa đã khóa hoặc mở khóa. Nó được tạo ra ở trạng thái không khóa. Nó có hai phương pháp cơ bản,

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 và
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18. Khi trạng thái được mở khóa,
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 thay đổi trạng thái bị khóa và trả lại ngay lập tức. Khi trạng thái bị khóa,
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 sẽ chặn cho đến khi cuộc gọi đến
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 trong một luồng khác thay đổi nó thành mở khóa, thì cuộc gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 đặt lại cho nó bị khóa và trả về. Phương pháp
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 chỉ nên được gọi ở trạng thái bị khóa; Nó thay đổi trạng thái thành mở khóa và trả lại ngay lập tức. Nếu một nỗ lực được thực hiện để phát hành khóa không khóa,
while not predicate():
    cv.wait()
8 sẽ được nâng lên.

Khóa cũng hỗ trợ giao thức quản lý bối cảnh.context management protocol.

Khi có nhiều hơn một luồng bị chặn trong

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 chờ trạng thái chuyển sang mở khóa, chỉ có một luồng tiến hành khi cuộc gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 đặt lại trạng thái để mở khóa; Một trong những chủ đề đang chờ tiến hành không được xác định và có thể thay đổi giữa các triển khai.

Tất cả các phương pháp được thực thi về mặt nguyên tử.

Classthreading.Lock¶ threading.Lock

Lớp thực hiện các đối tượng khóa nguyên thủy. Khi một luồng đã có được một khóa, các nỗ lực tiếp theo để có được khối nó, cho đến khi nó được phát hành; Bất kỳ chủ đề có thể phát hành nó.

Lưu ý rằng

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
27 thực sự là một chức năng nhà máy trả về một phiên bản hiệu quả nhất của lớp khóa bê tông được hỗ trợ bởi nền tảng.

có được (chặn = true, thời gian chờ = -1) ¶(blocking=True, timeout=- 1)

Có được một khóa, chặn hoặc không chặn.

Khi được gọi với đối số chặn được đặt thành

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 (mặc định), chặn cho đến khi khóa được mở khóa, sau đó đặt nó thành khóa và trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05.

Khi được gọi với đối số chặn được đặt thành

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10, không chặn. Nếu một cuộc gọi với chặn được đặt thành
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 sẽ chặn, hãy trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10 ngay lập tức; Nếu không, đặt khóa thành khóa và trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05.

Khi được gọi với đối số thời gian chờ điểm nổi được đặt thành giá trị dương, khối trong nhiều nhất số giây được chỉ định bởi thời gian chờ và miễn là khóa không thể có được. Một đối số thời gian chờ của

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
34 chỉ định một sự chờ đợi không giới hạn. Nó bị cấm chỉ định thời gian chờ khi chặn là
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10.

Giá trị trả về là

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 nếu khóa được thu được thành công,
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10 nếu không (ví dụ: nếu thời gian chờ hết hạn).

Đã thay đổi trong phiên bản 3.2: Tham số thời gian chờ là mới.The timeout parameter is new.

Đã thay đổi trong phiên bản 3.2: Việc thu nhận khóa hiện có thể bị gián đoạn bởi các tín hiệu trên POSIX nếu việc triển khai luồng cơ bản hỗ trợ nó.Lock acquisition can now be interrupted by signals on POSIX if the underlying threading implementation supports it.

phóng thích()¶()

Phát hành khóa. Điều này có thể được gọi từ bất kỳ chủ đề nào, không chỉ các luồng đã có được khóa.

Khi khóa được khóa, đặt lại để mở khóa và quay lại. Nếu bất kỳ luồng nào khác bị chặn chờ khóa được mở khóa, hãy cho phép chính xác một trong số chúng tiến hành.

Khi được gọi trên một khóa không khóa, một

while not predicate():
    cv.wait()
8 được nâng lên.

Không có giá trị quay lại.

bị khóa () ¶()

Trả lại

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 nếu khóa được thu thập.

Đối tượng rlock

Khóa reentrant là một nguyên thủy đồng bộ hóa có thể có được nhiều lần bởi cùng một luồng. Trong nội bộ, nó sử dụng các khái niệm về việc sở hữu chủ đề của người Hồi giáo và cấp độ đệ quy, ngoài trạng thái bị khóa/mở khóa được sử dụng bởi các khóa nguyên thủy. Ở trạng thái bị khóa, một số chủ đề sở hữu khóa; Trong trạng thái mở khóa, không có chủ đề sở hữu nó.

Để khóa khóa, một luồng gọi phương thức

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 của nó; Điều này trả về một khi luồng sở hữu khóa. Để mở khóa khóa, một luồng gọi phương thức
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 của nó. ________ 117/________ 118 Các cặp cuộc gọi có thể được lồng; Chỉ có
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 cuối cùng (
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 của cặp ngoài cùng) đặt lại khóa để mở khóa và cho phép một luồng khác bị chặn trong
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 để tiến hành.

Khóa reentrant cũng hỗ trợ giao thức quản lý bối cảnh.context management protocol.

Lớp học.Rlock¶threading.RLock

Lớp này thực hiện các đối tượng khóa Reentrant. Một khóa reentrant phải được phát hành bởi chủ đề có được nó. Khi một luồng đã có được một khóa reentrant, cùng một luồng có thể có được nó một lần nữa mà không chặn; Chủ đề phải phát hành nó một lần cho mỗi lần nó có được nó.

Lưu ý rằng

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
47 thực sự là một chức năng nhà máy trả về một phiên bản hiệu quả nhất của lớp rlock cụ thể được hỗ trợ bởi nền tảng.

có được (chặn = true, thời gian chờ = -1) ¶(blocking=True, timeout=- 1)

Có được một khóa, chặn hoặc không chặn.

Khi được gọi mà không có đối số: Nếu chủ đề này đã sở hữu khóa, hãy tăng mức đệ quy và trở lại ngay lập tức. Nếu không, nếu một luồng khác sở hữu khóa, chặn cho đến khi khóa được mở khóa. Khi khóa được mở khóa (không thuộc sở hữu của bất kỳ chủ đề nào), sau đó lấy quyền sở hữu, đặt mức đệ quy thành một và trả lại. Nếu nhiều hơn một luồng bị chặn chờ cho đến khi khóa được mở khóa, chỉ có một luồng có thể có được quyền sở hữu khóa. Không có giá trị trả lại trong trường hợp này.

Khi được gọi với đối số chặn được đặt thành

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05, hãy làm điều tương tự như khi được gọi mà không có đối số và trả về
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05.

Khi được gọi với đối số chặn được đặt thành

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10, không chặn. Nếu một cuộc gọi không có đối số sẽ chặn, hãy trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10 ngay lập tức; Nếu không, hãy làm điều tương tự như khi được gọi mà không có đối số và trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05.

Khi được gọi với đối số thời gian chờ điểm nổi được đặt thành giá trị dương, khối trong nhiều nhất số giây được chỉ định bởi thời gian chờ và miễn là khóa không thể có được. Trả lại

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 Nếu khóa đã được mua,
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10 nếu thời gian chờ đã trôi qua.

Đã thay đổi trong phiên bản 3.2: Tham số thời gian chờ là mới.The timeout parameter is new.

phóng thích()¶()

Phát hành khóa, giảm mức đệ quy. Nếu sau khi giảm, nó bằng không, hãy đặt lại khóa để mở khóa (không thuộc sở hữu của bất kỳ luồng nào) và nếu bất kỳ luồng nào khác bị chặn chờ khóa được mở khóa, hãy cho phép chính xác một trong số chúng tiến hành. Nếu sau khi giảm mức đệ quy vẫn còn khác, thì khóa vẫn bị khóa và sở hữu bởi luồng gọi.

Chỉ gọi phương thức này khi luồng gọi sở hữu khóa. Một

while not predicate():
    cv.wait()
8 được nâng lên nếu phương thức này được gọi khi khóa được mở khóa.

Không có giá trị quay lại.

Đối tượng điều kiện lor

Một biến điều kiện luôn được liên kết với một số loại khóa; Điều này có thể được thông qua hoặc một sẽ được tạo theo mặc định. Vượt qua một trong là hữu ích khi một số biến điều kiện phải chia sẻ cùng một khóa. Khóa là một phần của đối tượng điều kiện: bạn không phải theo dõi nó một cách riêng biệt.

Một biến điều kiện tuân theo giao thức quản lý bối cảnh: Sử dụng câu lệnh

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
56 có được khóa liên quan trong suốt thời lượng của khối kèm theo. Các phương thức
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 và
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 cũng gọi các phương thức tương ứng của khóa liên quan.context management protocol: using the
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
56 statement acquires the associated lock for the duration of the enclosed block. The
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 and
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 methods also call the corresponding methods of the associated lock.

Các phương pháp khác phải được gọi với khóa liên kết được giữ. Phương thức

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 giải phóng khóa, và sau đó chặn cho đến khi một luồng khác đánh thức nó bằng cách gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 hoặc
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
61. Sau khi đánh thức,
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 lại mua lại khóa và trả lại. Cũng có thể chỉ định thời gian chờ.

Phương pháp

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 đánh thức một trong các luồng đang chờ biến điều kiện, nếu có đang chờ. Phương pháp
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
61 đánh thức tất cả các luồng đang chờ biến điều kiện.

Lưu ý: Các phương thức

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 và
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
61 don don phát hành khóa; Điều này có nghĩa là các luồng hoặc luồng được đánh thức sẽ không trở lại từ cuộc gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 của họ ngay lập tức, mà chỉ khi chủ đề gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 hoặc
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
61 cuối cùng đã từ bỏ quyền sở hữu khóa.

Kiểu lập trình điển hình sử dụng các biến điều kiện sử dụng khóa để đồng bộ hóa quyền truy cập vào một số trạng thái chung; Các chủ đề quan tâm đến một sự thay đổi cụ thể của cuộc gọi trạng thái

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 liên tục cho đến khi họ nhìn thấy trạng thái mong muốn, trong khi các luồng sửa đổi trạng thái gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 hoặc
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
61 khi chúng thay đổi trạng thái theo cách có thể là trạng thái mong muốn đối với một trong những người phục vụ bàn. Ví dụ, mã sau đây là tình huống người tiêu dùng nhà sản xuất chung với dung lượng bộ đệm không giới hạn:

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()

Vòng lặp

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
73 Kiểm tra điều kiện ứng dụng là cần thiết vì
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 có thể quay lại sau một thời gian dài tùy ý và điều kiện khiến cuộc gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 có thể không còn đúng nữa. Điều này là vốn có của lập trình đa luồng. Phương pháp
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
76 có thể được sử dụng để tự động hóa việc kiểm tra điều kiện và giảm bớt tính toán thời gian chờ:

# Consume an item
with cv:
    cv.wait_for(an_item_is_available)
    get_an_available_item()

Để lựa chọn giữa

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 và
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
61, hãy xem xét liệu một thay đổi trạng thái có thể thú vị đối với chỉ một hoặc một số luồng chờ hay không. Ví dụ. Trong một tình huống tiêu chuẩn nhà sản xuất điển hình, việc thêm một mặt hàng vào bộ đệm chỉ cần đánh thức một luồng người tiêu dùng.

Classthreading.Condition (Lock = none) ¶ threading.Condition(lock=None)

Lớp này thực hiện các đối tượng biến điều kiện. Một biến điều kiện cho phép một hoặc nhiều luồng chờ đợi cho đến khi chúng được thông báo bởi một luồng khác.

Nếu đối số khóa được đưa ra chứ không phải

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, thì đó phải là đối tượng
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
27 hoặc
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
47 và nó được sử dụng làm khóa bên dưới. Mặt khác, một đối tượng
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
47 mới được tạo và sử dụng làm khóa bên dưới.

Thay đổi trong phiên bản 3.3: Thay đổi từ chức năng nhà máy sang một lớp.changed from a factory function to a class.

có được (*args) ¶(*args)

Có được khóa cơ bản. Phương pháp này gọi phương thức tương ứng trên khóa bên dưới; Giá trị trả về là bất cứ điều gì phương thức đó trả về.

phóng thích()¶()

Phát hành khóa cơ bản. Phương pháp này gọi phương thức tương ứng trên khóa bên dưới; không có giá trị quay lại.

Đợi (thời gian chờ = Không) ¶(timeout=None)

Chờ cho đến khi được thông báo hoặc cho đến khi thời gian chờ xảy ra. Nếu luồng cuộc gọi không có được khóa khi phương thức này được gọi, một

while not predicate():
    cv.wait()
8 sẽ được nâng lên.

Phương pháp này phát hành khóa bên dưới, và sau đó chặn cho đến khi nó được đánh thức bởi một cuộc gọi

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 hoặc
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
61 cho cùng một biến điều kiện trong một luồng khác hoặc cho đến khi thời gian chờ tùy chọn xảy ra. Sau khi đánh thức hoặc hẹn giờ, nó lại mua lại khóa và trả lại.

Khi đối số thời gian chờ có mặt chứ không phải

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, nó sẽ là một số điểm nổi chỉ định thời gian chờ cho hoạt động tính bằng giây (hoặc phân số của chúng).

Khi khóa bên dưới là

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
47, nó không được phát hành bằng phương pháp
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 của nó, vì điều này có thể không thực sự mở khóa khóa khi nó được thu nhận nhiều lần. Thay vào đó, một giao diện nội bộ của lớp
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
47 được sử dụng, điều này thực sự mở ra nó ngay cả khi nó đã được thu nhận một cách đệ quy nhiều lần. Một giao diện bên trong khác sau đó được sử dụng để khôi phục mức độ đệ quy khi khóa được phản ứng lại.

Giá trị trả về là

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 trừ khi hết thời gian chờ đã hết, trong trường hợp đó là
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10.

Đã thay đổi trong phiên bản 3.2: Trước đây, phương thức luôn được trả về

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8.Previously, the method always returned
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8.

Wait_for (vị từ, thời gian chờ = Không) ¶(predicate, timeout=None)

Đợi cho đến khi một điều kiện đánh giá là đúng. Vị từ phải là một cuộc gọi có thể gọi mà kết quả sẽ được hiểu là giá trị boolean. Một thời gian chờ có thể được cung cấp cho thời gian tối đa để chờ đợi.

Phương pháp tiện ích này có thể gọi

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 liên tục cho đến khi vị ngữ được thỏa mãn hoặc cho đến khi thời gian chờ xảy ra. Giá trị trả về là giá trị trả về cuối cùng của vị ngữ và sẽ đánh giá thành
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10 nếu phương thức hết thời gian.

Bỏ qua tính năng thời gian chờ, gọi phương thức này gần như tương đương với việc viết:

while not predicate():
    cv.wait()

Do đó, các quy tắc tương tự được áp dụng như với

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59: Khóa phải được giữ khi được gọi và được mua lại khi trả lại. Các vị ngữ được đánh giá với khóa giữ.

Mới trong phiên bản 3.2.

Thông báo (n = 1)(n=1)

Theo mặc định, đánh thức một chủ đề chờ đợi điều kiện này, nếu có. Nếu luồng cuộc gọi không có được khóa khi phương thức này được gọi, một

while not predicate():
    cv.wait()
8 sẽ được nâng lên.

Phương pháp này thức dậy nhiều nhất n của các luồng đang chờ biến điều kiện; Đó là một không có nếu không có chủ đề đang chờ đợi.

Việc triển khai hiện tại thức dậy chính xác n chủ đề, nếu ít nhất n chủ đề đang chờ. Tuy nhiên, nó không an toàn để dựa vào hành vi này. Một tương lai, việc thực hiện tối ưu hóa đôi khi có thể thức dậy nhiều hơn n chủ đề.

Lưu ý: Một luồng đánh thức không thực sự quay lại từ cuộc gọi

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 của nó cho đến khi nó có thể làm lại khóa. Vì
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60 không giải phóng khóa, nên người gọi của nó nên.

notify_all () ¶()

Thức dậy tất cả các chủ đề đang chờ đợi điều kiện này. Phương pháp này hoạt động như

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
60, nhưng đánh thức tất cả các luồng chờ thay vì một. Nếu luồng cuộc gọi không có được khóa khi phương thức này được gọi, một
while not predicate():
    cv.wait()
8 sẽ được nâng lên.

Phương pháp

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
01 là bí danh không dùng nữa cho phương pháp này.

Đối tượng semaphore

Đây là một trong những nguyên thủy đồng bộ hóa lâu đời nhất trong lịch sử khoa học máy tính, được phát minh bởi nhà khoa học máy tính đầu tiên của Hà Lan Edsger W. Dijkstra (ông đã sử dụng tên

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
02 và
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
03 thay vì
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 và
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18).

Một semaphore quản lý một bộ đếm nội bộ bị giảm bởi mỗi cuộc gọi

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 và được tăng lên bởi mỗi cuộc gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18. Bộ đếm không bao giờ có thể xuống dưới 0; Khi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 thấy rằng nó bằng không, nó sẽ chặn, chờ cho đến khi một số luồng khác gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18.

Semaphores cũng hỗ trợ giao thức quản lý bối cảnh.context management protocol.

Classthreading.Semaphore (value = 1) ¶ threading.Semaphore(value=1)

Lớp này thực hiện các đối tượng Semaphore. Một semaphore quản lý một bộ đếm nguyên tử đại diện cho số lượng

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 gọi trừ số lượng cuộc gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17, cộng với giá trị ban đầu. Phương pháp
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 khối nếu cần thiết cho đến khi nó có thể quay lại mà không làm cho bộ đếm âm. Nếu không được đưa ra, giá trị mặc định là 1.

Đối số tùy chọn cho giá trị ban đầu cho bộ đếm nội bộ; Nó mặc định là

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
13. Nếu giá trị được đưa ra nhỏ hơn 0,
while not predicate():
    cv.wait()
9 sẽ được nâng lên.

Thay đổi trong phiên bản 3.3: Thay đổi từ chức năng nhà máy sang một lớp.changed from a factory function to a class.

có được (chặn = true, thời gian chờ = none) ¶(blocking=True, timeout=None)

Có được một semaphore.

Khi được gọi mà không có tranh luận:

  • Nếu bộ đếm bên trong lớn hơn 0 khi nhập, hãy giảm một và trả về

    >>> from threading import Thread
    >>> t = Thread(target=print, args=[1])
    >>> t.run()
    1
    >>> t = Thread(target=print, args=(1,))
    >>> t.run()
    1
    
    05 ngay lập tức.

  • Nếu bộ đếm bên trong bằng không trên mục nhập, hãy chặn cho đến khi đánh thức bằng một cuộc gọi đến

    >>> from threading import Thread
    >>> t = Thread(target=print, args=[1])
    >>> t.run()
    1
    >>> t = Thread(target=print, args=(1,))
    >>> t.run()
    1
    
    18. Sau khi đánh thức (và bộ đếm lớn hơn 0), giảm bộ đếm xuống 1 và trả về
    >>> from threading import Thread
    >>> t = Thread(target=print, args=[1])
    >>> t.run()
    1
    >>> t = Thread(target=print, args=(1,))
    >>> t.run()
    1
    
    05. Chính xác một chủ đề sẽ bị đánh thức bởi mỗi cuộc gọi đến
    >>> from threading import Thread
    >>> t = Thread(target=print, args=[1])
    >>> t.run()
    1
    >>> t = Thread(target=print, args=(1,))
    >>> t.run()
    1
    
    18. Thứ tự mà các chủ đề bị đánh thức không nên dựa vào.

Khi được gọi bằng chặn được đặt thành

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10, không chặn. Nếu một cuộc gọi không có đối số sẽ chặn, hãy trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10 ngay lập tức; Nếu không, hãy làm điều tương tự như khi được gọi mà không có đối số và trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05.

Khi được gọi với thời gian chờ khác với

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, nó sẽ chặn trong hầu hết các giây thời gian chờ. Nếu việc mua lại không hoàn thành thành công trong khoảng đó, hãy trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10. Trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 nếu không.

Đã thay đổi trong phiên bản 3.2: Tham số thời gian chờ là mới.The timeout parameter is new.

giải phóng (n = 1)(n=1)

Phát hành một semaphore, tăng bộ đếm nội bộ của n. Khi nó bằng không khi nhập và các chủ đề khác đang chờ nó trở nên lớn hơn 0 một lần nữa, hãy đánh thức n của các luồng đó.

Đã thay đổi trong phiên bản 3.9: Đã thêm tham số N để phát hành nhiều luồng chờ cùng một lúc.Added the n parameter to release multiple waiting threads at once.

Classthreading.boundedSemaphore (value = 1) ¶ threading.BoundedSemaphore(value=1)

Lớp thực hiện các đối tượng semaphore bị ràng buộc. Một semaphore bị ràng buộc kiểm tra để đảm bảo giá trị hiện tại của nó không vượt quá giá trị ban đầu. Nếu có,

while not predicate():
    cv.wait()
9 được nâng lên. Trong hầu hết các tình huống, Semaphores được sử dụng để bảo vệ các nguồn lực với năng lực hạn chế. Nếu semaphore được phát hành quá nhiều lần thì đó là một dấu hiệu của một lỗi. Nếu không được đưa ra, giá trị mặc định là 1.

Thay đổi trong phiên bản 3.3: Thay đổi từ chức năng nhà máy sang một lớp.changed from a factory function to a class.

có được (chặn = true, thời gian chờ = none) ¶

Có được một semaphore.

maxconnections = 5
# ...
pool_sema = BoundedSemaphore(value=maxconnections)

Khi được gọi mà không có tranh luận:

with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()

Nếu bộ đếm bên trong lớn hơn 0 khi nhập, hãy giảm một và trả về

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 ngay lập tức.

Nếu bộ đếm bên trong bằng không trên mục nhập, hãy chặn cho đến khi đánh thức bằng một cuộc gọi đến >>> from threading import Thread >>> t = Thread(target=print, args=[1]) >>> t.run() 1 >>> t = Thread(target=print, args=(1,)) >>> t.run() 1 18. Sau khi đánh thức (và bộ đếm lớn hơn 0), giảm bộ đếm xuống 1 và trả về >>> from threading import Thread >>> t = Thread(target=print, args=[1]) >>> t.run() 1 >>> t = Thread(target=print, args=(1,)) >>> t.run() 1 05. Chính xác một chủ đề sẽ bị đánh thức bởi mỗi cuộc gọi đến >>> from threading import Thread >>> t = Thread(target=print, args=[1]) >>> t.run() 1 >>> t = Thread(target=print, args=(1,)) >>> t.run() 1 18. Thứ tự mà các chủ đề bị đánh thức không nên dựa vào.

Khi được gọi bằng chặn được đặt thành

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10, không chặn. Nếu một cuộc gọi không có đối số sẽ chặn, hãy trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10 ngay lập tức; Nếu không, hãy làm điều tương tự như khi được gọi mà không có đối số và trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05.

Khi được gọi với thời gian chờ khác với

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, nó sẽ chặn trong hầu hết các giây thời gian chờ. Nếu việc mua lại không hoàn thành thành công trong khoảng đó, hãy trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10. Trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 nếu không.

Đã thay đổi trong phiên bản 3.2: Tham số thời gian chờ là mới.threading.Event

giải phóng (n = 1)

Thay đổi trong phiên bản 3.3: Thay đổi từ chức năng nhà máy sang một lớp.changed from a factory function to a class.

có được (chặn = true, thời gian chờ = none) ¶()

Có được một semaphore.

Khi được gọi mà không có tranh luận:

Nếu bộ đếm bên trong lớn hơn 0 khi nhập, hãy giảm một và trả về
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 ngay lập tức.
()

Nếu bộ đếm bên trong bằng không trên mục nhập, hãy chặn cho đến khi đánh thức bằng một cuộc gọi đến

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18. Sau khi đánh thức (và bộ đếm lớn hơn 0), giảm bộ đếm xuống 1 và trả về
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05. Chính xác một chủ đề sẽ bị đánh thức bởi mỗi cuộc gọi đến
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18. Thứ tự mà các chủ đề bị đánh thức không nên dựa vào.

Khi được gọi bằng chặn được đặt thành
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10, không chặn. Nếu một cuộc gọi không có đối số sẽ chặn, hãy trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10 ngay lập tức; Nếu không, hãy làm điều tương tự như khi được gọi mà không có đối số và trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05.
()

Khi được gọi với thời gian chờ khác với

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, nó sẽ chặn trong hầu hết các giây thời gian chờ. Nếu việc mua lại không hoàn thành thành công trong khoảng đó, hãy trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
10. Trả lại
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 nếu không.

Đã thay đổi trong phiên bản 3.2: Tham số thời gian chờ là mới.(timeout=None)

giải phóng (n = 1)

Khi đối số thời gian chờ có mặt chứ không phải

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8, nó sẽ là một số điểm nổi chỉ định thời gian chờ cho hoạt động tính bằng giây (hoặc phân số của chúng).

Phương thức này trả về

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 khi và chỉ khi cờ bên trong được đặt thành true, trước khi cuộc gọi chờ hoặc sau khi chờ đợi, do đó, nó sẽ luôn quay lại ____105 trừ khi hết thời gian chờ và hết thời gian hoạt động.

Đã thay đổi trong phiên bản 3.1: Trước đây, phương thức luôn được trả về

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8.Previously, the method always returned
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8.

Đối tượng hẹn giờ

Lớp này đại diện cho một hành động chỉ nên được chạy sau một khoảng thời gian nhất định đã trôi qua - một bộ đếm thời gian.

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
43 là một lớp con của
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
1 và như vậy cũng có chức năng như một ví dụ về việc tạo các luồng tùy chỉnh.

Bộ định thời được bắt đầu, như với các chủ đề, bằng cách gọi phương thức

with pool_sema:
    conn = connectdb()
    try:
        # ... use connection ...
    finally:
        conn.close()
1 của chúng. Bộ hẹn giờ có thể được dừng (trước khi hành động của nó đã bắt đầu) bằng cách gọi phương thức
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
46. Khoảng thời gian của bộ hẹn giờ sẽ đợi trước khi thực hiện hành động của nó có thể không giống hệt như khoảng thời gian được chỉ định bởi người dùng.

Ví dụ:

def hello():
    print("hello, world")

t = Timer(30.0, hello)
t.start()  # after 30 seconds, "hello, world" will be printed

Classthreading.Timer (khoảng thời gian, hàm, args = none, kwargs = none) ¶ threading.Timer(interval, function, args=None, kwargs=None)

Tạo một bộ đếm thời gian sẽ chạy chức năng với các đối số tranh luận và từ khóa đối số kwargs, sau khi khoảng giây đã trôi qua. Nếu Args là

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8 (mặc định) thì một danh sách trống sẽ được sử dụng. Nếu kwargs là
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
8 (mặc định) thì một dict trống sẽ được sử dụng.

Thay đổi trong phiên bản 3.3: Thay đổi từ chức năng nhà máy sang một lớp.changed from a factory function to a class.

sự hủy bỏ()¶()

Dừng bộ đếm thời gian và hủy bỏ việc thực hiện hành động hẹn giờ. Điều này sẽ chỉ hoạt động nếu bộ đếm thời gian vẫn đang trong giai đoạn chờ đợi.

Đối tượng rào cản

Mới trong phiên bản 3.2.

Lớp này cung cấp một nguyên thủy đồng bộ hóa đơn giản để sử dụng bởi một số lượng cố định các luồng cần phải đợi nhau. Mỗi luồng cố gắng vượt qua rào cản bằng cách gọi phương thức

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 và sẽ chặn cho đến khi tất cả các luồng đã thực hiện các cuộc gọi
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 của họ. Tại thời điểm này, các chủ đề được phát hành đồng thời.

Rào cản có thể được sử dụng lại bất kỳ số lần cho cùng một số lượng chủ đề.

Ví dụ, đây là một cách đơn giản để đồng bộ hóa luồng máy khách và máy chủ:

b = Barrier(2, timeout=5)

def server():
    start_server()
    b.wait()
    while True:
        connection = accept_connection()
        process_server_connection(connection)

def client():
    b.wait()
    while True:
        connection = make_connection()
        process_client_connection(connection)

Classthreading.Barrier (Parties, Action = none, Timeout = none) ¶threading.Barrier(parties, action=None, timeout=None)

Tạo một đối tượng rào cản cho các bên số lượng chủ đề. Một hành động, khi được cung cấp, là một cuộc gọi được gọi để được gọi bởi một trong các chủ đề khi chúng được phát hành. Thời gian chờ là giá trị thời gian chờ mặc định nếu không có gì được chỉ định cho phương thức

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59.

Đợi (thời gian chờ = Không) ¶(timeout=None)

Vượt qua rào cản. Khi tất cả các chủ đề tham gia hàng rào đã gọi là chức năng này, tất cả chúng đều được phát hành đồng thời. Nếu một thời gian chờ được cung cấp, nó được sử dụng theo sở thích cho bất kỳ thứ gì được cung cấp cho hàm tạo lớp.

Giá trị trả về là một số nguyên trong phạm vi 0 đến các bên - 1, khác nhau cho mỗi luồng. Điều này có thể được sử dụng để chọn một chủ đề để thực hiện một số công việc dọn phòng đặc biệt, ví dụ:

i = barrier.wait()
if i == 0:
    # Only one thread needs to print this
    print("passed the barrier")

Nếu một hành động được cung cấp cho hàm tạo, một trong các luồng sẽ gọi nó trước khi được phát hành. Nếu cuộc gọi này gây ra lỗi, rào cản được đưa vào trạng thái bị hỏng.

Nếu cuộc gọi hết thời gian, rào cản được đưa vào trạng thái bị hỏng.

Phương pháp này có thể tăng ngoại lệ

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
52 nếu rào cản bị hỏng hoặc đặt lại trong khi một luồng đang chờ.

cài lại()¶()

Trả hàng rào cho trạng thái mặc định, trống. Bất kỳ chủ đề đang chờ đợi trên nó sẽ nhận được ngoại lệ

# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
52.

Lưu ý rằng sử dụng chức năng này có thể yêu cầu một số đồng bộ hóa bên ngoài nếu có các luồng khác mà trạng thái không rõ. Nếu một rào cản bị phá vỡ, có thể tốt hơn là chỉ để nó và tạo ra một cái mới.

Huỷ bỏ()¶()

Đặt rào cản vào một trạng thái bị hỏng. Điều này khiến mọi cuộc gọi hoạt động hoặc trong tương lai đến

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
59 thất bại với
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
52. Sử dụng điều này ví dụ nếu một trong các chủ đề cần hủy bỏ, để tránh giảm ứng dụng.

Có thể tốt hơn là chỉ cần tạo ra hàng rào với giá trị thời gian chờ hợp lý để tự động bảo vệ chống lại một trong các luồng sẽ bị đánh giá cao.

các bữa tiệc

Số lượng chủ đề cần thiết để vượt qua hàng rào.

n_waiting¶

Số lượng chủ đề hiện đang chờ đợi trong rào cản.

bị hỏng¶

Một boolean là

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
05 nếu rào cản ở trạng thái bị hỏng.

Ngoại lệ.BrokenBarrierRoror¶threading.BrokenBarrierError

Ngoại lệ này, một lớp con của

while not predicate():
    cv.wait()
8, được nâng lên khi đối tượng
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
58 được đặt lại hoặc bị hỏng.

Sử dụng khóa, điều kiện và semaphores trong Tuyên bố >>> from threading import Thread >>> t = Thread(target=print, args=[1]) >>> t.run() 1 >>> t = Thread(target=print, args=(1,)) >>> t.run() 1 56

Tất cả các đối tượng được cung cấp bởi mô -đun này có các phương thức

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 và
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 có thể được sử dụng làm Trình quản lý ngữ cảnh cho câu lệnh
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
56. Phương thức
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
17 sẽ được gọi khi khối được nhập và
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
18 sẽ được gọi khi khối được thoát. Do đó, đoạn trích sau:

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
0

tương đương với:

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
1

Hiện tại,

>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
27,
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
47,
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
67,
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
26 và
# Consume one item
with cv:
    while not an_item_is_available():
        cv.wait()
    get_an_available_item()

# Produce one item
with cv:
    make_an_item_available()
    cv.notify()
69 Các đối tượng có thể được sử dụng làm Trình quản lý bối cảnh câu lệnh
>>> from threading import Thread
>>> t = Thread(target=print, args=[1])
>>> t.run()
1
>>> t = Thread(target=print, args=(1,))
>>> t.run()
1
56.

Python cung cấp mô -đun nào cho các chủ đề?

Thư viện tiêu chuẩn Python cung cấp luồng, trong đó chứa hầu hết các nguyên thủy bạn sẽ thấy trong bài viết này. Chủ đề, trong mô -đun này, đóng gói độc đáo các chủ đề, cung cấp một giao diện sạch để làm việc với chúng. Khi bạn tạo một luồng, bạn chuyển nó một hàm và một danh sách chứa các đối số cho hàm đó. provides threading , which contains most of the primitives you'll see in this article. Thread , in this module, nicely encapsulates threads, providing a clean interface to work with them. When you create a Thread , you pass it a function and a list containing the arguments to that function.

Chức năng Python nào có thể được gọi để chạy một chủ đề?

Khi một đối tượng luồng được tạo, hoạt động của nó phải được bắt đầu bằng cách gọi phương thức start () của luồng.Điều này gọi phương thức Run () trong một luồng điều khiển riêng biệt.run() method in a separate thread of control.

Gói chủ đề trong Python là gì?

Việc luồng trong Python được sử dụng để chạy nhiều luồng (tác vụ, cuộc gọi chức năng) cùng một lúc.Lưu ý rằng điều này không có nghĩa là chúng được thực thi trên các CPU khác nhau.Các chủ đề Python sẽ không làm cho chương trình của bạn nhanh hơn nếu nó đã sử dụng thời gian CPU 100 %.used to run multiple threads (tasks, function calls) at the same time. Note that this does not mean that they are executed on different CPUs. Python threads will NOT make your program faster if it already uses 100 % CPU time.

Làm thế nào để bạn có được chủ đề trong Python?

Mô-đun luồng được cung cấp với Python bao gồm một cơ chế khóa đơn giản để thực hiện cho phép bạn đồng bộ hóa các luồng.Một khóa mới được tạo bằng cách gọi phương thức khóa (), trả về phương thức khóa mới. Việc thu nhận (chặn) của đối tượng khóa mới được sử dụng để buộc các luồng để chạy đồng bộ.A new lock is created by calling the Lock() method, which returns the new lock. The acquire(blocking) method of the new lock object is used to force threads to run synchronously.