Perl 5 version documentation

SelectSaver

NAME

SelectSaver - save and restore selected file handle

SYNOPSIS

  1.     use SelectSaver;
  3.     {
  4.        my $saver = SelectSaver->new(FILEHANDLE);
  5.        # FILEHANDLE is selected
  6.     }
  7.     # previous handle is selected
  9.     {
  10.        my $saver = SelectSaver->new;
  11.        # new handle may be selected, or not
  12.     }
  13.     # 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.