📄 module-queue.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>7.7 Queue -- A synchronized queue class</title>
<META NAME="description" CONTENT="7.7 Queue -- A synchronized queue class">
<META NAME="keywords" CONTENT="lib">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="STYLESHEET" href="lib.css" tppabs="http://www.python.org/doc/current/lib/lib.css">
<LINK REL="next" href="module-mmap.html" tppabs="http://www.python.org/doc/current/lib/module-mmap.html">
<LINK REL="previous" href="module-mutex.html" tppabs="http://www.python.org/doc/current/lib/module-mutex.html">
<LINK REL="up" href="someos.html" tppabs="http://www.python.org/doc/current/lib/someos.html">
<LINK REL="next" href="QueueObjects.html" tppabs="http://www.python.org/doc/current/lib/QueueObjects.html">
</head>
<body>
<DIV CLASS="navigation"><table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><A href="mutex-objects.html" tppabs="http://www.python.org/doc/current/lib/mutex-objects.html"><img src="previous.gif" tppabs="http://www.python.org/doc/current/icons/previous.gif" border="0" height="32"
alt="Previous Page" width="32"></A></td>
<td><A href="someos.html" tppabs="http://www.python.org/doc/current/lib/someos.html"><img src="up.gif" tppabs="http://www.python.org/doc/current/icons/up.gif" border="0" height="32"
alt="Up One Level" width="32"></A></td>
<td><A href="QueueObjects.html" tppabs="http://www.python.org/doc/current/lib/QueueObjects.html"><img src="next.gif" tppabs="http://www.python.org/doc/current/icons/next.gif" border="0" height="32"
alt="Next Page" width="32"></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td><A href="contents.html" tppabs="http://www.python.org/doc/current/lib/contents.html"><img src="contents.gif" tppabs="http://www.python.org/doc/current/icons/contents.gif" border="0" height="32"
alt="Contents" width="32"></A></td>
<td><a href="modindex.html" tppabs="http://www.python.org/doc/current/lib/modindex.html" title="Module Index"><img src="modules.gif" tppabs="http://www.python.org/doc/current/icons/modules.gif" border="0" height="32"
alt="Module Index" width="32"></a></td>
<td><A href="genindex.html" tppabs="http://www.python.org/doc/current/lib/genindex.html"><img src="index.gif" tppabs="http://www.python.org/doc/current/icons/index.gif" border="0" height="32"
alt="Index" width="32"></A></td>
</tr></table>
<b class="navlabel">Previous:</b> <a class="sectref" href="mutex-objects.html" tppabs="http://www.python.org/doc/current/lib/mutex-objects.html">7.6.1 Mutex Objects</A>
<b class="navlabel">Up:</b> <a class="sectref" href="someos.html" tppabs="http://www.python.org/doc/current/lib/someos.html">7. Optional Operating System</A>
<b class="navlabel">Next:</b> <a class="sectref" href="QueueObjects.html" tppabs="http://www.python.org/doc/current/lib/QueueObjects.html">7.7.1 Queue Objects</A>
<br><hr></DIV>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION009700000000000000000">
7.7 <tt class="module">Queue</tt> --
A synchronized queue class</A>
</H1>
<P>
<P>
The <tt class="module">Queue</tt> module implements a multi-producer, multi-consumer
FIFO queue. It is especially useful in threads programming when
information must be exchanged safely between multiple threads. The
<tt class="class">Queue</tt> class in this module implements all the required locking
semantics. It depends on the availability of thread support in
Python.
<P>
The <tt class="module">Queue</tt> module defines the following class and exception:
<P>
<dl><dt><b><a name='l2h-1677'><tt class='class'>Queue</tt></a></b> (<var>maxsize</var>)
<dd>
Constructor for the class. <var>maxsize</var> is an integer that sets the
upperbound limit on the number of items that can be placed in the
queue. Insertion will block once this size has been reached, until
queue items are consumed. If <var>maxsize</var> is less than or equal to
zero, the queue size is infinite.
</dl>
<P>
<dl><dt><b><a name='l2h-1678'><tt class='exception'>Empty</tt></a></b>
<dd>
Exception raised when non-blocking <tt class="method">get()</tt> (or
<tt class="method">get_nowait()</tt>) is called on a <tt class="class">Queue</tt> object which is
empty or locked.
</dl>
<P>
<dl><dt><b><a name='l2h-1679'><tt class='exception'>Full</tt></a></b>
<dd>
Exception raised when non-blocking <tt class="method">put()</tt> (or
<tt class="method">put_nowait()</tt>) is called on a <tt class="class">Queue</tt> object which is
full or locked.
</dl>
<P>
<p><hr>
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
<LI><A NAME="tex2html3017"
href="QueueObjects.html" tppabs="http://www.python.org/doc/current/lib/QueueObjects.html">7.7.1 Queue Objects</A>
</UL>
<!--End of Table of Child-Links-->
<DIV CLASS="navigation"><p><hr><table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><A href="mutex-objects.html" tppabs="http://www.python.org/doc/current/lib/mutex-objects.html"><img src="previous.gif" tppabs="http://www.python.org/doc/current/icons/previous.gif" border="0" height="32"
alt="Previous Page" width="32"></A></td>
<td><A href="someos.html" tppabs="http://www.python.org/doc/current/lib/someos.html"><img src="up.gif" tppabs="http://www.python.org/doc/current/icons/up.gif" border="0" height="32"
alt="Up One Level" width="32"></A></td>
<td><A href="QueueObjects.html" tppabs="http://www.python.org/doc/current/lib/QueueObjects.html"><img src="next.gif" tppabs="http://www.python.org/doc/current/icons/next.gif" border="0" height="32"
alt="Next Page" width="32"></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td><A href="contents.html" tppabs="http://www.python.org/doc/current/lib/contents.html"><img src="contents.gif" tppabs="http://www.python.org/doc/current/icons/contents.gif" border="0" height="32"
alt="Contents" width="32"></A></td>
<td><a href="modindex.html" tppabs="http://www.python.org/doc/current/lib/modindex.html" title="Module Index"><img src="modules.gif" tppabs="http://www.python.org/doc/current/icons/modules.gif" border="0" height="32"
alt="Module Index" width="32"></a></td>
<td><A href="genindex.html" tppabs="http://www.python.org/doc/current/lib/genindex.html"><img src="index.gif" tppabs="http://www.python.org/doc/current/icons/index.gif" border="0" height="32"
alt="Index" width="32"></A></td>
</tr></table>
<b class="navlabel">Previous:</b> <a class="sectref" href="mutex-objects.html" tppabs="http://www.python.org/doc/current/lib/mutex-objects.html">7.6.1 Mutex Objects</A>
<b class="navlabel">Up:</b> <a class="sectref" href="someos.html" tppabs="http://www.python.org/doc/current/lib/someos.html">7. Optional Operating System</A>
<b class="navlabel">Next:</b> <a class="sectref" href="QueueObjects.html" tppabs="http://www.python.org/doc/current/lib/QueueObjects.html">7.7.1 Queue Objects</A>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
<hr>See <i><a href="about.html" tppabs="http://www.python.org/doc/current/lib/about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -