NAME

Statistics::R::REXP::List - an R generic vector (list)

VERSION

version 1.0002

SYNOPSIS

    use Statistics::R::REXP::List
    
    my $vec = Statistics::R::REXP::List->new([
        1, '', 'foo', ['x', 22]
    ]);
    print $vec->elements;

DESCRIPTION

An object of this class represents an R list, also called a generic vector (VECSXP). List elements can themselves be lists, and so can form a tree structure.

METHODS

Statistics::R::REXP:List inherits from Statistics::R::REXP::Vector, with no added restrictions on the value of its elements. Missing values (NA in R) have value undef.

sexptype

SEXPTYPE of generic vectors is VECSXP.

to_pl

Perl value of the list is an array reference to the Perl values of its elements, but using a scalar value to represent elements that are atomic vectors of length 1, rather than a one-element array reference.

The idea is that in R, 1:3, and list(1, 2, 3) can often be used interchangeably, even though the list is really composed of three integer vectors, each of length one. Now, both will have native Perl representation of [1, 2, 3].

This only applies to elements that are atomic vectors. An element of type list will always be represented as an array reference:

list(list(1), list(2), list(3))->to_pl -> [ [ 1 ], [ 2 ], [ 3 ] ]

BUGS AND LIMITATIONS

Classes in the REXP hierarchy 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