NAME

       Statistics::R::IO::Base - Common object methods for processing R files

VERSION

       version 1.0002

SYNOPSIS

           use Statistics::R::IO::Base;

           # $f is an instance of Base
           $f->does('Statistics::R::IO::Base');
           my $var = $rds->read;
           $f->close;

DESCRIPTION

       An object of this class represents a handle to an R-related file. This class cannot be
       directly instantiated (it will die if you call "new" on it), because it is intended as a
       base abstract class with concrete subclasses to parse specific types of files, such as RDS
       or RData.

METHODS

   CONSTRUCTOR
       new $filename
           The single-argument constructor can be invoked with a scalar containing the name of
           the R file. This file will be immediately opened for reading using IO::File. The
           method will raise an exception if the file is not readable.

       new ATTRIBUTE_HASH_OR_HASH_REF
           The constructor's arguments can also be given as a hash or hash reference, specifying
           values of the object attributes (in this case, 'fh', for which any subclass of
           IO::Handle can be used).

   ACCESSORS
       fh  A file handle (stored as a reference to the IO::Handle) to the data being parsed.

   METHODS
       read
           Reads the contents of the filehandle and returns a Statistics::R::REXP.

       close
           Closes the object's filehandle. This method is automatically invoked when the object
           is destroyed.

BUGS AND LIMITATIONS

       Instances of this class are intended to be immutable. Please do not try to change their
       value or attributes.

       There are no known bugs in this module. Please see Statistics::R::IO for bug reporting.

SUPPORT

       See Statistics::R::IO for support and contact information.

AUTHOR

       Davor Cubranic <cubranic@stat.ubc.ca>

COPYRIGHT AND LICENSE

       This software is Copyright (c) 2017 by University of British Columbia.

       This is free software, licensed under:

         The GNU General Public License, Version 3, June 2007