Unix/Linux Go Back    


CentOS 7.0 - man page for tap::parser::multiplexer (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


TAP::Parser::Multiplexer(3)    User Contributed Perl Documentation    TAP::Parser::Multiplexer(3)

NAME
       TAP::Parser::Multiplexer - Multiplex multiple TAP::Parsers

VERSION
       Version 3.28

SYNOPSIS
	   use TAP::Parser::Multiplexer;

	   my $mux = TAP::Parser::Multiplexer->new;
	   $mux->add( $parser1, $stash1 );
	   $mux->add( $parser2, $stash2 );
	   while ( my ( $parser, $stash, $result ) = $mux->next ) {
	       # do stuff
	   }

DESCRIPTION
       "TAP::Parser::Multiplexer" gathers input from multiple TAP::Parsers.  Internally it calls
       select on the input file handles for those parsers to wait for one or more of them to have
       input available.

       See TAP::Harness for an example of its use.

METHODS
   Class Methods
       "new"

	   my $mux = TAP::Parser::Multiplexer->new;

       Returns a new "TAP::Parser::Multiplexer" object.

   Instance Methods
       "add"

	 $mux->add( $parser, $stash );

       Add a TAP::Parser to the multiplexer. $stash is an optional opaque reference that will be
       returned from "next" along with the parser and the next result.

       "parsers"

	 my $count   = $mux->parsers;

       Returns the number of parsers. Parsers are removed from the multiplexer when their input
       is exhausted.

       "next"

       Return a result from the next available parser. Returns a list containing the parser from
       which the result came, the stash that corresponds with that parser and the result.

	   my ( $parser, $stash, $result ) = $mux->next;

       If $result is undefined the corresponding parser has reached the end of its input (and
       will automatically be removed from the multiplexer).

       When all parsers are exhausted an empty list will be returned.

	   if ( my ( $parser, $stash, $result ) = $mux->next ) {
	       if ( ! defined $result ) {
		   # End of this parser
	       }
	       else {
		   # Process result
	       }
	   }
	   else {
	       # All parsers finished
	   }

See Also
       TAP::Parser

       TAP::Harness

perl v5.16.3				    2013-05-02		      TAP::Parser::Multiplexer(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 03:39 PM.