vec_data: Extract underlying data

View source: R/proxy.R

vec_dataR Documentation

Extract underlying data

Description

[Experimental]

Extract the data underlying an S3 vector object, i.e. the underlying (named) atomic vector, data frame, or list.

Usage

vec_data(x)

Arguments

x

A vector or object implementing vec_proxy().

Value

The data underlying x, free from any attributes except the names.

Difference with vec_proxy()

  • vec_data() returns unstructured data. The only attributes preserved are names, dims, and dimnames.

    Currently, due to the underlying memory architecture of R, this creates a full copy of the data for atomic vectors.

  • vec_proxy() may return structured data. This generic is the main customisation point for accessing memory values in vctrs, along with vec_restore().

    Methods must return a vector type. Records and data frames will be processed rowwise.


vctrs documentation built on May 29, 2024, 11:39 a.m.