~ubuntu-branches/ubuntu/intrepid/perl-doc-html/intrepid

      <h2>Links:</h2>

      <ul>

        <li><a href="http://search.cpan.org">CPAN</a></li>

        <li><a href="http://www.perl.com">Perl.com</a></li>

        <li><a href="http://www.pm.org">Perl Mongers</a></li>

        <li><a href="http://www.perlmonks.org">Perl Monks</a></li>

        <li><a href="http://planet.perl.org">Planet Perl</a></li>

      <ul>

        <li>Site maintained by<br><a href="http://perl.jonallen.info">Jon Allen</a>

            (<a href="http://perl.jonallen.info">JJ</a>)</li>

        <li class="spaced">See the <a href="http://perl.jonallen.info/projects/perldoc">project page</a> for

        more details</li>

      </ul>

    <div id="centerContent">

      <div id="contentHeader">

        <div id="contentHeaderLeft"><a href="#" onClick="showLeft()">Show navigation</a></div>

        <div id="contentHeaderRight"><a href="#" onClick="showRight()">Show toolbar</a></div>

      </div>

      <div id="breadCrumbs"><a href="../index.html">Home</a> &gt; <a href="../index-modules-A.html">Core modules</a> &gt; <a href="../index-modules-T.html">T</a> &gt; Thread::Queue</div>

      <div id="contentBody"><div class="title_container"><div class="page_title">Thread::Queue</div></div><ul><li><a href="#NAME">NAME</a><li><a href="#SYNOPSIS">SYNOPSIS</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#FUNCTIONS-AND-METHODS">FUNCTIONS AND METHODS</a><li><a href="#SEE-ALSO">SEE ALSO</a></ul><a name="NAME"></a><h1>NAME</h1>

<p>Thread::Queue - thread-safe queues</p>

<a name="SYNOPSIS"></a><h1>SYNOPSIS</h1>

    <span class="i">$q</span><span class="i">-&gt;enqueue</span><span class="s">(</span><span class="q">&quot;foo&quot;</span><span class="cm">,</span> <span class="q">&quot;bar&quot;</span><span class="s">)</span><span class="sc">;</span>

    <a class="l_k" href="../functions/my.html">my</a> <span class="i">$foo</span> = <span class="i">$q</span><span class="i">-&gt;dequeue</span><span class="sc">;</span>    <span class="c"># The &quot;bar&quot; is still in the queue.</span>

    <a class="l_k" href="../functions/my.html">my</a> <span class="i">$foo</span> = <span class="i">$q</span><span class="i">-&gt;dequeue_nb</span><span class="sc">;</span> <span class="c"># returns &quot;bar&quot;, or undef if the queue was empty</span>

    <a class="l_k" href="../functions/my.html">my</a> <span class="i">$left</span> = <span class="i">$q</span><span class="i">-&gt;pending</span><span class="sc">;</span>   <span class="c"># returns the number of items still in the queue</span></pre>

<a name="DESCRIPTION"></a><h1>DESCRIPTION</h1>

data structure much like a list.  Any number of threads can safely 

add elements to the end of the list, or remove elements from the head 

of the list. (Queues don't permit adding or removing elements from 

<a name="FUNCTIONS-AND-METHODS"></a><h1>FUNCTIONS AND METHODS</h1>

<ul>

<li><a name="new"></a><b>new</b>

 function creates a new empty queue.</p>

</li>

<li><a name="enqueue-LIST"></a><b>enqueue LIST</b>

 method adds a list of scalars on to the end of the queue.

The queue will grow as needed to accommodate the list.</p>

</li>

<li><a name="dequeue"></a><b>dequeue</b>

 method removes a scalar from the head of the queue and

 will block the

s a scalar.</p>

</li>

<li><a name="dequeue_nb"></a><b>dequeue_nb</b>

 method, removes a scalar from

, though,

 won't block if the queue is empty, instead returning

<code class="inline"><a class="l_k" href="../functions/undef.html">undef</a></code>.</p>

</li>

<li><a name="pending"></a><b>pending</b>

 method returns the number of items still in the queue.</p>

</li>

</ul>

          <!--<select name="r"><option value="1" selected>Go to top result<option value="0">Show results list</select>-->

        </form>

      </p>

      <h2>Labels:</h2>

      <p>

        <a href="#" onClick="addLabel('Thread::Queue','Thread/Queue.html')">Add this page</a>