Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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.829

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, <marioeroyA ATA gmailA DOTA com>

perl v5.24.1			  2017-05-03			  MCE::Subs(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | FUNCTIONS for the MANAGER PROCESS via ( :manager ) | FUNCTIONS for MCE WORKERS via ( :worker ) | GETTERS for MCE ATTRIBUTES via ( :getter ) | INDEX | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=MCE::Subs&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help