# phpman > man > TAP::Parser::Multiplexer

## NAME
    [TAP::Parser::Multiplexer](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParser%3A%3AMultiplexer/markdown) - Multiplex multiple [TAP::Parsers](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParsers/markdown)

## VERSION
    Version 3.43

## SYNOPSIS
        use [TAP::Parser::Multiplexer](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParser%3A%3AMultiplexer/markdown);

        my $mux = [TAP::Parser::Multiplexer](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParser%3A%3AMultiplexer/markdown)->new;
        $mux->add( $parser1, $stash1 );
        $mux->add( $parser2, $stash2 );
        while ( my ( $parser, $stash, $result ) = $mux->next ) {
            # do stuff
        }

## DESCRIPTION
    "[TAP::Parser::Multiplexer](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParser%3A%3AMultiplexer/markdown)" gathers input from multiple [TAP::Parsers](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParsers/markdown). 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](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AHarness/markdown) for an example of its use.

## METHODS
### Class Methods
   "new"
        my $mux = [TAP::Parser::Multiplexer](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParser%3A%3AMultiplexer/markdown)->new;

    Returns a new "[TAP::Parser::Multiplexer](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParser%3A%3AMultiplexer/markdown)" object.

### Instance Methods
   "add"
      $mux->add( $parser, $stash );

    Add a [TAP::Parser](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParser/markdown) 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](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AParser/markdown)

    [TAP::Harness](https://www.chedong.com/phpMan.php/perldoc/TAP%3A%3AHarness/markdown)