GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MCE::SUBS (3)

.ds Aq ’

NAME

MCE::Subs - Exports functions mapped directly to MCE methods

CONTENTS

VERSION

This document describes MCE::Subs version 1.703

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_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, MCE::Core

AUTHOR

Mario E. Roy, <marioeroy AT gmail DOT com>
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MCE::SUBS (3) 2016-03-20

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.