IO::MultiPipe - Allows for error checking on a command involving multiple pipes.

Version 0.0.0

Normally if a part of a pipe fails, depending on the location, it won't be detected. This breaks down a command involving pipes and runs each command seperately.

It uses open3 to run each chunk of the pipe.

    use IO::MultiPipe;

    my $pipes = IO::MultiPipe->new();

    #This sets the pipe that will be run.
    $pipes->set('sed s/-// | sed s/123/abc/ | sed s/ABC/abc/');
    if ($pipes->{error}){
        print "Error!\n";
    }

    #'123-ABCxyz' through the command set above.
    my $returned=$pipes->run('123-ABCxyz');

Initializes the object.

This runs the data through the pipe.

Sets the command that will be used.

    $pipes->set('sed s/-// | sed s/123/abc/ | sed s/ABC/abc/');
    if ($pipes->{error}){
        print "Error!\n";
    }

This blanks the error storage and is only meant for internal usage.

It does the following.

    $self->{error}=undef;
    $self->{errorString}="";

This is contained in '$pipe->{error}'. Any time this is true, there is an error.

No command passed to the set function.

Command contains null section.

No command has been set yet. The 'set' needs called first before calling 'run'.

Opening the command failed.

The command errored.

Zane C. Bowers, <vvelox at vvelox.net>

Please report any bugs or feature requests to bug-io-multipipe at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IO-MultiPipe. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

You can find documentation for this module with the perldoc command.

    perldoc IO::MultiPipe

You can also look for information at:

* RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=IO-MultiPipe

* AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/IO-MultiPipe

* CPAN Ratings

http://cpanratings.perl.org/d/IO-MultiPipe

* Search CPAN

http://search.cpan.org/dist/IO-MultiPipe

Copyright 2008 Zane C. Bowers, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.