Meta Configuration of Package perl-Thread-Queue

Overview Repositories Revisions Requests Users Attributes Meta

Meta Configuration of Package perl-Thread-Queue

<package name="perl-Thread-Queue" project="devel:languages:perl">
  <title>Thread-safe queues</title>
  <description>This module provides thread-safe FIFO queues that can be accessed safely by
any number of threads.

Any data types supported by the threads::shared manpage can be passed via
queues:

* Ordinary scalars

* Array refs

* Hash refs

* Scalar refs

* Objects based on the above

Ordinary scalars are added to queues as they are.

If not already thread-shared, the other complex data types will be cloned
(recursively, if needed, and including any 'bless'ings and read-only
settings) into thread-shared structures before being placed onto a queue.

For example, the following would cause the Thread::Queue manpage to create
a empty, shared array reference via '&amp;shared([])', copy the elements 'foo',
'bar' and 'baz' from '@ary' into it, and then place that shared reference
onto the queue:

my @ary = qw/foo bar baz/;
    $q-&gt;enqueue(\@ary);

However, for the following, the items are already shared, so their
references are added directly to the queue, and no cloning takes place:

my @ary :shared = qw/foo bar baz/;
    $q-&gt;enqueue(\@ary);

my $obj = &amp;shared({});
    $$obj{'foo'} = 'bar';
    $$obj{'qux'} = 99;
    bless($obj, 'My::Class');
    $q-&gt;enqueue($obj);

See the /"LIMITATIONS" manpage for caveats related to passing objects via
queues.

</description>
  <url>http://search.cpan.org/dist/Thread-Queue/</url>
</package>

Places

Meta Configuration of Package perl-Thread-Queue

Places