]> granicus.if.org Git - python/commitdiff
Document PyThreadState_SetAsyncExc().
authorFred Drake <fdrake@acm.org>
Sun, 29 Jun 2003 02:14:31 +0000 (02:14 +0000)
committerFred Drake <fdrake@acm.org>
Sun, 29 Jun 2003 02:14:31 +0000 (02:14 +0000)
Doc/api/init.tex

index 388f479457b846d7a07edadd8d1ef5da7e501d34..44bfa3ecb94ba7c25e4cbe1c75d3a94701ac364d 100644 (file)
@@ -685,6 +685,20 @@ interpreter lock has been created.
   thread is active, and \NULL meant that an exception was raised]{2.3}
 \end{cfuncdesc}
 
+\begin{cfuncdesc}{int}{PyThreadState_SetAsyncExc}{long id, PyObject *exc}
+  Asynchronously raise an exception in a thread. 
+  The \var{id} argument is the thread id of the target thread;
+  \var{exc} is the exception object to be raised.
+  This function does not steal any references to \var{exc}.
+  To prevent naive misuse, you must write your own C extension 
+  to call this.  Must be called with the GIL held. 
+  Returns the number of thread states modified; if it returns a number 
+  greater than one, you're in trouble, and you should call it again 
+  with \var{exc} set to \constant{NULL} to revert the effect.
+  This raises no exceptions.
+  \versionadded{2.3}
+\end{cfuncdesc}
+
 
 \section{Profiling and Tracing \label{profiling}}