NAME

StringHandle - intercept text sent to stdout or stderr

SYNOPSIS

 $text1 = "This should go to STDOUT\n";
 $text2 = "This is the second line\n";

 $sh = TaskForest::StringHandle->start(*STDOUT);
                          # stdout is being captured as a string
 print $text1;            # nothing is printed to stdout
 $stdout1 = $sh->read();  # $stdout1 eq $text1
 $stdout2 = $sh->read();  # $stdout2 eq ''
 print $text2;            # nothing is printed now either
 $stdout3 = $sh->stop();  # $stdout3 eq $text2, capture stopped
 print "Hello, world!\n"; # this is printed to stdout

DESCRIPTION

This is a simple class that you can use to intercept any text that would have been written to stdout or stderr or any file handle and saves it instead locally. You can then retrieve the text and use it to examine what would have been sent to stdout (or stderr). It was developed primarily to help with the test cases.