allocVector: Allocates a Vector

In HenrikBengtsson/RNativeAPI: R Native API - Documentation and Examples

Allocates a Vector

Description

Allocates a Vector

Usage

allocVector(type, length)

Arguments

type	(SEXPTYPE) An macro constant of length one.
length	(R_xlen_t) An non-negative integer.

Value

allocVector() returns an SEXP object of type SEXPTYPE type.

C API

#include <Rinternals.h>
SEXP     Rf_allocVector(SEXPTYPE, R_xlen_t)
#define allocVector		Rf_allocVector

Related macros:

#include <Rdefines.h>
#define NEW_LOGICAL(n)		Rf_allocVector(LGLSXP,n)
#define NEW_INTEGER(n)		Rf_allocVector(INTSXP,n)
#define NEW_NUMERIC(n)		Rf_allocVector(REALSXP,n)
#define NEW_CHARACTER(n)	Rf_allocVector(STRSXP,n)
#define NEW_COMPLEX(n)		Rf_allocVector(CPLXSXP,n)
#define NEW_LIST(n)		Rf_allocVector(VECSXP,n)
#define NEW_STRING(n)		NEW_CHARACTER(n)
#define NEW_RAW(n)		Rf_allocVector(RAWSXP,n)

R API

library(base)

x_logical   <- logical(length = n)
x_integer   <- integer(length = n)
x_numeric   <- numeric(length = n)
x_character <- character(length = n)
x_complex   <- complex(length.out = n)
x_list      <- vector(mode = "list", length = n)
x_raw       <- raw(length = n)

Source

Declaration: src/include/Rinternals.h and src/include/Rdefines.h

Implementation: ⁠allocVector(SEXPTYPE type, R_xlen_t length)⁠ is a simple inline wrapper functions that calls allocVector3(type, length, NULL), cf. src/include/Rinlinedfuns.h

HenrikBengtsson/RNativeAPI documentation built on April 10, 2023, 6:22 p.m.