Capture::Tiny 0.08

Capture::Tiny provides a simple, portable way to capture anything sent to STDOUT or STDERR, regardless of whether it comes from Perl, from XS code or from an external program. Optionally, output can be teed so that it is captured while being passed through to the original handles. Yes, it even works on Windows. Stop guessing which of a dozen capturing modules to use in any particular situation and just use this one.<br /><br />This module was heavily inspired by IO::CaptureOutput, which provides similar functionality without the ability to tee output and with more complicated code and API.<br />USAGE ^<br /><br />The following functions are available. None are exported by default.<br />capture<br /><br /> ($stdout, $stderr) = capture &code;<br /> $stdout = capture &code;<br /><br />The capture function takes a code reference and returns what is sent to STDOUT and STDERR. In scalar context, it returns only STDOUT. If no output was received, returns an empty string. Regardless of context, all output is captured -- nothing is passed to the existing handles.<br /><br />It is prototyped to take a subroutine reference as an argument. Thus, it can be called in block form:<br /><br /> ($stdout, $stderr) = capture {<br /> # your code here ...<br /> };<br /><br />capture_merged<br /><br /> $merged = capture_merged &code;<br /><br />The capture_merged function works just like capture except STDOUT and STDERR are merged. (Technically, STDERR is redirected to STDOUT before executing the function.) If no output was received, returns an empty string. As with capture it may be called in block form.<br /><br />Caution: STDOUT and STDERR output in the merged result are not guaranteed to be properly ordered due to buffering.<br />tee<br /><br /> ($stdout, $stderr) = tee &code;<br /> $stdout = tee &code;<br /><br />The tee function works just like capture, except that output is captured as well as passed on to the original STDOUT and STDERR. As with capture it may be called in block form.<br />tee_merged<br /><br /> $merged = tee_merged &code;<br /><br />The tee_merged function works just like capture_merged except that output is captured as well as passed on to STDOUT. As with capture it may be called in block form.<br /><br />Caution: STDOUT and STDERR output in the merged result are not guaranteed to be properly ordered due to buffering.

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Block,  Called,  Capture,  Capture Merged,  Captured,  Codethe,  Function,  Merged,  Ordered,  Output,  Passed,  Returns,  Stderr,  Stdout,  String,  Tee Merged,  Works
Users rating:	0/10