SelectSaver (3)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/SelectSaver.3perl".)

NAME

SelectSaver - save and restore selected file handle

SYNOPSIS

    use SelectSaver;

    {
       my $saver = SelectSaver->new(FILEHANDLE);
       # FILEHANDLE is selected
    }
    # previous handle is selected

    {
       my $saver = SelectSaver->new;
       # new handle may be selected, or not
    }
    # previous handle is selected

DESCRIPTION

A "SelectSaver" object contains a reference to the file handle that was selected when it was created. If its "new" method gets an extra parameter, then that parameter is selected; otherwise, the selected file handle remains unchanged.

When a "SelectSaver" is destroyed, it re-selects the file handle that was selected when it was created.