Seamless R and C++ Integration
The 'Rcpp' package provides R functions as well as C++ classes which
offer a seamless integration of R and C++. Many R data types and objects can be
mapped back and forth to C++ equivalents which facilitates both writing of new
code as well as easier integration of third-party libraries. Documentation
about 'Rcpp' is provided by several vignettes included in this package, via the
'Rcpp Gallery' site at <http://gallery.rcpp.org>, the paper by Eddelbuettel and
Francois (2011, <doi:10.18637/jss.v040.i08>), the book by Eddelbuettel (2013,
<doi:10.1007/978-1-4614-6868-4>) and the paper by Eddelbuettel and Balamuta (2017,
<doi:10.7287/peerj.preprints.3188v1>); see 'citation("Rcpp")' for details.
Seamless R and C++ Integration
The Rcpp package provides R functions and a C++ library facilitating the integration of R and C++.
R data types (
SEXP) are matched to C++ objects in a class hierarchy. All R
types are supported (vectors, functions, environment, etc ...) and each
type is mapped to a dedicated class. For example, numeric vectors are
represented as instances of the Rcpp::NumericVector class, environments are
represented as instances of Rcpp::Environment, functions are represented as
Rcpp::Function, etc ...
vignette (also published as a JSS paper) provides a good
entry point to Rcpp as do the Rcpp website, the
Rcpp page and the
Rcpp Gallery. Full documentation
is provided by the Rcpp book.
Conversion from C++ to R and back is driven by the templates
Rcpp::as which are highly flexible and extensible, as documented
in the Rcpp-extending vignette.
Rcpp also provides Rcpp modules, a framework that allows exposing C++ functions and classes to the R level. The Rcpp-modules vignette details the current set of features of Rcpp-modules.
Rcpp includes a concept called Rcpp sugar that brings many R functions into C++. Sugar takes advantage of lazy evaluation and expression templates to achieve great performance while exposing a syntax that is much nicer to use than the equivalent low-level loop code. The Rcpp-sugar gives an overview of the feature.
Rcpp attributes provide a high-level syntax for declaring C++ functions as callable from R and automatically generating the code required to invoke them. Attributes are intended to facilitate both interactive use of C++ within R sessions as well as to support R package development. Attributes are built on top of Rcpp modules and their implementation is based on previous work in the inline package. See the Rcpp-atttributes vignettes for more details.
The package ships with nine pdf vignettes.
Additional documentation is available via the JSS paper by Eddelbuettel and Francois (2011, JSS) paper (corresponding to the 'intro' vignette) and the book by Eddelbuettel (2013, Springer); see 'citation("Rcpp")' for details.
The Rcpp Gallery showcases over one hundred fully documented and working examples.
A number of examples are included as are 1394 unit tests in 606 unit test functions provide additional usage examples.
An earlier version of Rcpp, containing what we now call the 'classic Rcpp API' was written during 2005 and 2006 by Dominick Samperi. This code has been factored out of Rcpp into the package RcppClassic, and it is still available for code relying on the older interface. New development should always use this Rcpp package instead.
Other usage examples are provided by packages using Rcpp. As of March 2018, there are 1309 CRAN packages using Rcpp, a further 91 BioConductor packages in its current release as well as an unknown number of GitHub, Bitbucket, R-Forge, ... repositories using Rcpp. All these packages provide usage examples for Rcpp.
Released and tested versions of Rcpp are available via the CRAN network, and can be installed from within R via
To install from source, ensure you have a complete package development environment for R as discussed in the relevant documentation; also see questions 1.2 and 1.3 in the Rcpp-FAQ.
The best place for questions is the Rcpp-devel mailing list hosted at R-forge. Note that in order to keep spam down, you must be a subscriber in order to post. One can also consult the list archives to see if your question has been asked before.
Another option is to use
StackOverflow and its 'rcpp' tag.
Search functionality (use
rcpp in squared brackets as in
[rcpp] my question terms
to tag the query) is very valuable as many questions have indeed been asked, and
The issue tickets at the GitHub repo are the primary bug reporting interface. As with the other web resources, previous issues can be searched as well.
Dirk Eddelbuettel, Romain Francois, JJ Allaire, Kevin Ushey, Qiang Kou, Nathan Russell, Doug Bates, and John Chambers
GPL (>= 2)
Functions in Rcpp
|LdFlags||(Deprecated) Rcpp Linker Flags|
|RcppUnitTests||Rcpp : unit tests results|
|formals<--methods||Set the formal arguments of a C++ function|
|Module||Retrieves an Rcpp module|
|Rcpp-deprecated||Deprecated Functions in the Rcpp Package|
|compileAttributes||Compile Rcpp Attributes for a Package|
|compilerCheck||Check for Minimal (g++) Compiler Version|
|C++Object-class||c++ internal objects|
|exposeClass||Create an Rcpp Module to Expose a C++ Class in R|
|Rcpp-internal||Rcpp internal functions|
|Rcpp-package||R / C++ interface|
|loadModule||Load an Rcpp Module into a Package|
|loadRcppModules-deprecated||Loads Rcpp modules on package startup|
|C++Class-class||Reflection information for an internal c++ class|
|Rcpp.package.skeleton||Create a skeleton for a new package depending on Rcpp|
|Rcpp.plugin.maker||Facilitating making package plugins|
|populate||Populates a namespace or an environment with the content of a module|
|cppFunction||Define an R Function with a C++ Implementation|
|demangle||c++ type information|
|registerPlugin||Register an inline plugin|
|evalCpp||Evaluate a C++ Expression|
|setRcppClass||Create a Class Extending a C++ Class|
|sourceCpp||Source C++ Code from a File or String|
Vignettes of Rcpp
Last month downloads
|URL||http://www.rcpp.org, http://dirk.eddelbuettel.com/code/rcpp.html, https://github.com/RcppCore/Rcpp|
|License||GPL (>= 2)|
|MailingList||Please send questions and comments regarding Rcpp to firstname.lastname@example.org|
|Packaged||2018-03-08 17:04:51.131351 UTC; edd|
|Date/Publication||2018-03-13 22:46:12 UTC|
Include our badge in your README