MCE::Subs(3) User Contributed Perl Documentation MCE::Subs(3)
NAME
MCE::Subs - Exports functions mapped directly to MCE methods
VERSION
This document describes MCE::Subs version 1.843
SYNOPSIS
use MCE::Subs; ## Exports manager and worker functions only
## Getter functions are not exported by default
use MCE::Subs qw( :getter ); ## All, including getter functions
use MCE::Subs qw( :manager ); ## Exports manager functions only
use MCE::Subs qw( :worker ); ## Exports worker functions only
use MCE::Subs qw( :getter :worker ); ## Excludes manager functions
DESCRIPTION
This module exports functions mapped to MCE methods. All exported
functions are prototyped, therefore allowing one to call them without
using parentheses.
use MCE::Subs qw( :worker );
sub user_func {
my $wid = MCE->wid;
mce_say "A: $wid";
mce_sync;
mce_say "B: $wid";
mce_sync;
mce_say "C: $wid";
mce_sync;
return;
}
MCE->new(
max_workers => 24, user_func => \&user_func
);
mce_run 0 for (1..100); ## 0 means do not shutdown after running
For the next example, we only want the worker functions to be exported
due to using MCE::Map, which takes care of creating a MCE instance and
running.
use MCE::Map;
use MCE::Subs qw( :worker );
## The following serializes output to STDOUT and gathers $_ to @a.
## mce_say displays $_ when called without arguments.
my @a = mce_map { mce_say; $_ } 1 .. 100;
print scalar @a, "\n";
Unlike the native Perl functions, printf, print, and say methods
require the comma after the glob reference or file handle.
MCE->printf(\*STDERR, "%s\n", $error_msg);
MCE->print(\*STDERR, $error_msg, "\n");
MCE->say(\*STDERR, $error_msg);
MCE->say($fh, $error_msg);
mce_printf \*STDERR, "%s\n", $error_msg;
mce_print \*STDERR, $error_msg, "\n";
mce_say \*STDERR, $error_msg;
mce_say $fh, $error_msg;
FUNCTIONS for the MANAGER PROCESS via ( :manager )
MCE methods are described in MCE::Core.
o mce_abort
o mce_do
o mce_forchunk
o mce_foreach
o mce_forseq
o mce_freeze
o mce_process
o mce_relay_final
o mce_restart_worker
o mce_run
o mce_print
o mce_printf
o mce_say
o mce_send
o mce_shutdown
o mce_spawn
o mce_status
o mce_thaw
FUNCTIONS for MCE WORKERS via ( :worker )
MCE methods are described in MCE::Core.
o mce_abort
o mce_do
o mce_exit
o mce_freeze
o mce_gather
o mce_last
o mce_next
o mce_print
o mce_printf
o mce_relay
o mce_relay_recv
o mce_say
o mce_sendto
o mce_sync
o mce_thaw
o mce_yield
GETTERS for MCE ATTRIBUTES via ( :getter )
MCE methods are described in MCE::Core.
o mce_chunk_id
o mce_chunk_size
o mce_max_retries
o mce_max_workers
o mce_pid
o mce_sess_dir
o mce_task_id
o mce_task_name
o mce_task_wid
o mce_tmp_dir
o mce_user_args
o mce_wid
INDEX
MCE(3), MCE::Core(3)
AUTHOR
Mario E. Roy, <marioeroyA ATA gmailA DOTA com>
perl v5.28.2 2019-07-24 MCE::Subs(3)
mce 1.843.0 - Generated Tue Aug 6 13:34:07 CDT 2019