| | |
+
+- threading.Thread(builtins.object)
+
-
+
+- JoinThread
+
- StoppableThread
-
-
-
-
-class JoinThread(threading.Thread) |
+
+
+
+
+class JoinThread(threading.Thread) |
-| |
-JoinThread - The workhouse that stops the StoppableThread
|
-| |
-- Method resolution order:
-- JoinThread
-- threading.Thread
-- builtins.object
+| |
+JoinThread - The workhouse that stops the StoppableThread
|
+| |
+- Method resolution order:
+- JoinThread
+- threading.Thread
+- builtins.object
-
-Methods defined here:
-- __init__(self, otherThread, exception)
- This constructor should always be called with keyword arguments. Arguments are:
-
-*group* should be None; reserved for future extension when a ThreadGroup
-class is implemented.
-
-*target* is the callable object to be invoked by the run()
-method. Defaults to None, meaning nothing is called.
-
-*name* is the thread name. By default, a unique name is constructed of
-the form "Thread-N" where N is a small decimal number.
-
-*args* is the argument tuple for the target invocation. Defaults to ().
-
-*kwargs* is a dictionary of keyword arguments for the target
-invocation. Defaults to {}.
-
-If a subclass overrides the constructor, it must make sure to invoke
-the base class constructor (Thread.__init__()) before doing anything
+
+Methods defined here:
+- __init__(self, otherThread, exception)
- This constructor should always be called with keyword arguments. Arguments are:
+
+*group* should be None; reserved for future extension when a ThreadGroup
+class is implemented.
+
+*target* is the callable object to be invoked by the run()
+method. Defaults to None, meaning nothing is called.
+
+*name* is the thread name. By default, a unique name is constructed of
+the form "Thread-N" where N is a small decimal number.
+
+*args* is the argument tuple for the target invocation. Defaults to ().
+
+*kwargs* is a dictionary of keyword arguments for the target
+invocation. Defaults to {}.
+
+If a subclass overrides the constructor, it must make sure to invoke
+the base class constructor (Thread.__init__()) before doing anything
else to the thread.
-- run(self)
- Method representing the thread's activity.
-
-You may override this method in a subclass. The standard run() method
-invokes the callable object passed to the object's constructor as the
-target argument, if any, with sequential and keyword arguments taken
+- run(self)
- Method representing the thread's activity.
+
+You may override this method in a subclass. The standard run() method
+invokes the callable object passed to the object's constructor as the
+target argument, if any, with sequential and keyword arguments taken
from the args and kwargs arguments, respectively.
-
-Methods inherited from threading.Thread:
-- __repr__(self)
- Return repr(self).
+
+Methods inherited from threading.Thread:
+- __repr__(self)
- Return repr(self).
-- getName(self)
+- getName(self)
-- isAlive = is_alive(self)
- Return whether the thread is alive.
-
-This method returns True just before the run() method starts until just
-after the run() method terminates. The module function enumerate()
+- isAlive = is_alive(self)
- Return whether the thread is alive.
+
+This method returns True just before the run() method starts until just
+after the run() method terminates. The module function enumerate()
returns a list of all alive threads.
-- isDaemon(self)
+- isDaemon(self)
-- is_alive(self)
- Return whether the thread is alive.
-
-This method returns True just before the run() method starts until just
-after the run() method terminates. The module function enumerate()
+- is_alive(self)
- Return whether the thread is alive.
+
+This method returns True just before the run() method starts until just
+after the run() method terminates. The module function enumerate()
returns a list of all alive threads.
-- join(self, timeout=None)
- Wait until the thread terminates.
-
-This blocks the calling thread until the thread whose join() method is
-called terminates -- either normally or through an unhandled exception
-or until the optional timeout occurs.
-
-When the timeout argument is present and not None, it should be a
-floating point number specifying a timeout for the operation in seconds
-(or fractions thereof). As join() always returns None, you must call
-isAlive() after join() to decide whether a timeout happened -- if the
-thread is still alive, the join() call timed out.
-
-When the timeout argument is not present or None, the operation will
-block until the thread terminates.
-
-A thread can be join()ed many times.
-
-join() raises a RuntimeError if an attempt is made to join the current
-thread as that would cause a deadlock. It is also an error to join() a
-thread before it has been started and attempts to do so raises the same
+- join(self, timeout=None)
- Wait until the thread terminates.
+
+This blocks the calling thread until the thread whose join() method is
+called terminates -- either normally or through an unhandled exception
+or until the optional timeout occurs.
+
+When the timeout argument is present and not None, it should be a
+floating point number specifying a timeout for the operation in seconds
+(or fractions thereof). As join() always returns None, you must call
+isAlive() after join() to decide whether a timeout happened -- if the
+thread is still alive, the join() call timed out.
+
+When the timeout argument is not present or None, the operation will
+block until the thread terminates.
+
+A thread can be join()ed many times.
+
+join() raises a RuntimeError if an attempt is made to join the current
+thread as that would cause a deadlock. It is also an error to join() a
+thread before it has been started and attempts to do so raises the same
exception.
-- setDaemon(self, daemonic)
+- setDaemon(self, daemonic)
-- setName(self, name)
+- setName(self, name)
-- start(self)
- Start the thread's activity.
-
-It must be called at most once per thread object. It arranges for the
-object's run() method to be invoked in a separate thread of control.
-
-This method will raise a RuntimeError if called more than once on the
+- start(self)
- Start the thread's activity.
+
+It must be called at most once per thread object. It arranges for the
+object's run() method to be invoked in a separate thread of control.
+
+This method will raise a RuntimeError if called more than once on the
same thread object.
-
-Data descriptors inherited from threading.Thread:
-- __dict__
-- dictionary for instance variables (if defined)
+
+Data descriptors inherited from threading.Thread:
+- __dict__
+- dictionary for instance variables (if defined)
-- __weakref__
-- list of weak references to the object (if defined)
+- __weakref__
+- list of weak references to the object (if defined)
-- daemon
-- A boolean value indicating whether this thread is a daemon thread.
-
-This must be set before start() is called, otherwise RuntimeError is
-raised. Its initial value is inherited from the creating thread; the
-main thread is not a daemon thread and therefore all threads created in
-the main thread default to daemon = False.
-
-The entire Python program exits when no alive non-daemon threads are
+- daemon
+- A boolean value indicating whether this thread is a daemon thread.
+
+This must be set before start() is called, otherwise RuntimeError is
+raised. Its initial value is inherited from the creating thread; the
+main thread is not a daemon thread and therefore all threads created in
+the main thread default to daemon = False.
+
+The entire Python program exits when no alive non-daemon threads are
left.
-- ident
-- Thread identifier of this thread or None if it has not been started.
-
-This is a nonzero integer. See the thread.get_ident() function. Thread
-identifiers may be recycled when a thread exits and another thread is
+- ident
+- Thread identifier of this thread or None if it has not been started.
+
+This is a nonzero integer. See the thread.get_ident() function. Thread
+identifiers may be recycled when a thread exits and another thread is
created. The identifier is available even after the thread has exited.
-- name
-- A string used for identification purposes only.
-
-It has no semantics. Multiple threads may be given the same name. The
+- name
+- A string used for identification purposes only.
+
+It has no semantics. Multiple threads may be given the same name. The
initial name is set by the constructor.
-
|
|
-
+
+
+
+class StoppableThread(threading.Thread) |
-| |
-StoppableThread - A thread that can be stopped by forcing an exception in the execution context.
|
-| |
-- Method resolution order:
-- StoppableThread
-- threading.Thread
-- builtins.object
+| |
+StoppableThread - A thread that can be stopped by forcing an exception in the execution context.
|
+| |
+- Method resolution order:
+- StoppableThread
+- threading.Thread
+- builtins.object
-
-Methods inherited from threading.Thread:
-- __init__(self, group=None, target=None, name=None, args=(), kwargs=None, *, daemon=None)
- This constructor should always be called with keyword arguments. Arguments are:
-
-*group* should be None; reserved for future extension when a ThreadGroup
-class is implemented.
-
-*target* is the callable object to be invoked by the run()
-method. Defaults to None, meaning nothing is called.
-
-*name* is the thread name. By default, a unique name is constructed of
-the form "Thread-N" where N is a small decimal number.
-
-*args* is the argument tuple for the target invocation. Defaults to ().
-
-*kwargs* is a dictionary of keyword arguments for the target
-invocation. Defaults to {}.
-
-If a subclass overrides the constructor, it must make sure to invoke
-the base class constructor (Thread.__init__()) before doing anything
+
+Methods inherited from threading.Thread:
+- __init__(self, group=None, target=None, name=None, args=(), kwargs=None, *, daemon=None)
- This constructor should always be called with keyword arguments. Arguments are:
+
+*group* should be None; reserved for future extension when a ThreadGroup
+class is implemented.
+
+*target* is the callable object to be invoked by the run()
+method. Defaults to None, meaning nothing is called.
+
+*name* is the thread name. By default, a unique name is constructed of
+the form "Thread-N" where N is a small decimal number.
+
+*args* is the argument tuple for the target invocation. Defaults to ().
+
+*kwargs* is a dictionary of keyword arguments for the target
+invocation. Defaults to {}.
+
+If a subclass overrides the constructor, it must make sure to invoke
+the base class constructor (Thread.__init__()) before doing anything
else to the thread.
-- __repr__(self)
- Return repr(self).
+- __repr__(self)
- Return repr(self).
-- getName(self)
+- getName(self)
-- isAlive = is_alive(self)
- Return whether the thread is alive.
-
-This method returns True just before the run() method starts until just
-after the run() method terminates. The module function enumerate()
+- isAlive = is_alive(self)
- Return whether the thread is alive.
+
+This method returns True just before the run() method starts until just
+after the run() method terminates. The module function enumerate()
returns a list of all alive threads.
-- isDaemon(self)
+- isDaemon(self)
-- is_alive(self)
- Return whether the thread is alive.
-
-This method returns True just before the run() method starts until just
-after the run() method terminates. The module function enumerate()
+- is_alive(self)
- Return whether the thread is alive.
+
+This method returns True just before the run() method starts until just
+after the run() method terminates. The module function enumerate()
returns a list of all alive threads.
-- join(self, timeout=None)
- Wait until the thread terminates.
-
-This blocks the calling thread until the thread whose join() method is
-called terminates -- either normally or through an unhandled exception
-or until the optional timeout occurs.
-
-When the timeout argument is present and not None, it should be a
-floating point number specifying a timeout for the operation in seconds
-(or fractions thereof). As join() always returns None, you must call
-isAlive() after join() to decide whether a timeout happened -- if the
-thread is still alive, the join() call timed out.
-
-When the timeout argument is not present or None, the operation will
-block until the thread terminates.
-
-A thread can be join()ed many times.
-
-join() raises a RuntimeError if an attempt is made to join the current
-thread as that would cause a deadlock. It is also an error to join() a
-thread before it has been started and attempts to do so raises the same
+- join(self, timeout=None)
- Wait until the thread terminates.
+
+This blocks the calling thread until the thread whose join() method is
+called terminates -- either normally or through an unhandled exception
+or until the optional timeout occurs.
+
+When the timeout argument is present and not None, it should be a
+floating point number specifying a timeout for the operation in seconds
+(or fractions thereof). As join() always returns None, you must call
+isAlive() after join() to decide whether a timeout happened -- if the
+thread is still alive, the join() call timed out.
+
+When the timeout argument is not present or None, the operation will
+block until the thread terminates.
+
+A thread can be join()ed many times.
+
+join() raises a RuntimeError if an attempt is made to join the current
+thread as that would cause a deadlock. It is also an error to join() a
+thread before it has been started and attempts to do so raises the same
exception.
-- run(self)
- Method representing the thread's activity.
-
-You may override this method in a subclass. The standard run() method
-invokes the callable object passed to the object's constructor as the
-target argument, if any, with sequential and keyword arguments taken
+- run(self)
- Method representing the thread's activity.
+
+You may override this method in a subclass. The standard run() method
+invokes the callable object passed to the object's constructor as the
+target argument, if any, with sequential and keyword arguments taken
from the args and kwargs arguments, respectively.
-- setDaemon(self, daemonic)
+- setDaemon(self, daemonic)
-- setName(self, name)
+- setName(self, name)
-- start(self)
- Start the thread's activity.
-
-It must be called at most once per thread object. It arranges for the
-object's run() method to be invoked in a separate thread of control.
-
-This method will raise a RuntimeError if called more than once on the
+- start(self)
- Start the thread's activity.
+
+It must be called at most once per thread object. It arranges for the
+object's run() method to be invoked in a separate thread of control.
+
+This method will raise a RuntimeError if called more than once on the
same thread object.
-
-Data descriptors inherited from threading.Thread:
-- __dict__
-- dictionary for instance variables (if defined)
+
+Data descriptors inherited from threading.Thread:
+- __dict__
+- dictionary for instance variables (if defined)
-- __weakref__
-- list of weak references to the object (if defined)
+- __weakref__
+- list of weak references to the object (if defined)
-- daemon
-- A boolean value indicating whether this thread is a daemon thread.
-
-This must be set before start() is called, otherwise RuntimeError is
-raised. Its initial value is inherited from the creating thread; the
-main thread is not a daemon thread and therefore all threads created in
-the main thread default to daemon = False.
-
-The entire Python program exits when no alive non-daemon threads are
+- daemon
+- A boolean value indicating whether this thread is a daemon thread.
+
+This must be set before start() is called, otherwise RuntimeError is
+raised. Its initial value is inherited from the creating thread; the
+main thread is not a daemon thread and therefore all threads created in
+the main thread default to daemon = False.
+
+The entire Python program exits when no alive non-daemon threads are
left.
-- ident
-- Thread identifier of this thread or None if it has not been started.
-
-This is a nonzero integer. See the thread.get_ident() function. Thread
-identifiers may be recycled when a thread exits and another thread is
+- ident
+- Thread identifier of this thread or None if it has not been started.
+
+This is a nonzero integer. See the thread.get_ident() function. Thread
+identifiers may be recycled when a thread exits and another thread is
created. The identifier is available even after the thread has exited.
-- name
-- A string used for identification purposes only.
-
-It has no semantics. Multiple threads may be given the same name. The
+- name
+- A string used for identification purposes only.
+
+It has no semantics. Multiple threads may be given the same name. The
initial name is set by the constructor.
-
|
|
-
+ |