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