lib/SelectSaver.pm

   1 package SelectSaver;
   2
   3 our $VERSION = '1.03';
   4
   5 =head1 NAME
   6
   7 SelectSaver - save and restore selected file handle
   8
   9 =head1 SYNOPSIS
  10
  11     use SelectSaver;
  12
  13     {
  14        my $saver = SelectSaver->new(FILEHANDLE);
  15        # FILEHANDLE is selected
  16     }
  17     # previous handle is selected
  18
  19     {
  20        my $saver = SelectSaver->new;
  21        # new handle may be selected, or not
  22     }
  23     # previous handle is selected
  24
  25 =head1 DESCRIPTION
  26
  27 A C<SelectSaver> object contains a reference to the file handle that
  28 was selected when it was created.  If its C<new> method gets an extra
  29 parameter, then that parameter is selected; otherwise, the selected
  30 file handle remains unchanged.
  31
  32 When a C<SelectSaver> is destroyed, it re-selects the file handle
  33 that was selected when it was created.
  34
  35 =cut
  36
  37 require 5.000;
  38 use Symbol q{qualify};
  39
  40 sub new {
  41     @_ >= 1 && @_ <= 2 or do { require Carp; Carp::croak('usage: SelectSaver->new( [FILEHANDLE] )') };
  42     my $fh = select;
  43     my $self = bless \$fh, $_[0];
  44     select qualify($_[1], caller) if @_ > 1;
  45     $self;
  46 }
  47
  48 sub DESTROY {
  49     my $self = $_[0];
  50     select $$self;
  51 }
  52
  53 1;