NAME
MCE::Channel::ThreadsFast - Fast channel for producer(s) and many consumers
VERSION
This document describes MCE::Channel::ThreadsFast version 1.880
DESCRIPTION
A channel class providing queue-like and two-way communication for threads only. Locking is handled using threads::shared.
This is similar to MCE::Channel::Threads but optimized for non-Unicode strings only. The main difference is that this module lacks freeze-thaw serialization. Non-string arguments become stringified; i.e. numbers and undef.
The API is described in MCE::Channel with the sole difference being send
and send2
handle one argument.
Current module available since MCE 1.877.
- new
-
use MCE::Channel; # The default is tuned for one producer and many consumers. my $chnl_a = MCE::Channel->new( impl => 'ThreadsFast' ); # Specify the 'mp' option for safe use by two or more producers # sending or recieving on the left side of the channel (i.e. # ->enqueue/->send or ->recv2/->recv2_nb). my $chnl_b = MCE::Channel->new( impl => 'ThreadsFast', mp => 1 );
QUEUE-LIKE BEHAVIOR
- enqueue
- dequeue
- dequeue_nb
- end
TWO-WAY IPC - PRODUCER TO CONSUMER
- send
- recv
- recv_nb
TWO-WAY IPC - CONSUMER TO PRODUCER
- send2
- recv2
- recv2_nb
LIMITATIONS
The t/04_channel_threads tests are disabled on Unix platforms for Perl less than 5.10.1. Basically, the MCE::Channel::ThreadsFast implementation is not supported on older Perls unless the OS vendor applied upstream patches (i.e. works on RedHat/CentOS 5.x running Perl 5.8.x).
AUTHOR
Mario E. Roy, <marioeroy AT gmail DOT com>